要深入学习注解,我们就必须能定义自己的注解,并使用注解,在定义自己的注解之前,我们就必须要了解Java为我们提供的元注解和相关定义注解的语法。
package annotation;
import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
/**
*
* @author Minzhe Xu 2017年4月27日下午3:22:52
*
*@Target 表示该注解用于什么地方,可能的值在枚举类 ElemenetType 中,包括:
*ElemenetType.CONSTRUCTOR:构造器声明
*ElemenetType.FIELD :域声明(包括 enum 实例)
*ElemenetType.LOCAL_VARIABLE:局部变量声明
*ElemenetType.METHOD :方法声明
*ElemenetType.PACKAGE :包声明
*ElemenetType.PARAMETER :参数声明
*ElemenetType.TYPE:类,接口(包括注解类型)或enum声明
*
*@Retention 表示在什么级别保存该注解信息。可选的参数值在枚举类型 RetentionPolicy 中,包括:
*RetentionPolicy.SOURCE :注解将被编译器丢弃
*RetentionPolicy.CLASS :注解在class文件中可用,但会被VM丢弃
*RetentionPolicy.RUNTIME VM:将在运行期也保留注释,因此可以通过反射机制读取注解的信息。
*
*@Documented 将此注解包含在 javadoc 中 ,它代表着此注解会被javadoc工具提取成文档。在doc文档中的内容会因为此注解的信息内容不同而不同。相当与@see,@param 等。
*
*@Inherited 允许子类继承父类中的注解。
*/
@Target({ElementType.TYPE,ElementType.CONSTRUCTOR,ElementType.METHOD,ElementType.PARAMETER,ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
public @interface TestA {
/**
* @interface用来声明一个注解,
* 其中的每一个方法实际上是声明了一个配置参数。
* 方法的名称就是参数的名称,返回值类型就是参数的类型(返回值类型只能是基本类型、Class、String、enum)。
* 可以通过default来声明参数的默认值。
*/
String name();
int id() default 0;
Class gid();