自定义注解和Annotation类使用

注解相当于一个标记，是类的组成部分

使用者可以使用注解传递参数（自定义注解）

注解也可用于检验内容（@Override， @FunctionalInterface）

注解也可用于强制运行内容（@before）等等...

 

自定义注解：

格式：

public @interface 注解名{

格式1：数据类型 属性名();

格式2：数据类型 属性名() default 默认值;

}

自定义注解属性可以使用的类型有：

java8种基本类型（int、byte、long、short、float、double、char、boolean）

String、class、注解、枚举类和以上这些类型的数组

@interface book{
String name;                
double price() default 0;    //自定义注解可以加上默认值
String[] authors();          //自定义注解可以使用数组
}

这样就定义好一个自定义注解，令使用注解时还能传递数据

若属性没有默认值，则在使用此注解时就一定给此属性赋值

@book(name = "注解使用", price = 32.0, authors = {"cikinn"})
    public void test() {
        
    }

 

特殊：若注解中只有一个属性，且名为value，使用注解的时候可以省略属性名，直接赋值

若不止一个value属性，就不允许省略了，否则会出现编译错误

例中 直接给value赋值了"特殊属性value"

@interface book {
    String value();
}


@book("特殊属性value")
public class Test1 {
    
}

 

元注解：

自定义注解时，在注解上的标识

@Target      用来说明注解使用的位置，没有标明则可以作用在任意成员变量上

Target的取值要在ElementType枚举类中取值

ElementType.TYPE                            此注解可以使用在类，接口上

ElementType.FIELD                           此注解可以使用在成员变量上

ElementType.METHOD                     此注解可以使用在成员方法上

ElementType.CONSTRUCTOR       此注解可以使用在构造方法上

想给Target多个值时，可以用数组的形式给Target赋值

@Target({ElementType.METHOD,ElementType.TYPE})
@interface book {
    String value();
}

 

@Retention      用来说明注解的有效范围

Retention的取值要在RetentionPolicy枚举类中取值

RetentionPolicy.SOURCE                源码阶段，仅在编码阶段有效，例：@Override

RetentionPolicy.CLASS                     字节码阶段，注解仅在编码和字节码阶段有效

RetentionPolicy.RUNTIME                 运行阶段，注解在所有阶段均有效

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
@interface book {
    String value();
}

 

@Inherited        标明该注解可以被子类继承

 

 

Annotation类：

要获取注解中的属性信息，首先要根据注解的位置，利用反射创建相应位置的对象

例：在成员变量上有一个自定义注解，就要先创建该成员方法Method对象，然后调用方法获取

 

以下方法均以此接口和Person作例子：

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.TYPE})
@interface book {
    String name();
    double price();
    String[] authors();
}
class Person{
    private String name;
    private String work;

    public Person(String name, String work) {
        this.name = name;
        this.work = work;
    }

    public Person() {
    }

    @book(name = "java精通", price = 23.0, authors = {"aa,bb"})
    public void show() {

    }
}

AnnotatedElement接口

boolean isAnnotationPresent(Class annotationClass)       判断当前对象是否有指定的注解

Class c = Test1.class;
Method method = c.getMethod("show");
boolean b = method.isAnnotationPresent(book.class);
System.out.println(b);        //输出:true

T getAnnotation(Class<T> annotationClass)                        获得当前对象上指定的注解对象

Class c = Person.class;
Method method = c.getMethod("show");
book b = method.getAnnotation(book.class);
System.out.println(b.price());                           //输出:23.0
System.out.println(Arrays.toString(b.authors()));        //输出:[aa,bb]
System.out.println(b.name());                            //输出:java精通

获取到注解类对象后，就可以直接对象.属性名获取到注解上的参数值

Annotation[] getAnnotations()                                         获得当前对象及其从父类上继承的所有的注解对象

Annotation[] getDeclaredAnnotations()                        获得当前对象上所有的注解对象，不包括父类的

 

若一个对象有多个注解同时修饰的时候

可以用getDeclaredAnnotations()方法获取全部注解对象并用Object类型接受

然后再用isAnnotationPresent()判断注解对象的类型

若返回true强转成对应的注解类型即可