在WAR外掛的以往版本中，配置並不總是必須的。如果你覺得使用預設設定能很好滿足要求，那就繼續這麼做。但是如果你需要更多的控制，那麼你就歹好好看看下面的部分了。

<overlay>元素包含有下列子元素：

• id -  overlay id。如果你不提供的話，WAR外掛將自動生成一個。
• groupId -  配置你想要覆蓋的groupId。
• artifactId – 配置你想要覆蓋的構件的artifactId。 
• type – 配置你想要覆蓋的構件型別。預設值是：war。
• classifier – 如果有多個構件匹配當前的groupId/artifactId，那麼你需要配置構件的classifier以明確覆蓋(classifier：該元素用來幫助定義構建輸出的一些附屬構件)。
• includes -  要包含的檔案。預設情況下，所有檔案都能被包含。  
• excludes – 要排除的檔案。預設情況下，在META – INF目錄是被排除在外的。
• targetPath -  在webapp結構的目標相對路徑，當然這隻在覆蓋型別為war時才有效。預設情況下，覆蓋的內容都追加在webapp的根節點下。
• skip – 當設定為true時，跳過本次覆蓋。預設值是：false。

說了這麼多，還是舉例項會比較直觀一點。

比如，我要排除我們的documentedprojectdependency.war下的sampleimage-dependency.jpg來覆蓋目標war檔案：

  …
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-war-plugin</artifactId>
        <version>2.1</version>
        <configuration>
          <overlays>
            <overlay>
              <groupId>com.example.projects</groupId>
              <artifactId>documentedprojectdependency</artifactId>
              <excludes>
                <exclude>WEB-INF/classes/images/sampleimage-dependency.jpg</exclude>
              </excludes>
            </overlay>
          </overlays>
        </configuration>
      </plugin>
    </plugins>
  </build>
  …

4、Overlays的打包

Overlays採用第一直達者優先的策略(因此，如果一個檔案被某一個副本覆蓋過，則它不會被另一個副本繼續覆蓋)。

Overlays的應用步驟依照它們在<overlays>配置的順序。如果沒有指定配置，那麼它們的依賴關係將按照POM定義的順序來呼叫(警告：這有很多的不確定性，特別是在您使用傳遞性依賴來覆蓋的時候)。如果當前專案運用了複合覆蓋的情況(即同時包含配置型覆蓋和非配置型覆蓋)，非配置型覆蓋應用於配置型覆蓋之後。

預設情況下，該專案源(亦稱當前構建)遵循按pom.xml上下文中依賴的先後順序進行追加(如任何覆蓋元素已被應用之前)。當前構建定義了一個沒有groupId和artifactId的特殊覆蓋方式。如果overlays需要應用第一(直達者優先)原則，那麼就只需簡單地配置當前構建在這些覆蓋之後。

例如，假設groupid為com.example.projects的my-webapp是當前專案的一個依賴，而你需要首先應用它，操作如下：

  …
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-war-plugin</artifactId>
        <version>2.1</version>
        <configuration>
          <overlays>
            <overlay>
              <groupId>com.example.projects</groupId>
              <artifactId>my-webapp</artifactId>
            </overlay>
            <overlay>
              <!– 空 groupId/artifactId代表當前構建 –>
            </overlay>
          </overlays>
        </configuration>
      </plugin>
    </plugins>
  </build>
  …

注意：在上述情況下，沒有配置在<overlays>元素的其它WAR依賴都會應用在當前構建之後。

如果你想要執行一項更好更精細的覆蓋策略，overlays能通過不同的includes/exclude元素進行多重打包。例如，我想要在當前專案中使用my-webapp的 index.jsp覆蓋檔案，但是my-webapp的其它檔案還是按照常規方式來控制，鑑於此，我們必須要為 my-webapp定義兩個覆蓋配置：

  …
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-war-plugin</artifactId>
        <version>2.1</version>
        <configuration>
          <overlays>
            <overlay>
              <id>my-webapp-index.jsp</id>
              <groupId>com.example.projects</groupId>
              <artifactId>my-webapp</artifactId>
              <includes>
                <include>index.jsp</include>
              </includes>
            </overlay>
            <overlay>
              <!– 空 groupId/artifactId代表當前構建 –>
            </overlay>

<!– 如果有必要的話，就把其它overlays配置在這裡 –>

<overlay>
              <id>my-webapp</id>
              <groupId>com.example.projects</groupId>
              <artifactId>my-webapp</artifactId>
            </overlay>
          </overlays>
        </configuration>
      </plugin>
    </plugins>
  </build>
  …

 5、Overlay全域性設定

下面的設定能指定全域性性的Overlay和修改所有Overlay的應用方式。

• dependentWarIncludes -  設定此包含預設值適用於所有的overlay。沒有指定includes元素的overlay都將繼承此預設設定。

    …
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-war-plugin</artifactId>
        <version>2.1</version>
        <configuration>
          <dependentWarIncludes>**/IncludeME,**/images</dependentWarIncludes>
        </configuration>
       </plugin>
    </plugins>
    …

• dependentWarExcludes -  設定此排除預設值適用於所有的overlay。沒有指定excludes元素的overlay都將繼承此預設設定。

    …
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-war-plugin</artifactId>
        <version>2.1</version>
        <configuration>
          <dependentWarExcludes>WEB-INF/web.xml,index.*</dependentWarExcludes>
        </configuration>
       </plugin>
    </plugins>
    …

• workDirectory – 設定overlays臨時提取的目錄。

    …
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-war-plugin</artifactId>
        <version>2.1</version>
        <configuration>
          <!– default value is target/war/work –>
          <workDirectory>/tmp/extract_here</workDirectory>
        </configuration>
       </plugin>
    </plugins>
    …

• useCache – 設定true時，能啟用webapp架構快取。預設值：false。

    …
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-war-plugin</artifactId>
        <version>2.1</version>
        <configuration>
          <useCache>true</useCache>
        </configuration>
       </plugin>
    </plugins>
    …

6、ZIP依賴的覆蓋

要想使一個zip依賴作為一個覆蓋，你必須在外掛配置中指定它。例如你要在Web應用的scripts目錄下通過一個zip覆蓋注入內容，操作如下：

    …
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-war-plugin</artifactId>
        <version>2.1</version>
        <configuration>
          <overlays>
            <overlay>
              <groupId>zipGroupId</groupId>
              <artifactId>zipArtifactId</artifactId>
              <type>zip</type>
              <targetPath>scripts</targetPath>
            </overlay>
          </overlays>
        </configuration>
      </plugin>
    </plugins>
    …

三、參考資料

1、http://maven.apache.org/plugins/maven-war-plugin-2.1-alpha-2/overlays.html

2、http://maven.apache.org/plugins/maven-war-plugin/overlays.html