Java 注解

Java 注解

注解，也被称为元数据，为我们在代码中添加信息提供了一种形式化的方法，使我们在稍后的某个时刻非常方便的使用这些数据。 
Java SE内置了三种定义在java.lang中的注解：

@Override,表示当前方法定义将覆盖超类中的方法。   

@Deprecated,如果程序员使用了注解为它的元素，那么编译器发出警告信息。   

@SuppressWarning,关闭不当的编译器警告信息。

Java另外还提供了4种元注解（meta-annotation），负责新注解的创建：

@Target 表示该注解可以用于什么地方。   

可能的ElementType包括：CONSTRUCTOR(构造器声明)，FIELD（域声明包括enum实例），LOCAL_VARIABLE(局部变量声明)，METHOD（方法声明），PACKAGE（包声明），PARAMETER（参数声明），TYPE（类，接口或enum声明）。

@Retention 表示需要在什么级别保存该注解信息。   

可选的RententionPolicy参数包括：SOURCE(注解将被编译器丢弃)，CLASS（注解在class文件中可用，JVM丢弃），RUNTIME（CM在运行期也保留，可以通过反射读取注解信息）。

@Documented 将该注解包含在Javadoc中。

@Inherited  允许子类继承父类中的注解。

定义注解

下面是一个简单的注解，用于跟踪一个项目中的用例。RD可以在实现的测试用例上添加该注解@UseCase

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

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

注解处理器

如下程序实现了一个简单的注解处理器，使用反射来查找@UseCase标记。该程序用到了两个反射方法：getDeclaredMethods()和getAnnotaion()，它们都属于AnnotatedElement接口（Class，Method和Field等类都实现了该接口）。

import java.lang.reflect.Method;

public class UseCaseTracker {

    public static void track(Class<?> cl){
        for (Method m : cl.getDeclaredMethods()) {
            UseCase uc = m.getAnnotation(UseCase.class);
            if(uc!=null) {
                System.out.println("Found useCase:" + uc.id() + " " + uc.description());
            }
        }
    }

    public static void main(String[] args) {
        UseCaseTracker.track(PasswordUtilTest.class);
    }
}

注解元素使用

import org.junit.Assert;
import org.junit.Test;

public class PasswordUtilTest {

    @Test
    @UseCase(id=5,description="密码校验，密码至少包含1个数字")
    public void testPassword() {
        String password = "aab123";
        Assert.assertTrue(PassswordUtils.validate(password));       
    }

    @Test
    @UseCase(id=10,description="用于统计用例个数")
    public void testTrack() {
        UseCaseTracker.track(PasswordUtilTest.class);
    }

}