org.hibernate.validator.ap.internal

Class ConstraintAnnotationVisitor

java.lang.Object

javax.lang.model.util.AbstractElementVisitor6<R,P>

javax.lang.model.util.SimpleElementVisitor6<R,P>

javax.lang.model.util.ElementKindVisitor6<R,P>

javax.lang.model.util.ElementKindVisitor7<R,P>

javax.lang.model.util.ElementKindVisitor8<T,V>

org.hibernate.validator.ap.internal.AbstractElementVisitor<java.lang.Void,java.util.List<javax.lang.model.element.AnnotationMirror>>

org.hibernate.validator.ap.internal.ConstraintAnnotationVisitor

All Implemented Interfaces:

javax.lang.model.element.ElementVisitor<java.lang.Void,java.util.List<javax.lang.model.element.AnnotationMirror>>

public final class ConstraintAnnotationVisitor
extends AbstractElementVisitor<java.lang.Void,java.util.List<javax.lang.model.element.AnnotationMirror>>

An ElementVisitor that visits annotated elements (type declarations, methods and fields) and applies different ConstraintChecks to them. Each ConstraintCheckIssue occurred will be reported using the Messager API.

Author:

Gunnar Morling

Field Summary

Fields inherited from class org.hibernate.validator.ap.internal.AbstractElementVisitor

messager, verbose

Fields inherited from class javax.lang.model.util.SimpleElementVisitor6

DEFAULT_VALUE

Constructor Summary

Constructors

Constructor and Description
ConstraintAnnotationVisitor(javax.annotation.processing.ProcessingEnvironment processingEnvironment, MessagerAdapter messager, Configuration configuration)

Method Summary

Modifier and Type	Method and Description
java.lang.Void	visitExecutableAsMethod(javax.lang.model.element.ExecutableElement method, java.util.List<javax.lang.model.element.AnnotationMirror> mirrors) Checks whether the given annotations are correctly specified at the given method.
java.lang.Void	visitTypeAsAnnotationType(javax.lang.model.element.TypeElement annotationType, java.util.List<javax.lang.model.element.AnnotationMirror> mirrors) Checks whether the given annotations are correctly specified at the given annotation type declaration.
java.lang.Void	visitTypeAsClass(javax.lang.model.element.TypeElement e, java.util.List<javax.lang.model.element.AnnotationMirror> p) Checks whether the given annotations are correctly specified at the given class type declaration.
java.lang.Void	visitTypeAsEnum(javax.lang.model.element.TypeElement e, java.util.List<javax.lang.model.element.AnnotationMirror> p) Checks whether the given annotations are correctly specified at the given enum type declaration.
java.lang.Void	visitTypeAsInterface(javax.lang.model.element.TypeElement e, java.util.List<javax.lang.model.element.AnnotationMirror> p) Checks whether the given annotations are correctly specified at the given interface type declaration.
java.lang.Void	visitVariableAsField(javax.lang.model.element.VariableElement annotatedField, java.util.List<javax.lang.model.element.AnnotationMirror> mirrors) Checks whether the given annotations are correctly specified at the given field.
java.lang.Void	visitVariableAsParameter(javax.lang.model.element.VariableElement annotatedField, java.util.List<javax.lang.model.element.AnnotationMirror> mirrors) Checks whether the given annotations are correctly specified at the given method parameter.

Methods inherited from class org.hibernate.validator.ap.internal.AbstractElementVisitor

reportIssues

Methods inherited from class javax.lang.model.util.ElementKindVisitor7

visitVariableAsResourceVariable

Methods inherited from class javax.lang.model.util.ElementKindVisitor6

visitExecutable, visitExecutableAsConstructor, visitExecutableAsInstanceInit, visitExecutableAsStaticInit, visitPackage, visitType, visitTypeParameter, visitVariable, visitVariableAsEnumConstant, visitVariableAsExceptionParameter, visitVariableAsLocalVariable

Methods inherited from class javax.lang.model.util.SimpleElementVisitor6

defaultAction

Methods inherited from class javax.lang.model.util.AbstractElementVisitor6

visit, visit, visitUnknown

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ConstraintAnnotationVisitor

