注解小结

注解（也被称为元数据，描述数据的数据）是在Java SE5中被引入的一项技术，与类、接口、枚举处于同一层次，也将被编译成class文件。

一、注解的作用

1、替代配置文件完成对某些功能的描述，减少程序配置；

2、保持代码清晰易读及编译期类型检查；

3、学习注解方便对开源代码的解读。

二、内置注解

Java SE5内置了以下三种标准注解，定义在java.lang中：

@Override，表示当前方法的定义将覆盖超类中的方法，如果被标记的类并没有实际覆盖超类，则编译器会发出错误警告。

@Deprecated，表示当前方法不应该再使用，当编程人员使用这些被标记的方法时，编译器会发出警告信息。

@SupperessWarnings，表示编译器将忽略特定的警告信息，此注解常用的参数值有：deprecation(忽略使用过时类或者方法)，unchecked(忽略执行了未检查装换时警告) ， fallthrough(忽略switch直接指向到下一个case块没有break警告)，path(忽略类路径，源文件路径中有不存在路径时警告)，serial(忽略可序列化类中没有serialVersionUID时的警告)，finally(任何finally不能正常执行时的警告)，all(以上所有)。

三、元注解

元注解的作用是负责注解其他注解，Java SE5内置了四种元注解：

@Target	表示该注解可以用于什么地方，可能的ElementType参数包括： CONSTRUCTOR：构造器的声明 FIELD：域声明（包括enum实例） LOCAL_VARIABLE：局部变量声明 METHOD：方法声明 PACKAGE：包声明 PARAMETER：参数声明 TYPE：类、接口（包括注解类型）或enum声明
@Retention	表示需要在什么级别保存该注解信息。可选的RetentionPolicy参数包括： SOURCE：注解存在于源代码中，编译时会被丢弃 CLASS：注解在class文件中可用，但会被VM丢弃 RUNTIME：VM在运行时也将保留注解，因此可以通过反射机制读取注解的信息
@Documented	将此注解包含在Javadoc中
@Inherited	允许子类继承父类中的注解

四、自定义注解

下面一段代码摘自于《Java编程思想（第4版）》，描述了注解的定义及使用：

//:annotation/UseCase.java
import java.lang.annotation.*;
//该注解可以作用于方法
@Target(ElementType.METHOD)
//JVM会读取注解，所以利用反射可以获得注解
@Retention(RetentionPolicy.RUNTIME)
public @interface UseCase{
    //定义成员变量
    //成员变量可以通过default指定默认值
    //如果成员变量不指定默认值的情况下，在引用接口时则必须给没有默认值的成员变量赋值
    public int id();
    public String description() default "no description";
}

//:annotations/PasswordUtils.java
//注解的元素在使用时表现为键-值对的形式，其中键为方法名称，值类型为方法返回类型，并且需要置于@UseCase声明之后的括号内
//注解元素可用的类型有：所有基本类型（int，float，boolean等）、String、Class、enum、Annotation、以上类型的数组
import java.util.*;
public class PasswordUtils{
    @UseCase(id=47,description="Passwords must contain at least one numeric")
    public boolean validatePassword(String password){
        return (password.matches("\w*\d\w*"));
    }
    @UseCase(id=48)
    public String encryptPassword(){
        return new StringBuilder(password).reverse().toString();
    }
    @UseCase(id=49,description="")
    public boolean checkForNewPassword(List<String> prevPasswords,String password){
        return !prevPasswords.contains(password);
    }
}

注意：非基本类型的注解元素的值不可为null，这个约束使得处理器很难表现一个元素的存在或缺失的状态，使用空字符串或负数作为默认值是一种常用的做法。

五、注解处理器

如果不能解析注解，那注解也不会比注释更有用。在使用注解的过程中，注解处理器就是用来解析注解的重要工具。下面是一个简单注解处理器，用来读取PasswordUtils类，使用反射机制查找@UseCase标记，列出在PasswordUtils中找到的用例以及缺失的用例。

//: annotations/UseCaseTracker.java
//getDeclaredMethods和getAnnotation为反射方法，都属于AnnotatedElement接口（Class、Method和Field都实现了该接口）

import java.lang.reflect.*;
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:useCase){
            System.out.println("Warning:Missing use case-"+i);
        }
    }
    public static void main(){
        List<Integer> useCases=new ArrayList<Integer>();
        Collections.addAll(useCase,47,48,49,50);
        trackUseCases(useCases,PassordUtils.class);
    }
    /*Output:
    Found Use Case:47 Passwords must contain at least one numeric
    Found Use Case:48 no description
    Found Use Case:49 New passowords can't equal previously used ones
    */
}