注解 --- Annotation

红太狼 2023-09-28 10:04 119阅读 0赞

### 注解的概念 ###

Annotation 是一种能够被书写到Java源代码中的元数据（metadata：描述数据的数据）形式。类、方法、变量、参数和包都可以使用它来进行描述。Annotation不会对它描述的代码操作有任何的直接影响。

### JDK中自带的常用注解 ###

@Override -- 要求编译器在编译时检查被修饰的方法是否是一个正确的重写；

@Deprecated -- 被它修饰的方法会被标记为过时（过时不是错误！！），然后编译器就可以提示我们。通常都是用一根斜线把这个方法名划掉。

@SuppressedWarnings -- 用来把代码中的警告信息给消除掉，让它不再报黄色警告。

通过这三种注解的使用，我们了解到了注解的使用表象：

1、@注解名(参数......) 如果一个注解没有参数，那么()可以省略。

2、注解可以写在类的声明、方法的声明、变量的声明(属性、参数、局部变量)、和包的声明。

3、注解不仅仅是写给程序员看的，它还可以影响到编译器，甚至是运行期。

#### 注解的本质 ####

Annotation在本质上就是一个Java类型，是JDK1.5提出的。

1、我们可以把Annotation理解为一种特殊的接口，因为所有的Annotation都默认继承了java.lang.annotation.Annotation的接口。但是在实现的语法中，我们不能做直接的接口继承，而是要使用@interface关键字声明它。

public @interface 注解名{
    
    }

2、在注解的\{\}内，我们要填写它的内容。而它的内容既不是方法也不是属性，或者说语法上既像方法又像属性。

public @interface 注解名{
        访问修饰符 数据类型 标识名();
        ......
    }

*注意* 访问修饰符都是public的，可以省略； 数据类型只有5种（基本数据类型、String、Class、枚举、注解类型），以及这5种的一维数组； 标识名应该是名词，因为它代表了一个配置项或者叫做属性名 ()不可少，不是参数列表，仅仅是一种特有语法。 如果某个类型元素有默认值，那么应该是用default接在后面；

3、一个注解定义的时候除了上面两点，还可以控制它的使用位置和获取时机 用@Target注解 定义当前注解的书写位置 用@Retention注解 定义当前注解的获取时机 @Target要求填入的有类声明处、方法声明处、构造声明处、变量声明处、参数声明处等等，而且可以同时配置多个 @Retention只有3个选择：源代码、class文件和运行时。通常都是运行时。

@Target({ElementType.METHOD})
    @Retention(RetentionPolicy.RUNTIME)
    public @interface 注解名{
        访问修饰符 数据类型 标识名();
        ......
    }

另外还有两个修饰注解的注解:@Documented和@Inherited

#### 使用注解 ####

1、首先根据该注解的@Target写在正确的位置；

2、书写的语法：

@注解名(类型元素=值1，类型元素=值2....)

*注意*

1、如果一个注解没有类型元素，那么可以省略它后面的() @Overrid @Override()

2、如果一个注解只有一个类型元素，且名字叫做value，那么可以省略"value=" @MyAnnotation(\{"hello","world"\}) @MyAnnotation(value=\{"hello","world"\})

3、数组类型的类型元素，如果只给一个值，那么可以省略掉\{\} @MyAnnotation("hello") @MyAnnotation(\{"hello"\}) @MyAnnotation(value="hello")

#### 注解到底在干什么？ ####

其实，定义注解就是在定义一个具有更强针对性的配置。