第20章 Annotation

使我们在代码中添加信息提供了一种形式化的方法，是我们在稍后时刻非常方便地使用这些数据。可以在编译时使用，也可以在运行时使用。

基本语法
怎么使用，我们应该很熟悉。假设有个已经定义好的注解 @Test：

package annotations;
import net.mindview.atunit.*;
public class Testable {
    public void execute() {
        System.out.pringln("");
    }
    @Test
    void testExecute() {
    }
}

以上代码中，使用@ Test 对testExecute() 进行了注解。该注解可以在作为特殊信息辨识出来，以作进一步的处理。
定义注解
@Test 定义：

package net.mindview.atunit;

import java.lang.annotation.*;

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

上面是一个没有元素的注解，称为标记注解。

含有元素的注解定义：

import java.lang.annotation;
@Target(ElementType.METHOD)
@Rentention(RetentionPolicy.RUNTIME)
public @interface UseCase {
    public int id();
    public String description() default "no description";
}

使用：

import java.util.*;
public class PasswordUtils {
    @UserCase(id=47, description="Password must contains at least one numeric")
    public boolean validatePassword(String password) {
        return (password.matches("\\w*\\d\\w*"));
    }
}

元注解
负责注解其他注解 
@Target 
@Retention 
@Documeted 
@Inheited

编写注解处理器
编写注解处理器：
import java.lang.reflect.*;
import java.util.*;
public class UseCaseTracker {
    public static void trackUseCases(Class<> cl) {
        for (Method m : cl.getDeclaredMethods()) {
            UseCase uc = m.getAnnotation(UseCase.class);
            if (us != null) {
                System.out.println("Found use case: " + uc.id() + ", " + uc.description());
            }
        }
    }
    public void static main(String args[]) {
        trackUseCases(PasswordUtils.class);
    }
}

使用apt处理注解
将观察者模式用于apt