注解的语法和定义:
(1)以@interface关键字定义(接口的类型定义是interface,别混淆了)
(2)注解包含成员,成员以无参数的方法的形式被声明。其方法名和返回值定义了该成员的名字和类型。
(3)成员赋值是通过@Annotation(name=value)的形式。
(4)注解需要标明注解的生命周期,注解的修饰目标等信息,这些信息是通过元注解实现。
注解的类型:
java的Annotation注解主要分为三类,根据其生命周期划分为:
RetentionPolicy.SOURCE 注解只保留在源文件,当编译成class文件后,舍弃
RetentionPolicy.CLASS 编译时注解,当jvm加载class文件后舍弃
RetentionPolicy.RUNTIME 运行时注解,也是敲代码的时候最经常使用的方式,通过反射来获取数据
如何选择合适的注解类型:
使用情况:
RetentionPolicy.SOURCE :注解将被编译器丢弃(该类型的注解信息只会保留在源码里,源码经过编译后,注解信息会被丢弃,不会保留在编译好的class文件里)
RetentionPolicy.CLASS :注解在class文件中可用,但会被VM丢弃(该类型的注解信息会保留在源码里和class文件里,在执行的时候,不会加载到虚拟机(JVM)中)
RetentionPolicy.RUNTIME :JVM将在运行期也保留注解信息,因此可以通过反射机制读取注解的信息(源码、class文件和执行的时候都有注解的信息)
PS:当注解未定义Retention值时,默认值是CLASS
在Java中,系统给定了四种注解,给我们写自定义注解:
@Documented
用于描述其它类型的注解应该被作为被标注的程序成员的公共API,因此可以被例如javadoc此类的工具文档化。
@Inherited
标记注解,允许子类继承父类的注解
@Retention
标明注解的生命周期
@Target
标明注解的修饰目标
一般来说我们写注解只需要用到Retention和Target,Documented在企业版本会用得比较多,Inherited则看情况使用。下面从源码的角度上来看下这两个注解。
@Target
里面包含了一个ElementType数组,其中ElementType就是注解类修饰的类型,例如方法,参数,类等等,所以我们可以这样声明一个注解:
运行时注解的使用:
运行时注解,也是最简单最容易掌握的一种注解。通过反射获取对应的元素,再获取元素上面的注解,最后获取注解上面的值。下面我简单地举个例子:
<pre>
public static void getAnnotation(Object o) {
//获取class对象
Class<?> tClass = o.getClass();
FieldMethod[] methods = tClass.getAnnotationsByType(FieldMethod.class);//获取ElementType.TYPE类型的注解
for (Field f : tClass.getFields()) {
for (FieldMethod method : f.getAnnotationsByType(FieldMethod.class)) {
//获取变量的注释值ElementType.FIELD
System.out.println("method--->" + method.value());
}
}
for (FieldMethod method : methods) {
//获取ElementType.TYPE类型的注解里面的值
System.out.println("method--->" + method.value());
}
for (Constructor c : tClass.getConstructors()) {
for (FieldMethod method : c.getAnnotationsByType(FieldMethod.class)) {
//获取构造方法的注释值ElementType.Constructor
System.out.println("method--->" + method.value());
}
}
for (Method m : tClass.getMethods()) {
for (FieldMethod method : m.getAnnotationsByType(FieldMethod.class)) {
//获取类方法的注释值ElementType.method
System.out.println("method--->" + method.value());
}
for (Parameter p : m.getParameters()) {
for (FieldMethod method : p.getAnnotationsByType(FieldMethod.class)) {
//获取方法参数的注释值ElementType.PARAMETER
System.out.println("method--->" + method.value());
}
}
}
}
</pre>
其实运行时注解没啥好说的,很简单,主要是可以基本使用注解来写自定义注解来解决一些基本问题,提高写代码的质量和效率。