一小时搞明白注解处理器(AnnotationProcessorTool)教程.doc

一小时搞明白注解处理器（Annotation Processor Tool） 什么是注解处理器？ 注解处理器是（Annotation Processor）是javac的一个工具，用来在编译时扫描和编译和处理注解（Annotation）。你可以自己定义注解和注解处理器去搞一些事情。一个注解处理器它以Java代码或者（编译过的字节码）作为输入，生成文件（通常是java文件）。这些生成的java文件不能修改，并且会同其手动编写的java代码一样会被javac编译。看到这里加上之前理解，应该明白大概的过程了，就是把标记了注解的类，变量等作为输入内容，经过注解处理器处理，生成想要生成的java代码。 处理器AbstractProcessor 处理器的写法有固定的套路，继承AbstractProcessor。如下： [java] view plain copy 在CODE上查看代码片派生到我的代码片 public class MyProcessor extends AbstractProcessor { @Override public synchronized void init(ProcessingEnvironment processingEnv) { super.init(processingEnv); } @Override public SetString getSupportedAnnotationTypes() { return null; } @Override public SourceVersion getSupportedSourceVersion() { return SourceVersion.latestSupported(); } @Override public boolean process(Set? extends TypeElement annotations, RoundEnvironment roundEnv) { return true; } } init(ProcessingEnvironment processingEnv) 被注解处理工具调用，参数ProcessingEnvironment 提供了Element，Filer，Messager等工具 getSupportedAnnotationTypes() 指定注解处理器是注册给那一个注解的，它是一个字符串的集合，意味着可以支持多个类型的注解，并且字符串是合法全名。 getSupportedSourceVersion 指定Java版本 process(Set? extends TypeElement annotations, RoundEnvironment roundEnv) 这个也是最主要的，在这里扫描和处理你的注解并生成Java代码，信息都在参数RoundEnvironment 里了，后面会介绍。 在Java7 中还可以使用 [java] view plain copy 在CODE上查看代码片派生到我的代码片 @SupportedSourceVersion(SourceVersion.latestSupported()) @SupportedAnnotationTypes({ // 合法注解全名的集合 }) 代替 getSupportedSourceVersion() 和 getSupportedAnnotationType() ,没毛病，还可以在注解处理离器中使用注解。 注册注解处理器 打包注解处理器的时候需要一个特殊的文件 cessing.Processor 在 META-INF/services 路径下 [plain] view plain copy 在CODE上查看代码片派生到我的代码片 －－myprcessor.jar －－－－com －－－－－－example －－－－－－－－MyProcessor.class －－－－META-INF －－－－－－services －－－－－－－－cessing.Processor 打包进cessing.Processor的内容是处理器的合法全称，多个处理器之间换行。 [plain] view plain copy 在CODE上查看代码片派生到我的代码片 com.example.myprocess.MyProcessorA com.exa