001// Copyright 2007, 2008, 2009, 2010 The Apache Software Foundation
002//
003// Licensed under the Apache License, Version 2.0 (the "License");
004// you may not use this file except in compliance with the License.
005// You may obtain a copy of the License at
006//
007// http://www.apache.org/licenses/LICENSE-2.0
008//
009// Unless required by applicable law or agreed to in writing, software
010// distributed under the License is distributed on an "AS IS" BASIS,
011// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
012// See the License for the specific language governing permissions and
013// limitations under the License.
014
015package org.apache.tapestry5.beaneditor;
016
017import static java.lang.annotation.RetentionPolicy.RUNTIME;
018import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.BEAN;
019import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.COMPONENT;
020import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.MIXIN;
021import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.PAGE;
022
023import java.lang.annotation.Documented;
024import java.lang.annotation.ElementType;
025import java.lang.annotation.Retention;
026import java.lang.annotation.Target;
027
028import org.apache.tapestry5.ioc.annotations.UseWith;
029
030/**
031 * Used to attach validation constraints directly to a property (either the getter or the setter method). The annotation
032 * value is a comma separated list of <em>validation constraints</em>, each one identifying a validator type (such as
033 * "required", "minlength") and optionally, a constraint value. Most validators need a constraint value, which is
034 * separated from the type by an equals size (i.e., "maxlength=30"). In addition, the value may include
035 * validator macros.
036 * <p/>
037 * May be placed on any getter or setter method, or on the matching field.
038 * 
039 * @see Translate
040 */
041@Target(
042{ ElementType.FIELD, ElementType.METHOD })
043@Retention(RUNTIME)
044@Documented
045@UseWith(
046{ BEAN, COMPONENT, MIXIN, PAGE })
047public @interface Validate
048{
049    String value();
050}