JavaSE---Annotation

1、概述

　　　　　　1.1　　JDK1.5开始，java提供了对Annotation的支持；

　　　　　　1.2　　Annotation其实就是　代码中的特殊标记，这些标记　可以在编译、类加载、运行时被读取，并执行相应的处理；

　　　　　　1.3　　提供使用Annotation，开发人员可以在不改变原有逻辑的情况下，在源文件中嵌入一些补充信息；

　　　　　　1.4　　Annotation本质上就是一个接口；

　　　　　　　　　　　　　从某些方面看，Annotation就像修饰符一样被使用在类、构造器、方法、属性等；

　　　　　　1.5　　Annotation作用：为  程序元素（类、成员变量、方法等）设置元数据；

　　　　　　1.6　　Annotation本身并不能影响程序的执行，无论新增、删除Annotation，代码都始终一样执行；

　　　　　　　　　　　　　如果希望Annotation在程序运行时起到一定作用，需要使用  （访问和处理Annotation的工具） APT　对Annotation中的信息进行访问、处理；

　　　　　　1.7　　Annotation必须使用工具处理，工具负责提取Annotation中的元数据，工具还会根据这些元数据提供额外的功能；

　　　　　　1.8　　Annotation的使用：

　　　　　　　　　　　　在Annotation名称前使用@，并将其当做修饰符使用，用于修饰指定的程序元素；

2、JDK提供的3个Annotation（java.lang包下）：

　　　　　　2.1　　@Override

　　　　　　　　　　　　　　子类中的方法被@Override修饰时，编译器会去父类找对应的方法，如果没有则编译出错；

　　　　　　2.2　　@Deprecated

　　　　　　　　　　　　　　当程序元素被@Deprecated修饰，当使用到此元素时，编译器会给出警告；

　　　　　　2.3　　@SuppressWarnings

　　　　　　　　　　　　　　被@SuppressWarnings标识的程序元素   取消显示 编译器的警告；

package com.an.annotation;

public class Test {

    //++++++++++++++@Override
    public void say(){

    }

    class A extends Test{
        //编译器  去父类中是否有say方法，没有编译报错
        @Override
        public void say(){

        }
    }

    //++++++++++++++@Deprecated
    @Deprecated
    public void jump(){

    }
    @SuppressWarnings(value = "unchecked")
    public static void main(String[] args){
        new Test().jump();
    }

}

3、JDK提供的4个Annotation（java.lang.annotation包下）：

　　　　　　3.1　　用于修饰  其他的Annotation；

　　　　　　3.2　　@Retention

　　　　　　　　　　　　　　作用：指定该Annotation可以保留多长时间；

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Retention {

    RetentionPolicy value();
}

　　　　　　　　　　　　　　包含一个成员变量value，使用时必须为value赋值；

　　　　　　　　　　　　　　value值的种类：

　　　　　　　　　　　　　　　　　　

　　　　　　3.3　　@Target

　　　　　　　　　　　　　　作用：指定  被修饰的Annotation   可以用于程序的哪些元素；　　　　　　　　　　　　　

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Target {

    ElementType[] value();
}

　　　　　　　　　　　　　　有一个成员变量value，使用时必须对value赋值；

　　　　　　　　　　　　　　value值的类型：

　　　　　　　　　　　　　　　　　　

　　　　　　3.4　　@Documented

　　　　　　　　　　　　　作用：被@Documented修饰的Annotation  在使用时，将被javadoc工具提取成文档；　　　　　　　　　　　　

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Documented {
}

　　　　　　3.5　　@Inherited

　　　　　　　　　　　　　作用：被@Inherited修饰的Annotation  使用时，使用此Annotation的类的子类将均有该注解；

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Inherited {
}

　　

4、自定义Annotation类型

　　　　　　4.1　　Annotation定义：

　　　　　　　　　　　　在Annotation名称前加@interface     eg:public @interface Test{}

　　　　　　4.2　　自定义、使用

package com.an.annotation;

import java.lang.annotation.*;

@Inherited
@Documented
@Retention(value = RetentionPolicy.RUNTIME)
public @interface TestOne {
}

　　

package com.an.annotation;

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

@Retention(value = RetentionPolicy.RUNTIME)
public @interface TestTwo {
}

　　　

package com.an.annotation;

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

@Retention(value = RetentionPolicy.RUNTIME)
public @interface MyTest {
    //使用default定义初始值
    String name() default "jack";
    int age() default 12;
    String sex();

    class Test{
        //如果指定默认值，则无需赋值
        @MyTest(sex = "female")
        @TestOne
        @TestTwo
        public void hi(){

        }
    }
}

　

package com.an.annotation;

import java.lang.annotation.Annotation;
import java.lang.reflect.Method;

public class GetAnnotationTest {
    @MyTest(sex = "female")
    @TestOne
    @TestTwo
    public void say(){

    }

    public static void main(String[] args)throws Exception{
        Class testClass=Class.forName("com.an.annotation.GetAnnotationTest");
        Method method =testClass.getMethod("say");
        Annotation[] annotations =method.getAnnotations();
        for (Annotation annotation:annotations){
            System.out.println(annotation);
        }
    }
}

结果：

@com.an.annotation.MyTest(name=jack, age=12, sex=female)
@com.an.annotation.TestOne()
@com.an.annotation.TestTwo()