1. 概述
- 不是程序本身,但可以对程序作出解释,可以被其他程序(比如:编译器)读取。
- 格式:@注释名(参数值)
- 使用范围:可以附加在package、class、method、field等上面。
2. 内置注解
-
@Override: 只适用于修饰方法,表示一个方法声明打算重写超类中另一个方法声明。
-
@Deprecated: 用于修饰方法、属性、类,表示不鼓励使用这样的元素。注:可以看出用@Deprecated修饰的getTime()方法被画上一条横线,表示此方法已过时。
-
@SuppressWarnings: 用来抑制编译时的警告信息,与前 两者不同的是,需要增加一个参数才能正确使用。如@SuppressWarnings(“all”)表示镇压警告。
3. 元注解
- 作用是负责注解其他注解
- @Target: 用于描述注解的使用范围,即被描述的注解可以用在什么地方,如方法、字段、类。你可以这样理解,当一个注解被 @Target 注解时,这个注解就被限定了运用的场景。@Target 的取值如下:
-ElementType.METHOD 可以给方法进行注解
-ElementType.FIELD 可以给属性进行注解
-ElementType.TYPE 可以给一个类型进行注解,比如类、接口、枚举
-ElementType.LOCAL_VARIABLE 可以给局部变量进行注解
-ElementType.ANNOTATION_TYPE 可以给一个注解进行注解
-ElementType.CONSTRUCTOR 可以给构造方法进行注解 - @Retention: 表示需要在什么级别保存该注释信息,用于描述注解的生命周期。(SOURCE<CLASS<RUNTIME),@Retention的取值如下:
-RetentionPolicy.SOURCE 注解只在源码阶段保留,在编译器进行编译时它将被丢弃忽视。
-RetentionPolicy.CLASS 注解只被保留到编译进行的时候,它并不会被加载到 JVM 中。
-RetentionPolicy.RUNTIME 注解可以保留到程序运行的时候,它会被加载进入到 JVM 中,所以在程序运行时可以获取到它们。
4. 自定义注解
- 格式:public @interface 注解名{定义内容}
- 每一个方法实际上是声明了一个配置参数
- 方法的名称就是参数的名称
- 返回值类型就是参数类型,返回值只能是基本类型,Class,String,enum
- 可以通过default来声明参数的默认值
- 如果只有一个参数成员,一般参数名为value
- 注解元素必须要有值,在定义注解元素时,经常使用空字符串,0作为默认值
- 案例