第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

基于注解的单元测试