注解可以分为:1、标识性注解(没有成员变量) 2、注解 3、元注解(注解的注解)
1、注解的自定义
@Target({ElementType.METHOD,ElementType.TYPE})//作用域
@Retention(RetentionPolicy.RUNTIME)//作用运行时
@Inherited //可以被子类集成
@Documented //可以生产java doc
public @interface MyDescription {
//1、注解可以没有成员,称为标识注解,只起到标识作用
//2、注解只有一个成员时必须为value()
String value();
// //3、注解的成员变量可以设置默认值
// String desc(); //成员必须无参数无异常的形式
// String author();
// int age() default 18;
//没有解析的注解是没有实际意义的:解析注解是通过反射获取类,函数或成员变量上 运行时
// 的注解信息从而实现动态控制程序运行的逻辑
}
自定义注解的格式
public @interface MyDescription {
//成员变量的规则见上面的代码
}
元注解
作于其他注解的注解,被称为元注解(Meta Annotation)
@Retention 指明被标注的注解在什么时候使用(也就是注解什么时候会被保留)
仅仅在源代码中保留,在编译过程中丢弃(RetentionPolicy.RUNTIME)
注解在编译过程中保存到class文件,在class文件被加载时候忽略(RetentionPolicy.CLASS)
注解在class文件加载时候被读取,也就是运行中注解可用,可以通过反射获取注解信息(RetentionPolicy.RUNTIME)
@Documented 指明在生成Javadoc时候,被标注的注解将被写入Javadoc文档中
@Target 指明被标注的注解的作用范围
ElementType.TYPE:用于描述类、接口(包括注解类型) 或enum声明
ElementType.FIELD:用于描述域-成员变量
ElementType.METHOD:用于描述方法
ElementType.PARAMETER:用于描述参数
ElementType.CONSTRUCTOR:用于描述构造器
ElementType.LOCAL_VARIABLE:用于描述局部变量
ElementType.ANNOTATION_TYPE:用于描述注解
ElementType.PACKAGE:用于描述包
@Inherited 指明被标注的注解是被继承的,也就是说如果一个@Inherited修饰的annotation类型被用于一个类,则这个annotation也会作用于改类的子类。只有作用于类的注解才会被集成,方法的注解不会继承
@Repeatable 指明被标注的注解可以多次作用于同一个对象,1.9新增注解
注解的解析,通过java反射机制找到注解对象 做处理
package model;
import java.lang.annotation.Annotation;
import java.lang.reflect.Method;
public class ParseAnn {
public static void main(String[] args) {
//解析注解
try {
//通过反射找到带有注解的类
Class c = Class.forName("model.Child");
//判断这个类是不是包含了这个注解
boolean isExist = c.isAnnotationPresent(MyDescription.class);
if(isExist){
//如果包含了这个注解就拿到注解的实例
MyDescription myDesc = (MyDescription) c.getAnnotation(MyDescription.class);
//获得注解的value并打印出来
System.out.println(myDesc.value());
}
//解析方法上的注解 同解析类上的注解类似
Method[] methods = c.getMethods();
for (Method method : methods) {
boolean exist = method.isAnnotationPresent(MyDescription.class);
if(exist){
MyDescription myDesc = method.getAnnotation(MyDescription.class);
System.out.println(myDesc.value());
}
}
//另外一种解析方式
//获得类的所有注解
Annotation[] anns = c.getAnnotations();
for (Annotation annotation : anns) {
//判断注解是不是所需类型
if (annotation instanceof MyDescription){
System.out.println(((MyDescription) annotation).value());
}
}
for (Method method : methods) {
Annotation[] methodAnns = method.getAnnotations();
for (Annotation annotation : methodAnns) {
if(annotation instanceof MyDescription){
System.out.println(((MyDescription) annotation).value());
}
}
}
} catch (Exception e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}
以上是java自定义注解的基础知识