标签：忽略 enc turn 获得 target logs idt struct 自定义
注解（也被称为元数据，描述数据的数据）是在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 */ }
标签：忽略 enc turn 获得 target logs idt struct 自定义
原文地址：http://www.cnblogs.com/aaron-shu/p/7442126.html
