使用 Maven 从默认的 src/main/resources 位置选择某些资源文件到 WAR 中

Question

我试图控制哪些文件进入由 mvn package 目标创建的 WAR 包。具体来说，我想从每个包的默认 src/main/resources 文件夹中排除一些文件（我正在尝试针对不同的环境进行构建/包）。

我尝试使用 maven-war-plugin 但失败了。如果我添加此配置（用于测试）：

<webResources>
    <resource>
        <directory>src/main/resources</directory>
        <targetPath>WEB-INF/classes</targetPath>
        <excludes>
            <exclude>*.xml</exclude>
        </excludes>
    </resource>
</webResources>

...我的 WEB-INF/classes 仍将包含 XML 文件。这是因为 webResources 参数似乎重复了复制过程（上述配置实际上有效，文件没有被复制......但它们在某些其他进程中被复制） 。

Maven-war-plugin 文档 状态:

所有 Maven 2 项目的默认资源目录是 src/main/resources ，它将最终位于 WAR 中的 target/classes 和 WEB-INF/classes 中。在此过程中将保留目录结构。

WAR 插件还能够通过 webResources 参数包含在默认资源目录中找不到的资源。

这有点令人困惑。这是否意味着：

• webResources 参数是 maven-war-plugin 中的一项功能，允许仅从 src/main/resources 外部包含文件代码> 文件夹？如果是这样，我们如何从 src/main/resources 内部更改复制的文件？
• webResources 参数是 maven-war-plugin 中的一项功能，允许包含来自 src/main/resources 文件夹之外的文件。如果是这样，如何配置才能做到这一点？
• 还有其他选择吗？

Answer 1

我试图控制哪些文件进入由 mvn package goal 创建的 WAR 包。具体来说，我想从每个包的默认 src/main/resources 文件夹中排除一些文件

资源目录 (src/main/resources) 中的资源被复制到构建输出目录 (target/classes) 在 流程资源阶段。然后，在 package 阶段，将 target/classes 的内容打包到分布式存档中，如 WAR，并最终位于 WEB-INF 中在这种情况下，/classes。

因此，如果您想控制哪些资源最终出现在 WEB-INF/classes 中，您需要控制哪些资源最终出现在 target/classes 中，即以某种方式改变绑定到进程的目标的行为-resources 阶段，特别是 Maven 资源插件。

为此，（这可能不直观），您可以在 pom 的 resources 元素内声明 exclude 或 include 元素，如图所示在包含和排除文件和目录中。应用于默认资源目录：

<build>
  <resources>
    <resource>
      <directory>src/main/resources</directory>
      <excludes>
        <exclude>**/*.xml</exclude>
      </excludes>
    </resource>
  </resources>
</build>

如果您想针对不同环境使用自定义排除规则，请将其与 个人资料。例如：

<project>
  ...
  <profiles>
    <profile>
      <id>env-uat</id>
      <activation>
        <property>
          <name>env</name>
          <value>uat</value>
        </property>
      </activation>
      <build>
        <resources>
          <resource>
            <directory>src/main/resources</directory>
            <excludes>
              <exclude>**/*.xml</exclude>
            </excludes>
          </resource>
        </resources>
      </build>
    </profile>
  </profiles>
</project>

使用此配置文件时，xml 文件不会出现在 target/classes 中，因此它们不会出现在 WEB-INF/classes 中最后的战争。

我尝试使用 maven-war-plugin 但失败了。如果我添加此配置（用于测试）（...）我的 WEB-INF/classes 仍将包含 XML 文件

您在这里所做的是添加一个附加资源目录，该目录似乎是已包含的默认资源目录。因此，无论您要排除什么，这都不会产生任何影响，因为文件无论如何都会在 process-resources 期间复制到 target/classes ，因此最终仍然在 中WEB-INF/类。

换句话说，当您想要添加不属于默认资源目录的额外资源时，请使用 webResources ：

<project>
  ...
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-war-plugin</artifactId>
        <version>2.1</version>
        <configuration>
          <webResources>
            <resource>
              <!-- this is relative to the pom.xml directory -->
              <directory>extra-resources</directory>
            </resource>
          </webResources>
        </configuration>
      </plugin>
    </plugins>
  </build>
  ...
</project>

但我不认为这就是您在这里寻找的内容，建议使用上面建议的方法。

Answer 2

请参阅 帕斯卡的回答正确的配置和对过程的良好解释。我在这里直接回答这个问题：

• webResources 参数是 maven-war-plugin 中的一项功能，允许仅包含 src/main/resources 文件夹外部的文件？如果是这样，我们如何从 src/main/resources 中更改复制的文件？
• webResources 参数是 maven-war-plugin 中的一项功能，允许从 src/main/resources 文件夹外部包含文件也？如果是这样，如何配置才能做到这一点？

是前者，maven-war-plugin 中的 webResources 参数只允许包含来自 src/main/ 外部的额外资源资源。它不允许允许为src/main/resources本身配置包含/排除。