《Thanking in Java》20. 注解

注解，也称为元数据，为我们再代码中添加信息提供了一种形式化的方法，使我们可以在稍后某个时刻非常方便地使用这些数据。

注解使得我们能够以将由编译器来测试和验证的格式，存储有关程序的额外信息。

java内置的三种注解：
@Override，表示当前的方法定义将覆盖超类中的方法。如果你不小心拼写错误，或者方法签名对不上被覆盖的方法，编译器就会发出错误提示。
@Deprecated，如果程序员使用了注解为它的元素，那么编译器会发出警告信息。
@SuppressWarnings，关闭不当的编译器警告信息

每当创建描述符性质的类或接口时，一旦其中包含了重复性的工作，那就可以考虑使用注解来简化与自动化该过程。

20.1 基本语法

与java接口一样，注解也将会编译成class文件

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

定义注解时，会需要一些元注解，如@Target和@Retention，@Target用来定义注解应用在什么地方，例如是一个方法或者一个域。@Retention用来定义该注解在哪一个级别可用，在源代码中，类文件中还是运行时。

注解的元素看起来就像接口的方法，唯一的区别是你可以为其制定默认值。没有元素的注解称为标记注解。

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface UseCase {
    public int id();
    public String description() default "no description";
}

20.2 编写注解处理器

在使用注解的过程中，很重要的一个部分就是创建与使用注解处理器。

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);
    }
}

利用反射获取使用注解对象的方法，然后调用id()和description()方法返回注解中定义的元素值。

注解元素可用的类型：
所以基本类型、String、Class、enum、Annotation、以上类型的数组。

元素不能有不确定的值，要么具有默认值，要么在使用注解时提供元素的值。对于非基本类型的元素，无论是在源代码中声明时，或是在注解接口中定义默认值是，都不能以null作为其值。为了绕开这个约束，只能定义一些特殊的值，例如空字符串或负数，以此表示某个元素不存在

假设希望提供一些基本的对象/关系映射功能，能够自动生成数据库表，用以存储javabean对象，使用注解的话，可以将所有信息都保存在javabean源文件中。

注解不支持继承。