注解(Annotation)
一、概述
Annotation就是代码里的特殊标记,这些标记可以在编译、类加载、运行时被读取,并执行相应的处理。通过使用Annotation,程序员可以在不改变原有逻辑的情况下,在源文件中嵌入一些补充信息。代码分析工具、开放工具和部署工具可以通过这些补充信息进行验证或进行部署。
Annotation可以像修饰符一样被使用,可用于修饰包、类、构造器、方法、成员变量、参数、局部变量的声明,这些信息被保存在Annotation的“name = value”对中。
在JavaSE中,注解的使用目的比较简单,例如标记过时的功能,忽略警告等。在JavaEE/Android中注解占据了更重要的角色,例如用来配置应用程序的任何切面,代替JavaEE旧版中所遗留的繁冗代码和XML配置等。
未来的开发模式都是基于注解的,JPA是基于注解的,Spring2.5以上都是基于注解的,Hibernate3.x以后也是基于注解的,现在的Struts2有一部分也是基于注解的了,注解是一种趋势,一定程度上可以说:框架 = 注解 + 反射 + 设计模式。
二、注解的使用规范和场景
使用Annotation时要在前面增加@符号,并把该Annotation当作一个修饰符使用。用于修饰它支持的程序元素。
1、示例一:生成文档相关的注解
2、示例二:在编译时进行格式检查(JDK内置的三个基本注解)
@Override: 限定重写父类方法,该注解只能用于方法。
@Deprecated: 用于表示所修饰的元素(类、方法等)已过时。通常是因为所修饰的结构危险或存在更好的选择。
@SuppressWarning: 抑制编译器警告。
3、示例三:跟踪代码依赖性,实现替代配置文件功能
①Servlet3.0提供了注解(Annotation),使得不再需要在web.xml文件中进行Servlet的部署。
②Spring框架中关于“事务”的管理
三、自定义注解类(少用到)
- 注解类名前声明为:@interface,
- 内部定义成员,通常使用value表示,
- 可以指定成员的默认值,使用default定义,
- 如果自定义注解没有成员,表明是一个标识作用。
【
注意:
1.如果注解有成员,在使用注解时,需要指明成员的值。
2.自定义注解必须配上注解的信息处理流程(使用反射)才有意义。
3.自定义注解通常会指明两个元注解:Retention、Target。
】
创建自定义注解:
public @interface MyAnnotation {
String value();
}
使用自定义注解:
如果注解有成员,在使用注解时,需要指明成员的值。
@MyAnnotation(value = "hi~")
public void tryAnnotation(){
System.out.println("hello");
}
更多需要注意的:
四、JDK提供的4种元注解
概念: JDK的元Annotation用于修饰其他Annotation定义。(人话:对现有的注解进行解释说明的注解。)
JDK5.0提供了4个标准的meta-annotation类型:
- Retention
- Target
- Document
- Inherited
1、Retention
概念: 指定所修饰的Annotation的生命周期:
- SOURCE
- CLASS(默认行为)
- RUNTIME(只有声明为RUNTIME生命周期的注解,才能通过反射获取)
2、Target
概念: 用于指定被修饰的Annotation能用于修饰哪些程序元素。
- TYPE
- FIELD
- METHOD
- PARAMETER
- CONSTRUCTOR
- LOCAL_VARIABLE
- ANNOTATION_TYPE
- PACKAGE
- TYPE_PARAMETER
- TYPE_USE
/以下为低出现频率的元注解/
3、Document 和 Inherited
Document 概念: 表示所修饰的注解在被javadoc解析时,保留下来。
Inherited 概念: 被它修饰的Annotation将具有继承性。
五、JDK 8 注解的新特性
1、可重复注解
示例步骤(重点):
- 在MyAnnotation上声明@Repeatable,成员值为MyAnnotations.class 。
- MyAnnotation的(Target和Retention等元注解)必须和MyAnnotation相同。
MyAnnotation:
@Repeatable(MyAnnotations.class)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
String value();
}
MyAnnotations:
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotations {
MyAnnotation[] value();
}
然后就可以使用重复注解了:
@MyAnnotation(value = "hi~")
@MyAnnotation(value = "abc")
public void tryAnnotation(){
System.out.println("hello");
}
2、类型注解
- ElementType.TYPE_PARAMETER 表示该注解能写在类型变量的声明语句中(如:泛型声明)。
- ElementType.TYPE_USE 表示该注解能写在使用类型的任何语句中。