注解(Annontion)是Java5开始引入的新特征。它提供了一种安全的类似注释的机制,用来将任何的信息或元数据(metadata)与程序元素(类、方法、成员变量等)进行关联。
1、元注解
元注解的作用就是负责注解其他注解。Java5.0定义了4个标准的meta-annotation类型,它们被用来提供对其它 annotation类型作说明。Java5.0定义的元注解有以下几种:
- @Target
- @Retention
- @Documented
- @Inherited
1.1 @Target
用于描述注解的范围,即注解在哪用。它说明了Annotation所修饰的对象范围.取值类型(ElementType)有以下几种:
1. TYPE 类、接口(包括注解类型) 或enum声明
2. FIELD 字段声明(包括枚举常量)
3. METHOD 方法声明
4. PARAMETER 参数声明
5. CONSTRUCTOR 构造函数声明
6. LOCAL_VARIABLE 局部变量声明
7. ANNOTATION_TYPE 注释类型声明
8. PACKAGE 包声明
9. TYPE_PARAMETER 类型参数声明
10. TYPE_USE 类型的使用
11. MODULE 模块声明
1.2 @Retention
用于描述注解的生命周期,表示需要在什么级别保存该注解,即保留的时间长短。取值类型(RetentionPolicy)有以下几种:
1. SOURCE:在源文件中有效(即源文件保留)
2.CLASS:在class文件中有效(即class保留)
3.RUNTIME:在运行时有效(即运行时保留)
1.3 @Documented
用于描述其它类型的annotation应该被作为被标注的程序成员的公共API,因此可以被例如javadoc此类的工具文档化。它是一个标记注解,没有成员。
1.4 @Inherited
用于表示某个被标注的类型是被继承的。如果一个使用了@Inherited修饰的annotation类型被用于一个class,则这个annotation将被用于该class的子类。
当前共有 0 条评论