public ConstraintAnnotationVisitor(javax.annotation.processing.ProcessingEnvironment processingEnvironment,
                                   MessagerAdapter messager,
                                   Configuration configuration)

Method Detail

visitExecutableAsMethod

public java.lang.Void visitExecutableAsMethod(javax.lang.model.element.ExecutableElement method,
                                              java.util.List<javax.lang.model.element.AnnotationMirror> mirrors)

Checks whether the given annotations are correctly specified at the given method. The following checks are performed:

• Constraint annotations may only be given at non-static, JavaBeans getter methods which's return type is supported by the constraints.
• The @Valid annotation may only be given at non-static, non-primitive JavaBeans getter methods.

Overrides:

visitExecutableAsMethod in class javax.lang.model.util.ElementKindVisitor6<java.lang.Void,java.util.List<javax.lang.model.element.AnnotationMirror>>

visitVariableAsField

public java.lang.Void visitVariableAsField(javax.lang.model.element.VariableElement annotatedField,
                                           java.util.List<javax.lang.model.element.AnnotationMirror> mirrors)

Checks whether the given annotations are correctly specified at the given field. The following checks are performed:

• Constraint annotations may only be given at non-static fields which's type is supported by the constraints.
• The @Valid annotation may only be given at non-static, non-primitive fields.

Overrides:

visitVariableAsField in class javax.lang.model.util.ElementKindVisitor6<java.lang.Void,java.util.List<javax.lang.model.element.AnnotationMirror>>

visitVariableAsParameter

public java.lang.Void visitVariableAsParameter(javax.lang.model.element.VariableElement annotatedField,
                                               java.util.List<javax.lang.model.element.AnnotationMirror> mirrors)

Checks whether the given annotations are correctly specified at the given method parameter. The following checks are performed:

• Constraint annotation parameter values are meaningful and valid.

Overrides:

visitVariableAsParameter in class javax.lang.model.util.ElementKindVisitor6<java.lang.Void,java.util.List<javax.lang.model.element.AnnotationMirror>>

visitTypeAsAnnotationType

public java.lang.Void visitTypeAsAnnotationType(javax.lang.model.element.TypeElement annotationType,
                                                java.util.List<javax.lang.model.element.AnnotationMirror> mirrors)

Checks whether the given annotations are correctly specified at the given annotation type declaration. The following checks are performed:

• The only annotation types allowed to be annotated with other constraint annotations are composed constraint annotation type declarations.

Overrides:

visitTypeAsAnnotationType in class javax.lang.model.util.ElementKindVisitor6<java.lang.Void,java.util.List<javax.lang.model.element.AnnotationMirror>>

visitTypeAsClass

public java.lang.Void visitTypeAsClass(javax.lang.model.element.TypeElement e,
                                       java.util.List<javax.lang.model.element.AnnotationMirror> p)

Checks whether the given annotations are correctly specified at the given class type declaration. The following checks are performed:

• Constraint annotations may at types supported by the constraints.

Overrides:

visitTypeAsClass in class javax.lang.model.util.ElementKindVisitor6<java.lang.Void,java.util.List<javax.lang.model.element.AnnotationMirror>>

visitTypeAsEnum

public java.lang.Void visitTypeAsEnum(javax.lang.model.element.TypeElement e,
                                      java.util.List<javax.lang.model.element.AnnotationMirror> p)

Checks whether the given annotations are correctly specified at the given enum type declaration. The following checks are performed:

• Constraint annotations may at types supported by the constraints.

Overrides:

visitTypeAsEnum in class javax.lang.model.util.ElementKindVisitor6<java.lang.Void,java.util.List<javax.lang.model.element.AnnotationMirror>>

visitTypeAsInterface

public java.lang.Void visitTypeAsInterface(javax.lang.model.element.TypeElement e,
                                           java.util.List<javax.lang.model.element.AnnotationMirror> p)

Checks whether the given annotations are correctly specified at the given interface type declaration. The following checks are performed:

• Constraint annotations may at types supported by the constraints.

Overrides:

visitTypeAsInterface in class javax.lang.model.util.ElementKindVisitor6<java.lang.Void,java.util.List<javax.lang.model.element.AnnotationMirror>>