自定义注解

引用1
引用2


元注解

注解的注解(给其他注解打注解的注解)
有四种:@Target,@Retention,@Documented,@Inherited

  • @Target
    概述:用于指定注解的使用位置
    1
    2
    3
    4
    5
    6
    7
    ElementType.CONSTRUCTOR:用于描述构造器
    ElementType.FIELD:用于描述域
    ElementType.LOCAL_VARIABLE:用于描述局部变量
    ElementType.METHOD:用于描述方法
    ElementType.PACKAGE:用于描述包
    ElementType.PARAMETER:用于描述参数
    ElementType.TYPE:用于描述类、接口(包括注解类型) 或enum声明
    使用如下,表明这个注解只能在方法和类接口等上使用
    1
    2
    3
    @Target({ElementType.METHOD,ElementType.TYPE})
    public @interface AccessCheck {
    }

  • @Retention
    概述:注解存在的地方
    1
    2
    3
    RetentionPolicy.SOURCE  //只存在于源码中,不被编译到Class文件中
    RetentionPolicy.CLASS //可以编译到Class文件中,但是不能再运行时被获取(默认)
    RetentionPolicy.RUNTIME //可以编译到Class文件中,可以在运行时通过反射获取
    使用如下:
    1
    2
    3
    @Retention(RetentionPolicy.RUNTIME)
    public @interface AccessCheck {
    }

  • @Documented
    概述:这个注解是否可以被包含在javaDoc中,打了这个注解表示可以包含
    使用如下:
    1
    2
    3
    @Documented
    public @interface AccessCheck {
    }

  • @Inherited
    概述:说明子类可以继承父类中的该注解

    @Inherited 元注解是一个标记注解,@Inherited阐述了某个被标注的类型是被继承的。如果一个使用了@Inherited修饰的annotation类型被用于一个class,则这个annotation将被用于该class的子类。

注意:@Inherited annotation类型是被标注过的class的子类所继承。类并不从它所实现的接口继承annotation,方法并不从它所重载的方法继承annotation。

当@Inherited annotation类型标注的annotation的Retention是RetentionPolicy.RUNTIME,则反射API增强了这种继承性。如果我们使用java.lang.reflect去查询一个@Inherited annotation类型的annotation时,反射代码检查将展开工作:检查class和其父类,直到发现指定的annotation类型被发现,或者到达类继承结构的顶层。


自定义注解

使用@interface自定义注解时,自动继承了java.lang.annotation.Annotation接口,由编译程序自动完成其他细节。在定义注解时,不能继承其他的注解或接口。@interface用来声明一个注解,其中的每一个方法实际上是声明了一个配置参数。方法的名称就是参数的名称,返回值类型就是参数的类型(返回值类型只能是基本类型、Class、String、enum)。可以通过default来声明参数的默认值。

注意:
  第一,只能用public或默认(default)这两个访问权修饰.例如,Stringvalue();这里把方法设为defaul默认类型;   
  第二,参数成员只能用基本类型byte,short,char,int,long,float,double,boolean八种基本数据类型和 String,Enum,Class,annotations等数据类型,以及这一些类型的数组.例如,String value();这里的参数成员就为String;  
  第三,如果只有一个参数成员,最好把参数名称设为”value”,后加小括号.例:下面的例子FruitName注解就只有一个参数成员。

1
2
3
4
5
6
7
@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface AccessCheck {
String value() default ""; //参数
String level() default "1";
}

自定义注解使用

通过反射机制操作自定义注解

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
    AppResult a = new AppResult();
Field[] fields = a.getClass().getDeclaredFields();//拿到私有的字段
int modifiers = a.getClass().getModifiers();
System.out.println(modifiers);
for (Field field : fields){
AccessCheck annotation = field.getAnnotation(AccessCheck.class);
System.out.println(field.getModifiers());;
System.out.println(field.getName()); //获取字段名
if (annotation!=null){
if (annotation.level().equals("1")){
try {
Class<?> type = field.getType(); //获取字段类型
System.out.println("是否相等:"+type.equals(String.class)); //这个字段为String,输出为true
field.setAccessible(true); //允许访问私有字段
System.out.println(field.get(a)); //拿到a对象中f字段的值
field.set(a, "zasjfdals"); //设置a对象中f字段的值
System.out.println(field.get(a));
} catch (IllegalAccessException e) {
e.printStackTrace();
}
}
}
}
}
文章作者: C.c
文章链接: https://liquidcat.cc/自定义注解.html
版权声明: 本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 Me