深入annotation

目标：

掌握@Target注释

掌握@Document注释

掌握@inherited注释

 

之前定义的annotation，如果没有明确声明，可以在任何地方使用：

package 类集;

@MyDefaultAnnotationReflect(key="MLDN",value="www.mldnjava.cn")　　--此注释是上一节中定义的
public class SimpleBeanOne{
    @MyDefaultAnnotationReflect(key="MLDN",value="www.mldnjava.cn")
    public String toString(){
        return "Hello LiXingHua!!!" ;
    }
};

如果需要指定其使用范围，必须要使用@Target注释：

@Target

Target注释类型的必须元素如下：

ElementType枚举常量：

现在定义一个annotation，只能在类上使用，类型是Type

import java.lang.annotation.Target ;
import java.lang.annotation.ElementType ;
import java.lang.annotation.Retention ;
import java.lang.annotation.RetentionPolicy ;
@Target({ElementType.TYPE})        // 此注释只能用在类上
@Retention(value=RetentionPolicy.RUNTIME)
public @interface MyTargetAnntation{
    public String key() default "LXH" ;
    public String value() default "李兴华" ;
}

此时在simpleBean的类及方法的声明上使用此annotation。

@MyTargetAnntation(key="MLDN",value="www.mldnjava.cn")
public class SimpleBean{
    @MyTargetAnntation(key="MLDN",value="www.mldnjava.cn")　　--这里会报错，因为上面声明了只能在类中使用。
    public String toString(){
        return "Hello LiXingHua!!!" ;
    }
};

现在如果想在类和方法都能使用，则必须设置多个范围。

import java.lang.annotation.Target ;
import java.lang.annotation.ElementType ;
import java.lang.annotation.Retention ;
import java.lang.annotation.RetentionPolicy ;
@Target({ElementType.TYPE,ElementType.METHOD})        // 此注释只能用在类和方法上
@Retention(value=RetentionPolicy.RUNTIME)
public @interface MyTargetAnntation{
    public String key() default "LXH" ;
    public String value() default "李兴华" ;
}

 

@Document

@Document可以在任何的annotation上使用，所有annotation默认都是使用@Document进行注释的。

而且在生成javadoc的使用可以通过@Document设置一些说明信息。

定义一个@Document的注释：

import java.lang.annotation.Documented ;
@Documented
public @interface MyDocumentedAnntation{
    public String key() default "LXH" ;
    public String value() default "李兴华" ;
}

成功之后，在使用此annotation的时候就可以增加一些信息上去了。

@MyDocumentedAnntation(key="MLDN",value="www.mldnjava.cn")
public class SimpleBeanDocumented{
    /**
     * 此方法在对象输出时调用，返回对象信息
     */
    @MyDocumentedAnntation(key="MLDN",value="www.mldnjava.cn")
    public String toString(){
        return "Hello LiXingHua!!!" ;
    }
};

之后通过javadoc命令，生成java.doc文档。

打开文档，发现文档的内容把刚定义的类的信息加上去了。

2，

 

@Inhenited注释

此注释表示一个annotation是否可以被继承下来。

package org.lxh.demo16.inheriteddemo ;
import java.lang.annotation.Retention ;
import java.lang.annotation.RetentionPolicy ;
import java.lang.annotation.Documented ;
import java.lang.annotation.Inherited ;
@Documented
@Inherited
@Retention(value=RetentionPolicy.RUNTIME)
public @interface MyInheritedAnnotation{
    public String name() ;

}

定义一个父类，在父类使用此annotation。

package org.lxh.demo16.inheriteddemo ;
@MyInheritedAnnotation(name="李兴华")
public class Person{
};

定义子类

package org.lxh.demo16.inheriteddemo ;
public class Student extends Person{
};

按照所解释：使用的inherited声明的annotation是可以被子类继承下来的。用反射来检验一下：

import java.lang.annotation.Annotation ;
import org.lxh.demo16.inheriteddemo.MyInheritedAnnotation ;//注意，要把这个annotation包也导入。
public class ReflectInheritedDemo{
    public static void main(String args[]) throws Exception{
        Class<?> c = null ;
        c = Class.forName("org.lxh.demo16.inheriteddemo.Student") ;
        Annotation ann[] = c.getAnnotations() ;    // 取得全部的Annotation
        for(Annotation a:ann){    // 输出
            System.out.println(a) ;
        }
        // 继续取得此Annotation设置的内容，这里前面讲过
        if(c.isAnnotationPresent(MyInheritedAnnotation.class)){　　//是否包含这种annotation。
            MyInheritedAnnotation mda = null ;
            mda = c.getAnnotation(MyInheritedAnnotation.class) ;//获取C这个class对象里面的这个annotation对象，
            String name = mda.name() ;    // 取出name的内容
            System.out.println("name = " + name) ;
        }
    }
}

输出结果：

 

总结：

1,熟悉Document注释的作用。加入说明信息。

2，属性Target作用，并使用Target注释指定注释的使用位置。

3，如果一个annotation要想被子类继承下来，则使用inherited注释说明。

4，反射机制对于操作annotation是最重要的。