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>