注解的分类
- JDK注解
- 元注解
-
目录
JDK注解
@Override :用来标识重写方法
@Deprecated标记就表明这个方法已经过时了,但我就要用,别提示我过期
@SuppressWarnings(“deprecation”) 忽略警告
@SafeVarargs jdk1.7出现,堆污染,不常用
@FunctionallInterface jdk1.8出现,配合函数式编程拉姆达表达式,不常用
元注解
用来描述注解的注解,就5个:
@Target 注解用在哪里:类上、方法上、属性上等等
@Retention 注解的生命周期:源文件中、字节码文件中、运行中
@Inherited 允许子注解继承
@Documented 生成javadoc时会包含注解,不常用
@Repeatable注解为可重复类型注解,可以在同一个地方多次使用,不常用
@Target 注解
用来指定一个注解的使用范围,即被 @Target 修饰的注解可以用在什么地方。@Target 注解有一个成员变量(value)用来设置适用目标,value 是 java.lang.annotation.ElementType 枚举类型的数组,下表为 ElementType 常用的枚举常量。
名称 | 说明 |
---|---|
CONSTRUCTOR | 用于构造方法 |
FIELD | 用于成员变量(包括枚举常量) |
LOCAL_VARIABLE | 用于局部变量 |
METHOD | 用于方法 |
PACKAGE | 用于包 |
PARAMETER | 用于类型参数 |
TYPE | 用于类、接口(包括注解类型)或 enum 声明 |
@Retention
@Retention 用于描述注解的生命周期,也就是该注解被保留的时间长短。@Retention 注解中的成员变量(value)用来设置保留策略,value 是 java.lang.annotation.RetentionPolicy 枚举类型,RetentionPolicy 有 3 个枚举常量,如下所示。
SOURCE:在源文件中有效(即源文件保留)
CLASS:在 class 文件中有效(即 class 保留)
RUNTIME:在运行时有效(即运行时保留)
生命周期大小排序为 SOURCE < CLASS < RUNTIME,前者能使用的地方后者一定也能使用。如果需要在运行时去动态获取注解信息,那只能用 RUNTIME 注解;如果要在编译时进行一些预处理操作,比如生成一些辅助代码(如 ButterKnife),就用 CLASS 注解;如果只是做一些检查性的操作,比如 @Override 和 @SuppressWarnings,则可选用 SOURCE 注解。
自定义注解
声明自定义注解使用 @interface 关键字(interface 关键字前加 @ 符号)实现。
代码举例
public class TestAnnotation {
}
//通过@Target注解标记自定义注解可以使用的问题
@Target({ElementType.TYPE,ElementType.METHOD})//标记自定义注解可以加在类&方法上
/*3.通过@Target元注解规定自定义注解可以使用的位置
* 我们使用“ElementType.静态常量”的方式来指定自定义注解具体可以加在什么位置
* 而且,这里的值可以写多个,格式:@Target({ElementType.xx1,ElementType.xx2})*/
//通过@Retention注解标记自定义注解的生命周期
@Retention(RetentionPolicy.RUNTIME)//到运行时都有效
/*4.通过@Retention元注解规定自定义注解的生命周期
* 我们使用“RetentionPolicy.静态常量”的方式来指定自定义注解具体的生命周期
* 注意:这个值只能写一个:SOURCE CLASS RUNTIMR 3选1*/
/*1.首先注意:注解定义的语法与java不同
* 2.定义自定义注解的格式:@interface 注解名*/
@interface Rice{
//给注解进行功能增强---添加注解的属性
/*5.注意:int age();不是方法的定义,而是给自定义注解添加了一个age属性 */
//int age();//给Rice注解添加了一个普通的int类型的age属性
int age() default 0;//给普通属性age赋予默认值0
//给自定义注解添加特殊属性value
/*自定义注解中还可以添加特殊属性value
* 特殊属性的定义方式与赋予默认值的方式和普通属性一样
* 但注意:特殊属性的名字必须是value,类型不做限制*/
//String value();//定义一个特殊属性value,类型是String
String value() default "lemon";//定义一个特殊属性value,类型是String
}
//测试自定义注解
class TestAnno{
/*测试1:分别给TestAnno类/name属性/eat方法添加Rice注解
* 结论:属性上的注解报错了,说明自定义注解可以加在什么位置,由@Target决定*/
String name;
/*测试2:当我们给Rice注解添加了一个age属性以后,@Rice注解使用时直接报错
* 结论:当注解没有定义属性时,可以直接使用
* 当注解定义了属性以后,必须给属性赋值,格式: @Rice(age = 10)*/
//@Rice(10)//报错,普通属性赋值不可以简写
//@Rice(age = 10)
/*测试3:给age属性赋予默认值以后,以后就可以直接使用Rice注解了
* 不需要给age属性赋值,此时age属性的值就是默认值0*/
//@Rice("Apple")
/*测试4:给Rice注解添加了特殊属性value以后,必须给属性赋值
* 只不过特殊属性赋值是可以简写成: @Rice("Apple")*/
//@Rice//不报错,因为我们定义了两个属性,但两个属性都有默认值
/*测试5:如果特殊属性也赋予了默认值,那么可以不赋值直接使用注解
* 但是如果想要给注解的所有属性赋值,每条赋值语句包括特殊属性,都不可以简写*/
@Rice(age = 10,value = "banana")
public void eat(){
System.out.println("一会儿又能干饭了");
}
版权声明:本文为CSDN博主「java小鲤鱼」的原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接及本声明。
原文链接:https://blog.csdn.net/m0_46991147/article/details/121474672