一、JSR 269 简介

Java Specification Request (JSR) 269，也称为“Pluggable Annotation Processing API”，是Java平台的一个重要特性。它定义了一个标准API，允许开发人员在编译期间处理注解（Annotations），从而实现元编程和代码生成等高级功能。通过JSR 269，开发者可以创建自定义注解，并编写处理器来处理这些注解，根据注解的信息动态生成新的源代码或字节码。

二、JSR 269 的工作原理

1. 注解处理器注册与执行： 开发者需创建一个实现了javax.annotation.processing.Processor接口的类，该类即为注解处理器。然后，在项目的META-INF/services/javax.annotation.processing.Processor文件中声明这个处理器类，这样当Java编译器（javac）运行时，会自动发现并执行这些处理器。
2. 处理注解与生成源代码： 在注解处理器中，通过重写process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv)方法，可以获取到当前轮次所有使用了指定注解的元素及其上下文环境。在此方法内，可以根据注解信息分析元素，进而生成新的Java源文件或者修改现有类的结构。

三、@AutoToString示例

以下是一个简单的JSR 269注解处理器示例，用于自动生成对象的toString()方法：

首先，我们创建一个名为@AutoToString的注解：

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

@Retention(RetentionPolicy.SOURCE)
@Target(ElementType.TYPE)
public @interface AutoToString {
    // 可以定义注解属性，如是否包含字段名等
}

接下来，我们编写一个处理@AutoToString注解的处理器：

import javax.annotation.processing.*;
import javax.lang.model.SourceVersion;
import javax.lang.model.element.TypeElement;
import javax.tools.Diagnostic;
import java.util.Set;

@SupportedAnnotationTypes("com.example.AutoToString")
@SupportedSourceVersion(SourceVersion.RELEASE_8)		// 标注JDK版本，这里使用JDK 8
public class ToStringProcessor extends AbstractProcessor {

    @Override
    public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {
        for (TypeElement annotation : annotations) {
            Set<? extends Element> annotatedElements = roundEnv.getElementsAnnotatedWith(annotation);
            for (Element element : annotatedElements) {
                try {
                    // 分析被注解的类并生成toString()方法的源代码
                    String toStringCode = generateToString(element);
                    // 将生成的源代码写入到一个新的Java文件中
                    writeSourceFile(toStringCode, element);
                } catch (Exception e) {
                    processingEnv.getMessager().printMessage(Diagnostic.Kind.ERROR, "Failed to generate toString(): " + e.getMessage());
                }
            }
        }
        return true; // 表示已处理了注解
    }

    // 实现generateToString和writeSourceFile方法，这里省略具体实现细节
}

在实际应用中，generateToString()方法会遍历类的所有字段，生成一个字符串形式的表示，而writeSourceFile()方法则负责将生成的toString()方法源码写入到对应的Java源文件中。

通过这种方式，只需在目标类上添加@AutoToString注解，编译过程中就会自动生成一个合适的toString()方法，极大地提高了开发效率。