@Target注解标记另外的注解用于限制此注解可以应用哪种Java元素类型。
先看Java SE 8中@Target是如何声明的:
package java.lang.annotation;
public enum ElementType {
/** Class, interface (including annotation type), or enum declaration */
TYPE,
/\*\* Field declaration (includes enum constants) \*/
FIELD,
/\*\* Method declaration \*/
METHOD,
/\*\* Formal parameter declaration \*/
PARAMETER,
/\*\* Constructor declaration \*/
CONSTRUCTOR,
/\*\* Local variable declaration \*/
LOCAL\_VARIABLE,
/\*\* Annotation type declaration \*/
ANNOTATION\_TYPE,
/\*\* Package declaration \*/
PACKAGE,
/\*\*
\* Type parameter declaration
\*
\* @since 1.8
\*/
TYPE\_PARAMETER,
/\*\*
\* Use of a type
\*
\* @since 1.8
\*/
TYPE\_USE
}
从源代码的注释中,我们看到java.lang.annotation.ElementType此枚举类声明了有哪些Java元素类型:
java.lang.annotation.ElementType.TYPE:类、接口(包括注解类型)和枚举的声明
java.lang.annotation.ElementType.FIELD:字段声明(包括枚举常量)
java.lang.annotation.ElementType.METHOD:方法声明
java.lang.annotation.ElementType.PARAMETER:参数声明
java.lang.annotation.ElementType.CONSTRUCTOR:构造函数声明
java.lang.annotation.ElementType.LOCAL_VARIABLE:本地变量声明
java.lang.annotation.ElementType.ANNOTATION_TYPE:注解类型声明
java.lang.annotation.ElementType.PACKAGE:包声明
java.lang.annotation.ElementType.TYPE_PARAMETER:类型参数声明,JavaSE8引进,可以应用于类的泛型声明之处
java.lang.annotation.ElementType.TYPE_USE:JavaSE8引进,此类型包括类型声明和类型参数声明,是为了方便设计者进行类型检查,例如,如果使用@Target(ElementType.TYPE_USE)对@NonNull进行标记,则类型检查器可以将@NonNull class C {…} C类的所有变量都视为非null
注意:如果一个注解没有指定@Target注解,则此注解可以用于除了TYPE_PARAMETER和TYPE_USE以外的任何地方。
以下我们看看ElementType.TYPE_PARAMETER和ElementType.TYPE_USE的使用示例,对于其他的ElementType注解元素,看其说明就知道怎么用了:
声明由ElementType.TYPE_PARAMETER标记的@NotEmpty注解:
package org.springmorning.demo.javabase.annotation.meta;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
/**
* @author 春晨
* Copyright 2019 春晨 https://www.cnblogs.com/springmorning/p/10264624.html
*/
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE_PARAMETER)
public @interface NotEmpty {
}
声明由ElementType.TYPE_USE标记的@NotEmpty注解:
package org.springmorning.demo.javabase.annotation.meta;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
/**
* @author 春晨
* Copyright 2019 春晨 https://www.cnblogs.com/springmorning/p/10264624.html
*/
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE_USE)
public @interface NotNull {
}
以下示例代码说明了这两种Target注解元素的使用区别,ElementType.TYPE_USE包含了ElementType.TYPE和ElementType.TYPE_PARAMETER
package org.springmorning.demo.javabase.annotation.meta;
/**
* @author 春晨
* Copyright 2019 春晨 https://www.cnblogs.com/springmorning/p/10264624.html
*/
import java.util.ArrayList;
//泛型类型声明时,使用TYPE_USE类型,编译通过
class A <@NotNull TT>{}
//泛型类型声明时,使用使用TYPE_PARAMETER类型,编译通过
public class TypeParameterAndTypeUseAnnotation<@NotEmpty T>{
//使用TYPE\_PARAMETER类型,会编译不通过
// public @NotEmpty T test(@NotEmpty T a){
// new ArrayList<@NotEmpty String>();
// return a;
// }
//使用TYPE\_USE类型,编译通过
public @NotNull T test(@NotNull T a){
new ArrayList<@NotNull String>();
return a;
}
}
下节将给大家讲解元注解@Retention的使用。
手机扫一扫
移动阅读更方便
你可能感兴趣的文章