Think in java笔记: Annotation

Think in java笔记: Annotation

1. Annotation是什么?
   Annotation是一种元数据信息，很奇怪的想起来了AspectJ的AOP，就是在方法、package等元素上加上一些标记，然后再自定负责自己的annotation，实现功能。和interface差不多，但是可以有默认值。

2. 如何定义一个annotation

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

   定义annotation还需要meta-annotation:@target和@Retention

   • @target:定义在哪使用这个annotation(比如说成员变量或方法)
   • @Rentention:定义什么时候可用，SOURCE 还是CLASS, 还是RUNTIME。

   这样不包含任何element的annotation，被称为marker annotation.

3. Meta-annotations

   name Description @Target 可以使用的ElementType类中的变量 @Rentention annotation信息保留多久，具体的类在RetentionPolicy @Documented 在javadocs中包含此annotation的信息 @Inherited 允许所有子类继承它们的父annotation

4. annotation processors(annotation执行)
   如果没有工具来读取annotation，annotations几乎就和评论就一样。一个重要的部分就是创建和使用annotation processors. Java提供了反射的方法来实现annotation processors.还提供了apt用来解析source code.

   public class UseCaseTracker {    public static void trackUseCases(List<Integer> useCases, Class<?> cl){        for(Method m : cl.getDeclaredMethods()){            UseCase uc = m.getAnnotation(UseCase.class);            if(uc != null){                System.out.println("Found Use Case:" + uc.id() + " " + uc.description());                useCases.remove(new Integer(uc.id()));            }        }        for(int i : useCases){            System.out.println("Warning: Missing use case-" + i);        }    }    public static void main(String[] args) {        List<Integer> useCases = new ArrayList<Integer>();        Collections.addAll(useCases, 47, 48, 49, 50);        trackUseCases(useCases, PasswordUtils.class);    }}

5. Annotation Value限制

   • compiler对value有限制要求的。没有任何Element可以拥有一个没有指定的value。这意味着elements元素必须拥有默认值或者使用的时候赋值。
   • 任何基本类型必须赋值，不能使用null。意味着defaut或者赋值的时候，就必须使用一个确定的值。