[转]java注解与APT技术

 

下面是一个简单的自定义注解的栗子：

package annotation;

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

/**
 * 动物名称注解
 *
 */
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface AnimalName {
    String value() default "";
}

定义了注解，并在需要的时候给相关类，类属性加上注解信息，如果没有响应的注解信息处理流程，注解可以说是没有实用价值，接下来要介绍的是java的APT(Annotation Process Tool)技术，用于处理自定义注解。

2，APT技术

APT(Annotation Process Tool)，是一种在代码编译时处理注解，按照一定的规则，生成相应的java文件，多用于对自定义注解的处理，目前比较流行的Dagger2, ButterKnife, EventBus3都是采用APT技术，对运行时的性能影响很小。我们通过自定义注解的方式，来了解一下如何使用APT：

1，自定义注解：

@Target({ElementType.TYPE})   ---作用范围 Class

@Retention(RetentionPolicy.CLASS)  ---生命周期：仅保留到.class文件

public @interface Route {
    /** Path of route*/
    String value();  ---类似于成员变量
}

2，使用方式

@Route(path = "/test/activity2")
public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_test2);
    }
}

JVM默认只会处理@override等语言自带的注解，对于自定义的注解，需要我们自己处理，java提供了一个名为AbstractProcessor.java的抽象类，我们只要继承该类，就实现自己的注解处理器，来处理自定义的@Route注解

public class RouteProcessor extends AbstractProcessor {

    @Override
    public synchronized void init(ProcessingEnvironment env){ 
        // 主要做一些初始化操作
    }

    @Override
        public boolean process(Set<? extends TypeElement> annoations, RoundEnvironment env) { 
        //具体处理注解的逻辑，控制代码的生成
        processAnnotations();
    }

    @Override
    public Set<String> getSupportedAnnotationTypes() { 
       // 支持处理的注解类型, 在这里就是@Route

    }

    @Override
    public SourceVersion getSupportedSourceVersion() {
      //java版本 如：jdk1.6or jdk1.7
   }

}

---

3，自定义Processor

@AutoService(Processor.class)
public class HelloProcessor extends AbstractProcessor {

    /** 文件相关的辅助类 用于生成新的源文件、class等 */
    private Filer mFiler;

    @Override
    public synchronized void init(ProcessingEnvironment processingEnv) {
        super.init(processingEnv);
        mFiler = processingEnv.getFiler();
    }

    @Override
    public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {

        // 构建方法 此处使用到了square公司的javapoet库，用来辅助生成 类的代码
        MethodSpec.Builder methodBuilder = MethodSpec.methodBuilder("show")
                .addModifiers(Modifier.PUBLIC);
        methodBuilder.addStatement("String test = "$N" ","hello annotation world!");

        /** 构建类 */
        TypeSpec finderClass = TypeSpec.classBuilder("Hello$$Inject")
                .addModifiers(Modifier.PUBLIC)
                .addMethod(methodBuilder.build())
                .build();
        try {
            JavaFile.builder("com.win.test",finderClass).build().writeTo(mFiler);
        } catch (IOException e) {
            e.printStackTrace();
        }
        return true;
    }

    // 支持的注解类型
    @Override
    public Set<String> getSupportedAnnotationTypes() {
        Set<String> types = new LinkedHashSet<>();
        types.add(Hello.class.getCanonicalName());
        return types;
    }

    @Override
    public SourceVersion getSupportedSourceVersion() {
        return super.getSupportedSourceVersion();
    }
}

在AS工程中使用

@Hello("MainTest")   //自定义的Hello注解
public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
}

在项目App module的build目录下，便会生成对应的java类文件:

这个只是简单的栗子，我们可以在process()方法中，加入更多的业务逻辑，以实现特定功能。