参考资料:https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Target.html
普通注解’只能用来注解’代码’,而’元注解’只能用来注解 ‘普通注解’。
@Target:限制注解的元素种类。
不加元注解@Target的情况下,注解可以修饰各种元素,比如可以修饰类,可以修饰变量,可以修饰方法等,但是如果要限制注解的元素种类,则需要加入@Target。
源码:
package java.lang.annotation; /**
* Indicates the contexts in which an annotation type is applicable. The
* declaration contexts and type contexts in which an annotation type may be
* applicable are specified in JLS 9.6.4.1, and denoted in source code by enum
* constants of {@link ElementType java.lang.annotation.ElementType}.
*
* <p>If an {@code @Target} meta-annotation is not present on an annotation type
* {@code T} , then an annotation of type {@code T} may be written as a
* modifier for any declaration except a type parameter declaration.
*
* <p>If an {@code @Target} meta-annotation is present, the compiler will enforce
* the usage restrictions indicated by {@code ElementType}
* enum constants, in line with JLS 9.7.4.
*
* <p>For example, this {@code @Target} meta-annotation indicates that the
* declared type is itself a meta-annotation type. It can only be used on
* annotation type declarations:
* <pre>
* @Target(ElementType.ANNOTATION_TYPE)
* public @interface MetaAnnotationType {
* ...
* }
* </pre>
*
* <p>This {@code @Target} meta-annotation indicates that the declared type is
* intended solely for use as a member type in complex annotation type
* declarations. It cannot be used to annotate anything directly:
* <pre>
* @Target({})
* public @interface MemberType {
* ...
* }
* </pre>
*
* <p>It is a compile-time error for a single {@code ElementType} constant to
* appear more than once in an {@code @Target} annotation. For example, the
* following {@code @Target} meta-annotation is illegal:
* <pre>
* @Target({ElementType.FIELD, ElementType.METHOD, ElementType.FIELD})
* public @interface Bogus {
* ...
* }
* </pre>
*
* @since 1.5
* @jls 9.6.4.1 @Target
* @jls 9.7.4 Where Annotations May Appear
*/
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Target {
/**
* Returns an array of the kinds of elements an annotation type
* can be applied to.
* @return an array of the kinds of elements an annotation type
* can be applied to
*/
ElementType[] value();
}
指定注释类型适用的上下文。即:用于设定注解的使用范围(被描述的注解可以用在什么地方)。
在JLS 9.6.4.1中规定了注解类型可能适用的声明上下文和类型上下文,并且在源码中用java.lang.annotation.ElementType
的枚举常量表示。即:Target用ElementType来指定注解可使用范围的枚举集合。
如果注解类型T中不存在@Target元注释,则声明的注解类型T可被用于除了类型参数声明之外的任何声明的修饰符。即,如果注释类型声明中不存在 Target 元注释,则声明的类型可以用在任一程序元素上 。
如果存在@Target元注释,则编译器将强制执行由ElementType枚举常量指定的使用限制。
例如:这个@Target元注释表明声明的类型本身就是一个元注释类型。它只能用于注解类型声明:
@Target(ElementType.ANNOTATION_TYPE)
public @interface MetaAnnotationType {
...
}
这个@Target元注释表明,声明的类型仅用作复杂注释类型声明中的成员类型。它不能用来直接注解任何东西。
@Target({})
public @interface MemberType {
...
}
单个ElementType常量在@Target注释中出现多次是编译时错误,例如,下面的元注释是非法的:
@Target({ElementType.FIELD, ElementType.METHOD, ElementType.FIELD})
public @interface Bogus {
...
}
ElementType[]:
返回注释类型可用的各种元素数组。
取值有:
TYPE:类、接口(包括注解类型) 或enum声明。
FIELD:字段声明(包括enum常量).
METHOD:方法声明。
PARAMTER:形式参数声明。
CONSTRUCTOR:构造函数声明。
LOCAL_VARIABLE:局部变量声明。
ANNOTATION_TYPE:注解类型声明。
PACKAGE:包声明
TYPE_PARAMETER:参数类型声明
TYPE_USE:使用一个类型,详见:java.lang.annotation.ElementType