使我们在代码中添加信息提供了一种形式化的方法,是我们在稍后时刻非常方便地使用这些数据。可以在编译时使用,也可以在运行时使用。
基本语法
怎么使用,我们应该很熟悉。假设有个已经定义好的注解 @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