java 自定义注解

自定义注解

1、注解可以标记给Java中的各种成员，起到给某个成员添加一些额外属性的目的。

2、@interface 用来声明一个注解

• 注解的本质就是一个继承了 Annotation 接口的接口

• 其中的每一个方法实际上是声明了一个配置参数

• 方法的名称就是参数的名称

• 返回值类型就是参数类型(返回值类型只能是基本 类型、Class、String、enum)

• 可以通过 default 来声明参数的默认值 d) 如果只有一个成员，一般参数名为 value

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface TestAnnotation {
    String value();
    String[] value2() default "value2";
    public boolean defaultDBValue() default false;
}

注解处理

java.lang.reflect.AnnotationElement接口提供了注解的处理，反射相关的类Class, Method, Field都实现了AnnotationElement接口。通过这些实现可以获取注解的所有属性。

元注解

• java.lang.annotation中提供了元注解，可以使用这些注解来定义自己的注解
• java注解常用到类的反射获取方法和属性。java8中一共有5个元注解
• 元注解类似元数据的概念，为其它注解提供基本的数据信息支持。
• 主要使用的是Target和Retention注解

@Target 目标作用范围
@Retention 保留
@Inherited 注解是否可被继承
@Documented 文档
@Repeatable 当没有@repeatable修饰的注解，在同一位置只能出现一次

@Target

@Target 标识这个注解能放到什么位置上（类？方法？属性？）target的值是一个数组 ElementType[] value(); 例如：

@Target({ElementType.METHOD,ElementType.TYPE})  // 标识当前注解只能放在类和方法上

标识的目标可以选择的位置列表如下:

ElementType.TYPE：能修饰类、接口或枚举类型(理解为对象引用类型，所以叫Type)
ElementType.FIELD：能修饰成员变量(属性)
ElementType.METHOD：能修饰方法
ElementType.PARAMETER：能修饰参数
ElementType.CONSTRUCTOR：能修饰构造器
ElementType.LOCAL_VARIABLE：能修饰局部变量
ElementType.ANNOTATION_TYPE：能修饰注解（annotaion 类型）
ElementType.PACKAGE：能修饰包

@Retention

@Retention表示生命周期，即当前表示的注解在（源码、编译、运行）那个范围起作用，且只有一个值

RetentionPolicy value();

public enum RetentionPolicy {
	/**
     * 注解只在源代码中存在，编译成class之后，就没了。@Override 就是这种注解。
     */
    SOURCE,
    /**
     * 注解在java文件编程成.class文件后，依然存在，但是运行起来后就没了。
     * @Retention的默认值，没有指定@Retention的value值的时候，就会是这种类型。
     */
    CLASS,
    /**
     * 注解在运行起来之后依然存在，可以通过反射获取这些信息
     */
    RUNTIME

非常有意思的一点是 @Retention 自己注解自己
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Retention {

@Inherited

就是字面意思“继承”
一个使用了@Inherited 修饰的annotation 注解类型被用于一个class，则这个annotation 将被用于该class 的子类。
要注意，此元注释仅使注释从超类继承；已实现的接口上的注释无效。

@Documented

在用javadoc命令生成API文档后，文档里会出现该注解说明
一般都是自定义注解都会放@Documented

@Repeatable

表示在同一个位置重复相同的注解，几乎很少使用 例如：

@Value("hello")
@Value("world")
public class A {}