Java中的注解 | 易学教程

1.注解的概念

（1）什么是注解？
Annotation是从JDK5.0开始引入的新技术
（2）注解的作用：

不是程序本身 , 可以对程序作出解释.
可以被其他程序(比如:编译器等)读取

（3）注解的格式：
注解是以"@注释名"在代码中存在的 , 还可以添加一些参数值
例如:@SuppressWarnings(value=“unchecked”).
（4）注解的使用:
可以附加在package , class , method , field 等上面 , 相当于给他们添加了额外的辅助信息, 我们可以通过反射机制编程实现对这些元数据的访问

2.元注解：元注解就是注解的根，也就是注解的注解。

在这里插入图片描述

（1）@Target : 用于描述注解的使用范围(即:被描述的注解可以用在什么地方)

类型	使用位置
ElementType.ANNOTATION_TYPE	可以给一个注解进行注解
ElementType.CONSTRUCTOR	可以给构造方法进行注解
ElementType.FIELD	可以给属性进行注解
ElementType.LOCAL_VARIABLE	可以给局部变量进行注解
ElementType.METHOD	可以给方法进行注解
ElementType.PACKAGE	可以给一个包进行注解
ElementType.PARAMETER	可以给一个方法内的参数进行注解
ElementType.TYPE	可以给一个类型进行注解，比如类、接口、枚举

（2）@Retention : 表示需要在什么级别保存该注释信息 , 用于描述注解的生命周期

(SOURCE < CLASS < RUNTIME)

类型	生命周期
RetentionPolicy.SOURCE	注解只在源码阶段保留，在编译器进行编译时它将被丢弃忽视
RetentionPolicy.CLASS	注解只被保留到编译进行的时候，它并不会被加载到 JVM 中
RetentionPolicy.RUNTIME	注解可以保留到程序运行的时候，它会被加载进入到 JVM 中，所以在程序运行时可以获取到它们。

（3）@Document：说明该注解将被包含在javadoc中

（4）@Inherited：说明子类可以继承父类中的该注解

3.内置注解

(1)@Override : 定义在 java.lang.Override 中 , 此注释只适用于修辞方法 , 表示一个方法声明打算重写超类中的另一个方法声明.
(2)@Deprecated : 定义在java.lang.Deprecated中 , 此注释可以用于修辞方法 , 属性 , 类 , 表示不鼓励程序员使用这样的元素 , 通常是因为它很危险或者存在更好的选择 .
(3)@SuppressWarnings : 定义在java.lang.SuppressWarnings中,用来抑制编译时的警告信息.

注意：第三个需要添加参数。
 @SuppressWarnings("all") 
 @SuppressWarnings("unchecked") 
 @SuppressWarnings(value={"unchecked","deprecation"}) 等等

4.自定义注解

使用 @interface自定义注解时 , 自动继承了java.lang.annotation.Annotation接口

public class Test2 {
    private int age;
    @MyAnnotation(name = "didi")
    public int getAge() {
        return age;
    }
}
//除了这四个注解之外的所有注解，都叫做自定义注解！
@Target(ElementType.METHOD) //表示我这个注解，能够注解谁！  方法，字段，类
@Retention(RetentionPolicy.RUNTIME) //自定义注解我们都会使用 RetentionPolicy.RUNTIME 在运行时生效
@Documented //表示L可以在Javadoc中生成信息，没什么用！
@Inherited //表示子类可以继承父类的注解，一般也不用！
@interface MyAnnotation{
      String name() default  "";
      int age() default 0;
      String[] value()  default "";
}

注意：

@ interface用来声明一个注解 , 格式 : public @ interface 注解名 { 定义内容 }
其中的每一个方法实际上是声明了一个配置参数.
方法的名称就是参数的名称.
返回值类型就是参数的类型 ( 返回值只能是基本类型,Class , String , enum ).
可以通过default来声明参数的默认值
如果只有一个参数成员 , 一般参数名为value
注解元素必须要有值 , 我们定义注解元素时 , 经常使用空字符串,0作为默认值

来源：CSDN

作者：贫僧洗发爱飘柔

链接：https://blog.csdn.net/qq_45637894/article/details/103464015

标签

runtime