元注解与自定义注解

在jdk1.5引进了注解的，有许多框架都使用了注解，例如spring，hibernate.现将其简单介绍一下
元注解：注解的注解，即java为注解开发特准备的注解。
在java中有四种元注解

一、元注解

1.@Target

表示该注解用于什么地方

public enum ElementType {
    /** 类，接口（包括注解类型）或enum声明  */
    TYPE,

    /** 域声明（包括 enum 实例） */
    FIELD,

    /** 方法声明 */
    METHOD,

    /** 参数声明 */
    PARAMETER,

    /** 构造器声明 */
    CONSTRUCTOR,

    /** 局部变量声明  */
    LOCAL_VARIABLE,

    /** Annotation type declaration */
    ANNOTATION_TYPE,

    /**  包声明  */
    PACKAGE,

    /**
     * 类型参数声明
     *
     * @since 1.8
     */
    TYPE_PARAMETER,

    /**
     * 类型的使用
     *
     * @since 1.8
     */
    TYPE_USE
}

2.@Retention（注解的生命周期）

表示该注解可以保存的范围

public enum RetentionPolicy {
    /**
     * 源代码：即此注解只能保存在源代码中
     * 当编译时，会被丢弃
     */
    SOURCE,

   /**
     * class文件：即此注解可以在class文件中保留
     * 但会被jvm丢弃
     */
    CLASS,

   /**
     * 运行期：即此注解可以在运行时保留
     * 可以通过反、反射获得
     */
    RUNTIME
}

3.@Documented

生成javadoc时会包含注解，即拥有这个注解的元素可以被javadoc此类的工具文档化。它代表着此注解会被javadoc工具提取成文档。在doc文档中的内容会因为此注解的信息内容不同而不同。相当与@return,@param 等。

4.@Inherited

允许子类继承父类中的注解。即拥有此注解的元素其子类可以继承父类的注解。

 

二、自定义注解

1、自定义注解的语法

2、使用注解语法

 

三、解析注解

1、通过反射获取类、函数或成员上的运行时注解信息，从而实现动态控制程序运行的逻辑。

示例：

注解定义：

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
public @interface Decription {
    String type() default "";
    String decription() default "";
}

上面的注解介绍：

（1）注解只能在类上或者方法上使用

（2）注解在运行时生效

（3）注解可以被所修饰的类的子类继承（即子类同样拥有当前注解的效果）；注意：如果是实现接口那么注解是没办法被继承的

注解使用：

@Decription(type = "类上描述", decription = "当前类为Person")
public class Person {
    private String name;
    private Integer age;
    private String phone;

    @Decription(type = "方法上描述", decription = "当前方法为println")
    public void println(){
        System.out.println("学生姓名为：" + name);
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    public String getPhone() {
        return phone;
    }

    public void setPhone(String phone) {
        this.phone = phone;
    }
}

注解解析：

public static void main(String[] args) {
        Person person = new Person();
        person.setName("程序员");

        Class personClass = person.getClass();
        // 判断类上是否存在注解
        boolean isExist = personClass.isAnnotationPresent(Decription.class);
        if(isExist){
            // 类上存在注解，打印注解的属性值
            Decription decription =(Decription)personClass.getAnnotation(Decription.class);
            System.out.println("注解的值：" + decription.type() + "和" + decription.decription());
        }

        Method[] methods = personClass.getMethods();
        for(Method method : methods){
            if(method.isAnnotationPresent(Decription.class)){
                System.out.println("方法" + method.getName() + "有使用Decription注解，且");
                Decription decription = method.getAnnotation(Decription.class);
                System.out.println("注解的值：" + decription.type() + "和" + decription.decription());
            } else {
                System.out.println("方法" + method.getName() + "没有使用Decription注解");
            }
        }
    }

运行结果：

注解的值：类上描述和当前类为Person
方法println有使用Decription注解，且
注解的值：方法上描述和当前方法为println
方法main没有使用Decription注解
方法getName没有使用Decription注解
方法setName没有使用Decription注解
方法setPhone没有使用Decription注解
方法getPhone没有使用Decription注解
方法setAge没有使用Decription注解
方法getAge没有使用Decription注解
方法wait没有使用Decription注解
方法wait没有使用Decription注解
方法wait没有使用Decription注解
方法equals没有使用Decription注解
方法toString没有使用Decription注解
方法hashCode没有使用Decription注解
方法getClass没有使用Decription注解
方法notify没有使用Decription注解
方法notifyAll没有使用Decription注解