包 java.lang.annotation 中包含所有定义自定义注解所需用到的原注解和接口。 如接口 java.lang.annotation.Annotation 是所有注解继承的接口,并且是自动继承,不需要定义时指定,类似于所有类都自动继承Object。 该包同时定义了四个元注解,Documented,Inherited,Target(作用范围,方法,属性,构造方法等),Retention(生命范围,源代码,class,runtime)。
@Target 表示该注解用于什么地方,可能的值在枚举类 ElemenetType 中,包括: ElemenetType.CONSTRUCTOR—————————-构造器声明 ElemenetType.FIELD ————————————–域声明(包括 enum 实例) ElemenetType.LOCAL_VARIABLE————————- 局部变量声明 ElemenetType.METHOD ———————————-方法声明 ElemenetType.PACKAGE ——————————— 包声明 ElemenetType.PARAMETER ——————————参数声明 ElemenetType.TYPE————————————— 类,接口(包括注解类型)或enum声明
@Retention 表示在什么级别保存该注解信息。可选的参数值在枚举类型 RetentionPolicy 中,包括: RetentionPolicy.SOURCE ———————————注解将被编译器丢弃 RetentionPolicy.CLASS ———————————–注解在class文件中可用,但会被VM丢弃 RetentionPolicy.RUNTIME VM——-将在运行期也保留注释,因此可以通过反射机制读取注解的信息。
@Documented 将此注解包含在 javadoc 中 ,它代表着此注解会被javadoc工具提取成文档。在doc文档中的内容会因为此注解的信息内容不同而不同。相当与@see,@param 等。
@Inherited 允许子类继承父类中的注解
1.先定义一个能够用在类上的注解
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface MyAnnotation1 {
String value();
}
2.再定义一个能够用在方法上的注解
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface MyAnnotation2 {
String description();
boolean isAnnotation();
}
3.测试类。给类加上MyAnnotation1注解,给方法加上MyAnnotation2注解
@MyAnnotation1("this is annotation1")
public class AnnotationDemo {
@MyAnnotation2(description = "this is annotation2", isAnnotation = true)
public void sayHello() {
System.out.println("hello world!");
}
}
4.测试说明类
public class Annotation {
public static void main(String[] args) throws Exception {
Class<?> cls = Class.forName("annotation.AnnotationDemo");
// 判断AnnotationDemo是否有MyAnnotation1的注解
boolean flag = cls.isAnnotationPresent(MyAnnotation1.class);
if (flag) {
System.out.println("判断类是annotation");
MyAnnotation1 annotation1 = cls.getAnnotation(MyAnnotation1.class);
System.out.println(annotation1.value());
}
Method method = cls.getMethod("sayHello");
// 判断sayHello方法是否有MyAnnotation2的注解
flag = method.isAnnotationPresent(MyAnnotation2.class);
if (flag) {
System.out.println("判断方法也是annotation");
MyAnnotation2 annotation2 = method.getAnnotation(MyAnnotation2.class);
System.out.println(annotation2.description() + "\t" + annotation2.isAnnotation());
}
}
}
5.控制台输出
判断类是annotation
this is annotation1
判断方法也是annotation
this is annotation2 true
Annotation与interface的异同: Annotation类型使用关键字@interface而不是interface。这个关键字声明隐含了一个信息:它是继承了java.lang.annotation.Annotation接口,并非声明了一个interface Annotation类型、方法定义是独特的、受限制的。Annotation 类型的方法必须声明为无参数、无异常抛出的。这些方法定义了annotation的成员:方法名成为了成员名,而方法返回值成为了成员的类型。方法的后面可以使用 default和一个默认数值来声明成员的默认值,null不能作为成员默认值,这与我们在非annotation类型中定义方法有很大不同。 Annotation类型又与接口有着近似之处。它们可以定义常量、静态成员类型(比如枚举类型定义)。Annotation类型也可以如接口一般被实现或者继承。
参考 http://blog.csdn.net/hbcui1984/article/details/4735487 http://www.cnblogs.com/cr330326/p/5695474.html