使用 Ant 进行 Java 6 注解处理配置

Question

我有一个自定义注释及其处理器和处理器工厂。如何配置我的 Ant 构建文件，以便：

1. 注释处理器应用于带注释的类并在“gen”文件夹内生成源文件

2. 生成的源文件（来自注释处理）可以被项目中的其他源文件使用。

Answer 1

这并不漂亮，但这就是我所做的。 （来源 javac ant 任务 javac 手册页) 使用compilerarg 属性我可以传入与注释处理相关的参数，这些参数不是直接的由 javac ant 任务支持。

<javac srcdir="${src}" destdir="${classes}" ... > 
     ....
     <compilerarg line="-processorpath ${processorpath}"/>
     <compilerarg line="-processor ${processor}"/>
     <compilerarg line="-s ${whereToPutGeneratedClassFiles}"/>
</javac>

我不使用 APT 工具，因为文档指出

请注意，Apt 工具似乎确实是 JDK 框架的不稳定部分，因此在未来版本中可能会发生根本性变化。特别是它在 JDK 6 中可能已过时，JDK 6 可以将注释处理器作为 javac 的一部分运行。

如果你真的不关心编译器参数，你可以像这样打包你的注释处理器

<jar destfile="${annotationprocessorjar}" ... >
     ...
     <service type="javax.annotation.processing.Processor" provider="${your.annotation.processor.fully.qualified.name}"/>
</jar>

然后你可以这样做

 <javac ... make sure ${annotationprocessorjar} is in classpath>
 </javac>

Answer 2

我发现其他一些示例有点令人困惑，因为某些关键位是无法解释的变量。这就是我最终得到的结果：

构建处理器 jar：

<target name="build-aux">
    <mkdir dir="${build.dir}" />
    <mkdir dir="${build.classes}" />
    <javac destdir="${build.classes}" source="1.6" target="1.6">
        <src path="${src.java}" />
        <include name="com/acme/cli/Program.java" />
        <include name="com/acme/cli/ProgramProcessor.java" />
    </javac>

    <jar jarfile="acme-aux.jar" update="true">
        <manifest>
            <attribute name="Main-Class" value="${main.class}" />
            <attribute name="Implementation-Title" value="acme-aux" />
            <attribute name="Implementation-Version" value="${version}" />
            <attribute name="Implementation-Vendor" value="ACME, Inc" />
            <attribute name="Built-By" value="${user.name}" />
            <attribute name="Build-Date" value="${TODAY}" />
        </manifest>
        <fileset dir="${build.classes}">
            <!-- the annotation -->
            <include name="com/acme/cli/Program.class" />
            <!-- the annotation processor -->
            <include name="com/acme/cli/ProgramProcessor.class" />
        </fileset>
        <service type="javax.annotation.processing.Processor"
            provider="com.acme.cli.ProgramProcessor" />
    </jar>
</target>

然后编译代码并运行处理器：

<target name="compile" depends="generate,build-aux">
    <mkdir dir="${build.dir}" />
    <mkdir dir="${build.classes}" />
    <javac destdir="${build.classes}" source="1.6" target="1.6">
        <src path="${src.java}" />
        <include name="com/acme/**/*.java" />
        <!-- ensure that "acme-aux.jar" is in this classpath -->
        <classpath refid="compile.class.path"/>
         <!-- pass option to annotation processor -->
        <compilerarg value="-Aacme.version=${version}" />
    </javac>
</target>

Answer 3

以下是我在 eclipse/ant 中的做法：

<javac destdir="bin"
  debug="true"
  debuglevel="${debuglevel}"
  compiler="javac1.6"
  srcdir="${src}">
       <include name="**/*.java"/> <!-- I just do it this way -->
 <classpath refid="classpath_ref_id"/>
 <compilerarg value="-processor" />
 <compilerarg value="${processor}" />
 <compilerarg value="-s" />
 <compilerarg value="${gen_src_target}" />
</javac>

注释

• 处理器路径包含在 *classpath_ref_id* 中
• 之前运行您的处理器
  编译实际代码（使用或
  没有生成的代码）。

Answer 4

你可以看看注释处理工具
，它会自动编译生成的源文件

//编辑//
回复您的评论：

您可以将 apt 与 apt ant 任务结合使用

但从 jdk6 开始，javac 工具提供 直接支持注释处理，因此您应该能够使用 javac ant 任务 编译器属性指定为“javac1.6”