1. 關(guān)于 Maven 打 war 包

《使用 Eclipse 的 Maven 2 插件開發(fā)一個 JEE 項目》詳細介紹了如何在 Eclipse 使用 Maven 新建一個 JEE 項目并對其進行斷點跟蹤調(diào)試揍堰，但是沒有介紹如何對 JEE 項目打 war 包护奈。其實很簡單撵儿，你只需要把 pom.xml 中的 <packaging>jar</packaging> 換成 <packaging>war</packaging> 就可以使用 mvn package 命令對其打 war 包了芽腾，而不需要添加任何 maven 插件。只要你遵循了 maven 規(guī)范(比如照著《使用 Eclipse 的 Maven 2 插件開發(fā)一個 JEE 項目》所述做了)峦朗，那你打成的 war 包就肯定包含了第三方依賴包：

maven打的war包里邊的第三方依賴包

把這個 war 包丟進 tomcat 的 webapps 目錄份乒，重啟 tomcat 即可完成了該項目的部署。你唯一需要注意的是椰憋，在重啟 tomcat 之前把你的 war 重命名為 項目訪問路徑.war厅克。比如作者打成的 war 包是為 swifton-1.0.0.war，對該項目定義的訪問路徑是 /swifton橙依，那么我在重啟 tomcat 之前需要將其重命名為 swifton.war证舟。

2. 可執(zhí)行程序打 jar 包

關(guān)于可執(zhí)行程序(需要指定一個 main 類)打 jar 包就沒這么方便了，我們需要考慮以下幾個問題：

• 配置文件需要打進 jar 包窗骑；
• 需要指定 main 入口類女责；
• 所依賴的第三方庫也要打進 jar 包；

只有同時滿足以上三點创译，我們才可以直接使用 java -jar swiftonrsa-1.0.0.jar 命令成功執(zhí)行該程序抵知。
為了讓討論不那么抽象，我們在 Eclipse 下新建一個 maven 項目 swiftonrsa：

新建maven項目swiftonrsa

其中，com.defonds.RsaEncryptor 是入口 main 類辛藻，其源碼如下：

package com.defonds;  
 
import org.springframework.context.ApplicationContext;  
import org.springframework.context.support.ClassPathXmlApplicationContext;  
  
import com.defonds.service.LinkPayAntharService;  
  
public class RsaEncryptor {  
  
    public static void main(String[] args) {  
        ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");  
        LinkPayAntharService linkPayAntharService = (LinkPayAntharService) context.getBean("linkPayAntharService");  
        linkPayAntharService.dealWithYearData();  
    }  
}  

2.1 配置文件打包不需要額外關(guān)注

只要你項目所依賴的配置文件都按照 maven 規(guī)范放對位置(src/main/resources)碘橘，那么打好的 jar 包就會把它們一起打包：

配置文件打包不需要額外關(guān)注

但是這樣打好的 jar 包既沒有指定 main 入口類，也沒有將依賴包打進來吱肌，我們運行它：

swiftonrsa-1.0.0.jar中沒有清單屬性

提示"swiftonrsa-1.0.0.jar中沒有主清單屬性"痘拆，我們查看打好 jar 包下 META-INF 目錄中的 MANIFEST.MF，其內(nèi)容如下：
Manifest-Version: 1.0
Built-By: Defonds
Build-Jdk: 1.7.0_67
Created-By: Apache Maven 3.2.3
Archiver-Version: Plexus Archiver
確實沒有指出 main 入口類氮墨。

2.2 maven-assembly-plugin 插件

于是我們引入了 maven-assembly-plugin 插件纺蛆，pom.xml 中加入如下代碼：

<build>  
    <plugins>  
        <plugin>  
            <artifactId>maven-assembly-plugin</artifactId>  
            <configuration>  
                <appendAssemblyId>false</appendAssemblyId>  
                <descriptorRefs>  
                    <descriptorRef>jar-with-dependencies</descriptorRef>  
                </descriptorRefs>  
                <archive>  
                    <manifest>  
                        <mainClass>com.defonds.RsaEncryptor</mainClass>  
                    </manifest>  
                </archive>  
            </configuration>  
            <executions>  
                <execution>  
                    <id>make-assembly</id>  
                    <phase>package</phase>  
                    <goals>  
                        <goal>assembly</goal>  
                    </goals>  
                </execution>  
            </executions>  
        </plugin>  
    </plugins>  
</build>  

執(zhí)行 mvn assembly:assembly，成功構(gòu)建 swiftonrsa-1.0.0.jar规揪，查看其打包目錄桥氏，各種配置文件以及第三方依賴包也都有：

assembly打包后的目錄結(jié)構(gòu)

然后查看 META-INF 目錄中的 MANIFEST.MF，內(nèi)容如下：
Manifest-Version: 1.0
Archiver-Version: Plexus Archiver
Created-By: Apache Maven
Built-By: Defonds
Build-Jdk: 1.7.0_67
Main-Class: com.defonds.RsaEncryptor
懷著興奮的心情執(zhí)行之：

assembly打包后的執(zhí)行情況

maven-assembly-plugin 插件沒有給我們帶來驚喜猛铅。錯誤信息如下：
Exception in thread "main" org.springframework.beans.factory.parsing.BeanDefinitionParsingException: Configuration problem: Unable to locate Spring NamespaceHandler for XML schema namespace [http://www.springframework.org/schema/context]
原來這是 assembly 插件的一個 bug：http://jira.codehaus.org/browse/MASSEMBLY-360字支，它在對第三方打包時，對于 META-INF 下的 spring.handlers奸忽，spring.schemas 等多個同名文件進行了覆蓋堕伪，遺漏掉了一些版本的 xsd 本地映射。

2.3 maven-shade-plugin 插件

有破必有立栗菜。http://jira.codehaus.org/browse/MASSEMBLY-360 跟帖中有網(wǎng)友推薦了 maven-shade-plugin 插件欠雌。于是我們使用 maven-shade-plugin 將 maven-assembly-plugin 替代：

<build>  
    <plugins>  
        <plugin>  
            <groupId>org.apache.maven.plugins</groupId>  
            <artifactId>maven-shade-plugin</artifactId>  
            <version>1.4</version>  
            <executions>  
                <execution>  
                    <phase>package</phase>  
                    <goals>  
                        <goal>shade</goal>  
                    </goals>  
                    <configuration>  
                        <transformers>  
                            <transformer  
                                implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">  
                                <mainClass>com.defonds.RsaEncryptor</mainClass>  
                            </transformer>  
                            <transformer  
                                implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">  
                                <resource>META-INF/spring.handlers</resource>  
                            </transformer>  
                            <transformer  
                                implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">  
                                <resource>META-INF/spring.schemas</resource>  
                            </transformer>  
                        </transformers>  
                    </configuration>  
                </execution>  
            </executions>  
        </plugin>  
    </plugins>  
</build>  

對于多個第三方包 META-INF 下的同名的 spring.handlers 文件它采取的態(tài)度是追加而不是覆蓋。執(zhí)行 maven clean package疙筹，成功構(gòu)建 swiftonrsa-1.0.0.jar富俄，查看其打包目錄，各種配置文件以及第三方依賴包也都有而咆，以及 META-INF 目錄中的 MANIFEST.MF 的內(nèi)容霍比，基本如 maven-assembly-plugin 打包后的樣子，執(zhí)行之：

shade插件打包后執(zhí)行情況

錯誤信息如下：
java.lang.SecurityException: Invalid signature file digest for Manifest main attributes
這是由于一些包重復(fù)引用翘盖，打包后的 META-INF 目錄多出了一些 *.SF 等文件所致桂塞。
有破必有立。博客 http://zhentao-li.blogspot.com/2012/06/maven-shade-plugin-invalid-signature.html 給出了解決方案馍驯，pom.xml 添加：

<configuration>  
  <filters>  
    <filter>  
      <artifact>*:*</artifact>  
      <excludes>  
        <exclude>META-INF/*.SF</exclude>  
        <exclude>META-INF/*.DSA</exclude>  
        <exclude>META-INF/*.RSA</exclude>  
      </excludes>  
    </filter>  
  </filters>  
</configuration>  

于是我們對 maven-shade-plugin 的配置變成這樣：

<build>  
    <plugins>  
        <plugin>  
            <groupId>org.apache.maven.plugins</groupId>  
            <artifactId>maven-shade-plugin</artifactId>  
            <version>1.4</version>  
            <executions>  
                <execution>  
                    <phase>package</phase>  
                    <goals>  
                        <goal>shade</goal>  
                    </goals>  
                    <configuration>  
                        <filters>  
                            <filter>  
                                <artifact>*:*</artifact>  
                                <excludes>  
                                    <exclude>META-INF/*.SF</exclude>  
                                    <exclude>META-INF/*.DSA</exclude>  
                                    <exclude>META-INF/*.RSA</exclude>  
                                </excludes>  
                            </filter>  
                        </filters>  
                        <transformers>  
                            <transformer  
                                implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">  
                                <mainClass>com.defonds.RsaEncryptor</mainClass>  
                            </transformer>  
                            <transformer  
                                implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">  
                                <resource>META-INF/spring.handlers</resource>  
                            </transformer>  
                            <transformer  
                                implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">  
                                <resource>META-INF/spring.schemas</resource>  
                            </transformer>  
                        </transformers>  
                    </configuration>  
                </execution>  
            </executions>  
        </plugin>  
    </plugins>  
</build>  

再次執(zhí)行 maven clean package阁危，再次執(zhí)行成功構(gòu)建后的 swiftonrsa-1.0.0.jar：

再次執(zhí)行shade插件打包后的swiftonrsa

最后兩行是具體業(yè)務(wù)實現(xiàn)類 com.defonds.service.LinkPayAntharServiceImpl 成功執(zhí)行打印出的 log 日志。

2.4 示例項目

本文示例項目 swiftonrsa 已上傳至 CSDN 資源汰瘫，有興趣的朋友可以下載下來參考實驗狂打，下載地址：http://download.csdn.net/detail/defonds/8404739。
本文示例項目最終 pom.xml 如下：

<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/xsd/maven-4.0.0.xsd">  
    <modelVersion>4.0.0</modelVersion>  
  
    <groupId>settle</groupId>  
    <artifactId>swiftonrsa</artifactId>  
    <version>1.0.0</version>  
    <packaging>jar</packaging>  
  
    <name>swiftonrsa</name>  
    <url>http://maven.apache.org</url>  
  
    <properties>  
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>  
    </properties>  
  
    <build>  
        <plugins>  
            <plugin>  
                <groupId>org.apache.maven.plugins</groupId>  
                <artifactId>maven-shade-plugin</artifactId>  
                <version>1.4</version>  
                <executions>  
                    <execution>  
                        <phase>package</phase>  
                        <goals>  
                            <goal>shade</goal>  
                        </goals>  
                        <configuration>  
                            <filters>  
                                <filter>  
                                    <artifact>*:*</artifact>  
                                    <excludes>  
                                        <exclude>META-INF/*.SF</exclude>  
                                        <exclude>META-INF/*.DSA</exclude>  
                                        <exclude>META-INF/*.RSA</exclude>  
                                    </excludes>  
                                </filter>  
                            </filters>  
                            <transformers>  
                                <transformer  
                                    implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">  
                                    <mainClass>com.defonds.RsaEncryptor</mainClass>  
                                </transformer>  
                                <transformer  
                                    implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">  
                                    <resource>META-INF/spring.handlers</resource>  
                                </transformer>  
                                <transformer  
                                    implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">  
                                    <resource>META-INF/spring.schemas</resource>  
                                </transformer>  
                            </transformers>  
                        </configuration>  
                    </execution>  
                </executions>  
            </plugin>  
        </plugins>  
    </build>  
  
  
    <dependencies>  
  
        <!-- logs -->  
        <dependency>  
            <groupId>log4j</groupId>  
            <artifactId>log4j</artifactId>  
            <version>1.2.17</version>  
        </dependency>  
  
        <dependency>  
            <groupId>commons-logging</groupId>  
            <artifactId>commons-logging</artifactId>  
            <version>1.2</version>  
        </dependency>  
  
        <dependency>  
            <groupId>org.slf4j</groupId>  
            <artifactId>slf4j-api</artifactId>  
            <version>1.7.10</version>  
        </dependency>  
  
        <dependency>  
            <groupId>org.slf4j</groupId>  
            <artifactId>slf4j-log4j12</artifactId>  
            <version>1.7.10</version>  
        </dependency>  
  
        <!-- spring -->  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-core</artifactId>  
            <version>3.2.3.RELEASE</version>  
        </dependency>  
  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-orm</artifactId>  
            <version>3.2.3.RELEASE</version>  
        </dependency>  
  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-context</artifactId>  
            <version>3.2.3.RELEASE</version>  
        </dependency>  
  
        <!-- ibatis -->  
        <dependency>  
            <groupId>org.apache.ibatis</groupId>  
            <artifactId>ibatis-sqlmap</artifactId>  
            <version>2.3.4.726</version>  
        </dependency>  
  
        <!-- connector -->  
        <dependency>  
            <groupId>mysql</groupId>  
            <artifactId>mysql-connector-java</artifactId>  
            <version>5.1.19</version>  
        </dependency>  
  
        <!-- dbcp -->  
        <dependency>  
            <groupId>commons-dbcp</groupId>  
            <artifactId>commons-dbcp</artifactId>  
            <version>1.4</version>  
        </dependency>  
  
        <dependency>  
            <groupId>commons-pool</groupId>  
            <artifactId>commons-pool</artifactId>  
            <version>1.6</version>  
        </dependency>  
  
        <!-- rsa encrypt -->  
        <dependency>  
            <groupId>org.bouncycastle</groupId>  
            <artifactId>bcprov-jdk15on</artifactId>  
            <version>1.51</version>  
        </dependency>  
  
        <!-- commons-codec -->  
        <dependency>  
            <groupId>commons-codec</groupId>  
            <artifactId>commons-codec</artifactId>  
            <version>1.6</version>  
        </dependency>  
  
    </dependencies>  
</project>