元注解——java.lang.annotation.Target(1.8)

2023-06-20,,

参考资料: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

元注解——java.lang.annotation.Target(1.8)的相关教程结束。

《元注解——java.lang.annotation.Target(1.8).doc》

下载本文的Word格式文档,以方便收藏与打印。