Java注解快速入门

注解

一、概述

本质是一个接口，扩展了java.lang.Annotation接口，它不是程序本身但可以对程序做出解释，可以被编辑器等程序读取。

它主要起检查和约束作用，最常用来替代不常更改内容的配置文件

使用：@注解名（参数）

二、内置注解

@Override

修饰方法，标注该方法是继承父类的，并且进行了方法重写；

方法被修饰后在代码编译时，会强制检查父类是否有该方法，且该方法是否符合父类方法的定义格式

@Deprecated

修饰类、属性、方法，表明被修饰部分不建议使用，可能会有危险或已经有更优的替代方式

@SuppressWarnings

修饰类、属性、方法，抑制编辑器的警告信息，使用时需要添加参数

@ SuppressWarnings（“unchecked”）

三、元注解

用来标注其他注解

@ Target

描述注解使用范围

参数：ElementType枚举类的常量

• PACKAGE 包
• TYPE 类、接口、枚举、注解
• PARAMETER 参数
• FIELD 字段、枚举常量
• CONSTRUCTOR 构造方法
• METHOD 方法
• LOCAL_VARTABLE 局部变量
• ANNOTATION_TYPE 注解

@ Retention

描述注解生命周期

参数： RetentionPolicy枚举类的常量

• CLASS 编译器将把注释记录在类文件中，但在运行时 VM 不需要保留注释
• RUNTIME 编译器将把注释记录在类文件中，在运行时 VM 将保留注释，因此可以反射性地读取
• SOURCE 编译器要丢弃的注释

@ Docubented

说明注解将被包含在JavaDOC中

@ Inherited

说明的子类可以承父类中的该注解

四、自定义注解

自动继承了lang.annotation.Annotation接口

public void @interface 注解名｛｝

可以为注解设定参数，使用注解时必须为其赋值，若定义注解时使用**default**关键字修饰参数，使用时可以不用赋值

public @interface MyAnn{
    int num();
    String value() default "ok";
}

使用元注解来为自定义注解注释，用于设定注解的使用范围

@Documented
@Retention(value=RUNTIME)
@Target(value=TYPE)
public @interface MyAnn{
    int num();
    String value() default "ok";
}

使用：

@MyAnn(num=66)
public Class MyTest{
    private int num;
}