Maven 项目打包须要注意到的那点事儿

时间 2019-11-06

原文原文链接

1. 关于 Maven 打 war 包

对 J2EE 项目打 war 包。其实很简单，你只须要把 pom.xml 中的 <packaging>jar</packaging> 换成 <packaging>war</packaging> 就可使用 mvn package 命令对其打 war 包了，而不须要添加任何 maven 插件。只要你遵循了 maven 规范，那你打成的 war 包就确定包含了第三方依赖包：

把这个 war 包丢进 tomcat 的 webapps 目录，重启 tomcat 便可完成了该项目的部署。你惟一须要注意的是，在重启 tomcat 以前把你的 war 重命名为项目访问路径.war。好比做者打成的 war 包是为 swifton-1.0.0.war，对该项目定义的访问路径是 /swifton，那么我在重启 tomcat 以前须要将其重命名为 swifton.war。
html

2. 可执行程序打 jar 包

关于可执行程序(须要指定一个 main 类)打 jar 包就没这么方便了，咱们须要考虑如下几个问题：
java

配置文件须要打进 jar 包；web
须要指定 main 入口类；spring
所依赖的第三方库也要打进 jar 包；apache

只有同时知足以上三点，咱们才能够直接使用 java -jar swiftonrsa-1.0.0.jar 命令成功执行该程序。
为了让讨论不那么抽象，咱们在 Eclipse 下新建一个 maven 项目 swiftonrsa：

其中，com.defonds.RsaEncryptor 是入口 main 类，其源码以下：
swift

package com.defonds; tomcat
import org.springframework.context.ApplicationContext; app
import org.springframework.context.support.ClassPathXmlApplicationContext; webapp
import com.defonds.service.LinkPayAntharService; maven
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 配置文件打包不须要额外关注

只要你项目所依赖的配置文件都按照 maven 规范放对位置(src/main/resources)，那么打好的 jar 包就会把它们一块儿打包：

可是这样打好的 jar 包既没有指定 main 入口类，也没有将依赖包打进来，咱们运行它：

提示"swiftonrsa-1.0.0.jar中没有主清单属性"，咱们查看打好 jar 包下 META-INF 目录中的 MANIFEST.MF，其内容以下：
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>

执行 mvn assembly:assembly，成功构建 swiftonrsa-1.0.0.jar，查看其打包目录，各类配置文件以及第三方依赖包也都有：

而后查看 META-INF 目录中的 MANIFEST.MF，内容以下：
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
怀着兴奋的心情执行之：

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 跟帖中有网友推荐了 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 文件它采起的态度是追加而不是覆盖。执行 maven clean package，成功构建 swiftonrsa-1.0.0.jar，查看其打包目录，各类配置文件以及第三方依赖包也都有，以及 META-INF 目录中的 MANIFEST.MF 的内容，基本如 maven-assembly-plugin 打包后的样子，执行之：

错误信息以下：
java.lang.SecurityException: Invalid signature file digest for Manifest main attributes
这是因为一些包重复引用，打包后的 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>

再次执行 maven clean package，再次执行成功构建后的 swiftonrsa-1.0.0.jar：

最后两行是具体业务实现类 com.defonds.service.LinkPayAntharServiceImpl 成功执行打印出的 log 日志。

转载：http://blog.csdn.net/defonds/article/details/43233131