Target
public abstract @interface Target
implements Annotation
java.lang.annotation.Target |
Indicates the contexts in which an annotation interface is applicable. The declaration contexts and type contexts in which an annotation interface may be applicable are specified in JLS {@jls 9.6.4.1}, and denoted in source code by enum constants of java.lang.annotation.ElementType
.
If an @Target
meta-annotation is not present on an annotation interface T
, then an annotation of type T
may be written as a modifier for any declaration.
If an @Target
meta-annotation is present, the compiler will enforce the usage restrictions indicated by ElementType
enum constants, in line with JLS {@jls 9.7.4}.
For example, this @Target
meta-annotation indicates that the declared interface is itself a meta-annotation interface. It can only be used on annotation interface declarations:
@Target(ElementType.ANNOTATION_TYPE) public @interface MetaAnnotationType { ... }
This @Target
meta-annotation indicates that the declared class or interface is intended solely for use as a member class or interface in complex annotation interface declarations. It cannot be used to annotate anything directly:
@Target({}) public @interface MemberInterface { ... }
It is a compile-time error for a single ElementType
constant to appear more than once in an @Target
annotation. For example, the following @Target
meta-annotation is illegal:
@Target({ElementType.FIELD, ElementType.METHOD, ElementType.FIELD}) public @interface Bogus { ... }
Summary
Public methods | |
---|---|
ElementType[] | value() Returns an array of the kinds of elements an annotation interface can be applied to. |
Inherited methods | |
---|---|
Public methods
value
public ElementType[] value ()
Returns an array of the kinds of elements an annotation interface can be applied to.
Returns | |
---|---|
ElementType[] | an array of the kinds of elements an annotation interface can be applied to |