注解

注解

概述
    Annotation in JDK5.0---将元数据引入Java
    Java代码里的特殊标记。它为在代码中添加用Java程序无法表达的额外信息提供了一种形式化的方法。   
    可以在程序中携带数据
注释与注解区别
    注释不会被程序所读取
    注解可以在编译、类加载、运行时被读取
    注解：在程序中有意义的，可以编译到class文件中，甚至可以在运行时带到程序中去
    注释：在程序中没有意义的，不会编译到class文件中
注解与xml(properties)文件区别
    xml文件：优点在不用硬编译，缺点维护多一些xml文件
    注解：缺点是硬编码，优点不用额外维护多的文件
注解的分类
    内建注解
        标准注解类型，如：@Override、@SuppressWarnings
        位于java.lang包下
    元注解
        描述数据的数据
        用处：文档编制、编译器检查、代码分析等
        修饰其他的注解定义，如： @Target 、@Retention
    自定义注解
        注解类型是一种接口。使用关键字@interface定义
内建注解
    限定重写父类方法：@Override
    标示已过时：@Deprecated
    抑制编译器警告：@SuppressWarnings
元注解
    @Target
        指定被其修饰的注解能用于修饰哪些程序元素
        成员变量value为ElementType 枚举类型，取值范围
            1. ElementType.CONSTRUCTOR:用于描述构造器
            2. ElementType.FIELD:用于描述域 
            3. ElementType.LOCAL_VARIABLE:用于描述局部变量
            4. ElementType.METHOD:用于描述方法
            5. ElementType.PACKAGE:用于描述包
            6. ElementType.PARAMETER:用于描述参数
            7. ElementType.TYPE:用于描述类、接口(包括注解类型) 或enum声明
    @Retention
        指定该注解可使用反射读取
        成员变量value：RetentionPolicy 枚举类型，取值范围：
            1. RetentionPolicy.SOURCE:在源文件中有效(即源文件保留)
            2. RetentionPolicy.CLASS:在class文件中有效(即class保留)
            3. RetentionPolicy.RUNTIME:在运行时有效(即运行时保留)
    @Documented
        指定被其修饰的注解将被JavaDoc工具提取成文档
    @Inherited
        指定被其修饰的注解将具有继承性
自定义注解
    @Target(ElementType.METHOD)
    @Retention(RetentionPolicy.RUNTIME)
    public @interface Shuaige {
        //基本数据类型(byte/short/int/long/float/double/char/boolean)
        //基本数据类型数组(byte[]/short[]/int[]/long[]/float[]/double[]/char[]/boolean[])
        //枚举/字符串/字符串数组
        public String name() default "shuaige";
        public boolean flag() default false;
        public int num() default 20;
        public enum FontColor{BULE,RED,GREEN};
        FontColor fontColor() default FontColor.GREEN;
        public String[] values() default "test";
    }
    //使用
    @Shuaige(name="test",flag=true,num=10,fontColor=FontColor.GREEN,values={"aaa","bbb"})
    public void test(){}
    //获取注解内容
    public static void getAnnotation(){
        try {
            Class clazz = Class.forName("com.shuai.one.User");
            Method method = clazz.getDeclaredMethod("getName", null);
            Annotation[] annotations = method.getAnnotations();
            for(Annotation annotation:annotations){
                Shuaige shuai = (Shuaige)annotation;
                System.out.println(shuai.name());
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
    注意：注解一定要使用RetentionPolicy.RUNTIME