1. 概述
Annotation是从JDK5.0开始引入的新技术。
1.1 Annotation 的作用:
– 不是程序本身,可以对程序作出解释。(这一点,跟注释没什么区别)
– 可以被其他程序(比如:编译器等)读取。
(注解信息处理流程,是注解和注释的重大区别
如果没有注解信息处理流程,则注解毫无意义)
1.2 Annotation 的格式:
– 注解是以“@注释名”在代码中存在的,还可以添加一些参数值,例如:
@SuppressWarnings(value=“unchecked”)。
1.3 Annotation 在哪里使用?
– 可以附加在package, class, method, field等上面,相当于给它们添加了额外的辅助信
息,我们可以通过反射机制编程实现对这些元数据的访问。
2. 内置注解
@Override
定义在 java.lang.Override
中,此注释只适用于修辞方法,表示一个方
法声明打算重写超类中的另一个方法声明。
下面打开源码看下注释:
@Deprecated
定义在 java.lang.Deprecated
中,此注释可用于修辞方法、属性、类
,表示不鼓励程序员使用这样的元素,通常是因为它很危险或存在更
好的选择。
比如 java.util.Date
里面已经过时的 parse
方法,看下面截图就晓得了。
下面打开源码看下注释怎么说:
@SuppressWarnings
– 定义在 java.lang.SuppressWarnings
中,用来抑制编译时的警告信息。
– 与前两个注释有所不同,你需要添加一个参数才能正确使用,这些参
数值都是已经定义好了的,我们选择性的使用就好了,参数如下:
示例:
– @SuppressWarnings(“unchecked”)
– @SuppressWarnings(value={“unchecked”,“deprecation”})
比如你这会儿很烦,不想看到任何警告出现,下面这样就可以满足你的要求。
3. 自定义注解
使用 @interface
自定义注解时,自动继承了 java.lang.annotation.Annotation
接口
- 要点
–@interface
用来声明一个注解 - 格式
–public @interface 注解名 {定义体}
通常自定义注解的同时,我们会加上元注解,什么是元注解呢,简单来讲,元注解就是对注解做进一步解释,后文会详细介绍。
– 其中的每一个方法实际上是声明了一个配置参数
– 方法的名称就是参数的名称
– 返回值类型就是参数的类型(返回值类型只能是基本类型、Class、String、enum)
– 可以通过default来声明参数的默认值
示例:
– 如果只有一个参数成员,一般建议参数名命名为value
- 注意
注解元素必须要有值。我们定义注解元素时,经常使用空字符串、0作为默认值。
也经常使用负数(比如:-1)表示不存在的含义
4. 元注解
元注解的作用就是负责注解其他注解。 Java定义了4个标准的
meta-annotation类型,它们被用来提供对其它 annotation
类型作说明。
• 这些类型和它们所支持的类在java.lang.annotation包中可以找到
– @Target – @Retention
– @Documented
– @Inherited
@Target
- 作用:
– 用于描述注解的使用范围(即:被描述的注解可以用在什么地方)
- 修饰范围
如下表所示
– @Target(value=ElementType.TYPE)
示例:@Target(value=ElementType.METHOD) 代表只能在方法前面使用
如果放在其他地方,比如类前面的话,看下面就知道了。
@Retention
- 作用:
– 表示需要在什么级别保存该注释信息,用于描述注解的生命周期
示例: