Java 注解和反射

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

注解使得我们能够以将由编译器来测试和验证的格式，存储有关程序的额外信息。注解可以用来生成描述符文件，甚至或是新的类定义，并且有助于减轻编写“样板”代码的负担。

@Target ：表示注解可以用于什么地方。可能的ElementType参数包括：

CONSTRUCTOR:构造器声明
FIELD: 域声明
LOCAL_VARIABLE:局部变量声明
METHOD：方法声明
PACKAGE: 包声明
PARAMETER: 参数声明
TYPE：类，接口（包括注解类型）或enum声明

@Retention 表示需要在什么级别保存该注解信息。可选的RetentionPolicy参数有：

SOURCE: 注解只保留在源文件，当java文件编译成class文件的时候，注解被遗弃
CLASS:注解被保留到class文件，但当jvm加载class文件时候被遗弃
RUNTIME:注解不仅被保存到class文件中，jvm加载class文件之后，仍然存在。
这3个生命周期分别对应于：java源文件（.java文件）--->.class文件--->内存中的字节码
那怎么来选择合适的注解生命周期呢
首先要明确生命周期长度 SOURCE< CLASS < RUNTIME
一般如果需要在运行时去动态获取注解信息，那只能用RUNTIME注解，比如@Deprecated使用RUNTIME注解。
如果要在编译时进行一些预处理操作，比如生成一些辅助代码（ButterKnife）就用CLASS 注解。
如果只做一些检查性操作 比如@Override 和@ SuppressWarning，使用Source注解

代码示例：

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 "no description";
}

import java.util.*;

public class PasswordUtils {

    @UseCase(id=47,description = "Password must contain at least one number")
    public boolean validatePassword(String password){

        return (password.matches("\\w*\\d\\w*"));
    }

    @UseCase(id=48)
    public String encryptPassword(String password){//反转
        return new StringBuilder(password).reverse().toString();
    }

    @UseCase(id=49,description = "New passwords can't equal previously used ones")
    public boolean checkForNewPassword(List<String> prePasswords,String password){
        return !prePasswords.contains(password);
    }



}

import java.lang.reflect.Method;
import java.util.*;
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<>();
        Collections.addAll(useCases,47 ,48 ,49 ,50 );
        trackUseCases(useCases,PasswordUtils.class);
    }
}

运行结果：

image.png