Maven 3-如何添加批注处理器依赖？

我需要对我的项目源代码运行批注处理器。批注处理器不应成为项目的可传递依赖项，因为它只用于批注处理而不需要其他任何东西。

以下是我为此使用的完整(非工作)测试POM：

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>test</groupId>
  <artifactId>test</artifactId>
  <packaging>jar</packaging>
  <version>1.0-SNAPSHOT</version>
  <name>Test annotations</name>
  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <hibernate-jpamodelgen.version>1.2.0.Final</hibernate-jpamodelgen.version>
  </properties>
  <dependencies>
    <dependency>
      <groupId>javax</groupId>
      <artifactId>javaee-api</artifactId>
      <version>6.0</version>
      <scope>provided</scope>
    </dependency>
  </dependencies>
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.0</version>
        <configuration>
          <annotationProcessors>
            <annotationProcessor>
              org.hibernate.jpamodelgen.JPAMetaModelEntityProcessor</annotationProcessor>
          </annotationProcessors>
          <debug>true</debug>
          <optimize>true</optimize>
          <source>1.6</source>
          <target>1.6</target>
          <compilerArguments>
            <AaddGeneratedAnnotation>true</AaddGeneratedAnnotation>
            <Adebug>true</Adebug>
          </compilerArguments>
        </configuration>
        <dependencies>
          <dependency>
            <groupId>org.hibernate</groupId>
            <artifactId>hibernate-jpamodelgen</artifactId>
            <version>${hibernate-jpamodelgen.version}</version>
          </dependency>
        </dependencies>
      </plugin>
    </plugins>
  </build>
</project>

我在测试的插件配置中将org.hibernate.jpamodelgen.JPAMetaModelEntityProcessor显式定义为批注处理器，我知道它不应该是必需的。

我遇到的问题是hibernate-jpamodelgen依赖项未添加到编译器类路径，因此找不到批注处理器，构建失败。

按照这个answer，我尝试将依赖项添加为构建扩展(不确定我是否理解它们应该是什么！)如下所示：

<extensions>
  <extension>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-jpamodelgen</artifactId>
    <version>${hibernate-jpamodelgen.version}</version>
  </extension>
</extensions>

这也不会将hibernate-jpamodelgen添加到编译器类路径。

到目前为止，我发现唯一有效的方法是将依赖项添加到<dependencies>部分中的项目中。这有一个不幸的副作用，那就是添加hibernate-jpamodelgen作为传递依赖项，这是我想要避免的。

我之前的工作设置使用maven-processor-plugin插件来实现我想要的功能。然而，eclipse M2E不支持该插件，并且最新版本的maven-compiler-plugin现在可以正确处理多个编译器参数，所以我更喜欢使用后者。

---

解决方案

添加依赖项为optional dependency(<optional>true</optional>)。这将在编译下添加依赖项，但会阻止它成为可传递依赖项：

<dependency>
  <groupId>org.hibernate</groupId>
  <artifactId>hibernate-jpamodelgen</artifactId>
  <version>${hibernate-jpamodelgen.version}</version>
  <optional>true</optional>
</dependency>

如果您要在此模块中创建一个包含所有依赖项的构件(如.war)，则可以使用<scope>provided</scope>。这既防止了依赖项是可传递的，也防止了依赖项包含在模块生成的构件中。