Maven War 插件Classes文件夹打为Jar包的Bug与解决方法

有时候我们需要利用Maven Resource管理的过滤功能将某些文件中的${XXX}变量在构建时进行动态替换，但同时我们不希望这些文件被加入到jar包中，因为它们是在jar包外或者只是部署时有用，这个需求在Maven的Jar插件中有对应的功能支持，即<excludes>标签。

但是在War插件中，就没有这么幸运了。War插件的配置中有一个<packagingExcludes>配置项，当项目中类和资源文件以展开形式存在于WEB-INF/classes目录下时，<packagingExcludes>配置项工作良好，以下示例就是将classes文件夹下的所有bat文件排除在war包外：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-war-plugin</artifactId>
    <configuration>
        <packagingExcludes>WEB-INF/classes/*.bat</packagingExcludes>
    </configuration>
</plugin>

上述配置工作良好，问题来自于：有时候，你需要把WEB-INF/classes目录下的文件打成jar包放入WEB-INF/lib下，对此War插件提供了<archiveClasses>配置项来实现这一需求。但不幸的是将classes目录打成jar的过程中，<packagingExcludes>是无效的。以下是无效的配置参考：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-war-plugin</artifactId>
    <configuration>
        <!--当打为jar包时，packagingExcludes配置失效！-->
        <packagingExcludes>WEB-INF/classes/*.bat</packagingExcludes>
        <archiveClasses>true</archiveClasses>
    </configuration>
</plugin>

应该说这是War插件的一个BUG，对比Jar插件来说，这一点War做的不好。解决方案只能在War插件之外做文章了，我们找到的方法是使用了resource配置中非常冷门targetPath配置项，将不希望打入jar包的文件放入target/classes之外的其他文件夹，同时还要确保这些文件必须经过resource的过滤。配置如下：

<resources>
    <resource>
        <!-- 过滤除bat之外的所有文件，并放入默认文件夹target/classes下 -->
        <directory>src/main/resources</directory>
        <filtering>true</filtering>
        <excludes>
            <exclude>*.bat</exclude>
        </excludes>
    </resource>
    <resource>
        <!-- 只过滤除bat文件，并放入target下 -->
        <directory>src/main/resources</directory>
        <filtering>true</filtering>
        <includes>
            <include>*.bat</include>
        </includes>
        <targetPath>..</targetPath>
    </resource>
</resources>