2016.10.13-关于注解的自定义和注解的解析

注解可以分为：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自定义注解的基础知识