Annotation学习

一.Annotation类型

2SE5.0版本在 java.lang.annotation提供了四种元注解，专门注解其他的注解：

@Documented –注解是否将包含在JavaDoc中
@Retention –什么时候使用该注解
@Target? –注解用于什么地方
@Inherited – 是否允许子类继承该注解

@Documented–一个简单的Annotations标记注解，表示是否将注解信息添加在java文档中。

@Retention– 定义该注解的生命周期。

RetentionPolicy.SOURCE – 在编译阶段丢弃。这些注解在编译结束之后就不再有任何意义，所以它们不会写入字节码。@Override, @SuppressWarnings都属于这类注解。

RetentionPolicy.CLASS – 在类加载的时候丢弃。在字节码文件的处理中有用。注解默认使用这种方式。

RetentionPolicy.RUNTIME– 始终不会丢弃，运行期也保留该注解，因此可以使用反射机制读取该注解的信息。我们自定义的注解通常使用这种方式

@Target – 表示该注解用于什么地方。如果不明确指出，该注解可以放在任何地方。以下是一些可用的参数。需要说明的是：属性的注解是兼容的，如果你想给7个属性都添加注解，仅仅排除一个属性，那么你需要在定义target包含所有的属性。

ElementType.TYPE:用于描述类、接口或enum声明
ElementType.FIELD:用于描述实例变量
ElementType.METHOD
ElementType.PARAMETER
ElementType.CONSTRUCTOR
ElementType.LOCAL_VARIABLE
ElementType.ANNOTATION_TYPE 另一个注释
ElementType.PACKAGE 用于记录java文件的package信息

@Inherited – 定义该注释和子类的关系

二、示例

package com.shen.test.other;

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

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface CfgAnnotationByField {

    String title() default "默认标题";

    String description() default "描述缺失";

}

package com.shen.test.other;

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

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface CfgAnnotationByMethod {

    boolean save() default false;

}

package com.shen.test.other;

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

public class AnnotationTest {

    @CfgAnnotationByField(title = "张三")
    public String name;

    @CfgAnnotationByMethod(save = true)
    public void testAnnotationMethod(String title, String desc) {
        System.out.println("保存标题：" + title + ",描述：" + desc);
    }

    public static void main(String[] args) throws NoSuchFieldException, SecurityException, NoSuchMethodException {

        Annotation[] anArray = AnnotationTest.class.getField("name").getAnnotations();

        CfgAnnotationByField name = (CfgAnnotationByField) anArray[0];
        System.out.println("======== 根据Field =======");
        System.out.println("name标题：" + name.title());
        System.out.println("name描述：" + name.description());
        System.out.println("======== 根据Method =======");
        Method[] anArrayByMethod = AnnotationTest.class.getMethods();
        for (Method method : anArrayByMethod) {
            CfgAnnotationByMethod anMethod = method.getAnnotation(CfgAnnotationByMethod.class);
            if (anMethod != null && anMethod.save()) {
                System.out.println("测试save方法");
            }
        }

    }
}