Maven是什么

Maven是一个流行的Java构建工具，它提供了许多插件来帮助开发人员自动化构建和部署Java应用程序。其中一个重要的插件是Maven打包插件，它可以将Java项目打包成可执行的JAR或WAR文件。在本文中，我们将深入探讨Maven打包插件的技术细节和使用方法。

Maven打包插件的作用

Maven打包插件是一个用于打包Java项目的Maven插件。它可以将项目的源代码、依赖项和其他资源打包成一个可执行的JAR或WAR文件。这个插件可以自动处理项目的依赖关系，并将它们打包到生成的文件中。此外，它还可以执行其他任务，如压缩文件、生成文档等。

首先先梳理一下关于打包 相关的常用的Maven插件工具：

1. 使用清理插件：maven-clean-plugin: 执行清理删除已有target目录；
2. 使用资源插件：maven-resources-plugin: 执行资源文件的处理
3. 使用编译插件：maven-compiler-plugin: 编译所有源文件生成class文件至target\classes目录下
4. 使用资源插件：maven-resources-plugin: 执行测试资源文件的处理
5. 使用编译插件：maven-compiler-plugin: 编译测试目录下的所有源代码
6. 使用插件：maven-surefire-plugin: 运行测试用例
7. 使用插件：maven-jar-plugin: 对编译后生成的文件进行打包，

包名称默认为：artifactId-version，包文件保存在target目录下（这个生成的包不能在命令行中直接执行，因为我们还没有入口类配置到Manifest资源配置文件中去，后续会阐述）。

注意：不管是compile、package还是install等前三个步骤都是必不可少的。

Maven打包后经常出现的问题

• Maven可以使用mvn package指令对项目进行打包，如果使用Java -jar xxx.jar执行运行jar文件，会出现" no main manifest attribute, in xxx.jar"（没有设置Main-Class）、ClassNotFoundException（找不到依赖包）等错误。

这个原因属于maven没有执行构建：maven构建可运行Jar包。

maven构建可运行Jar包

要想jar包能直接通过java -jar xxx.jar运行，需要满足：
1. 在jar包中的META-INF/MANIFEST.MF中指定Main-Class，这样才能确定程序的入口在哪里
2. 要能加载到依赖包，使用Maven有以下几种方法可以生成能直接运行的jar包，可以根据需要选择一种合适的方法

---

Maven打包的三种方式

Maven打包的最简单的方法

Maven打包插件的配置非常简单，只需要在项目的pom.xml文件中添加以下代码即可。

maven-jar-plugin

首先是在maven项目的pom.xml中添加打包的插件，这里有很多种方式的。最最简单的就是只使用maven-compiler-plugin、maven-jar-plugin插件，并且指定程序入口。

pom.xml文件为：

<?xml version="1.0" encoding="UTF-8"?>
<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>xx</groupId><artifactId>xx</artifactId><version>1.0-SNAPSHOT</version><build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><configuration><source>1.8</source><target>1.8</target></configuration></plugin><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-jar-plugin</artifactId><configuration><archive><manifest><addClasspath>true</addClasspath><useUniqueVersions>false</useUniqueVersions><classpathPrefix>lib/</classpathPrefix><mainClass>com.xx.Main</mainClass></manifest></archive></configuration></plugin></plugins></build>
</project> 

这个配置中，我们使用了Maven的maven-jar-plugin插件来打包项目。在插件的配置中，我们指定了生成的JAR文件的元数据，包括主类和类路径。这些信息将被写入JAR文件的MANIFEST.MF文件中，以便Java虚拟机可以正确地执行JAR文件。

MANIFEST.MF文件部分

• com.xx.Main指定MANIFEST.MF中的Main-Class
• true会在MANIFEST.MF加上Class-Path项并配置依赖包
• lib/指定依赖包所在目录。

MANIFEST.MF的文件内容

通过maven-jar-plugin插件生成的MANIFEST.MF文件片段：

Class-Path: lib/x.jar lib/xx.jar  
Main-Class: com.xxg.Main  

当然生成MANIFEST.MF文件还不够，maven-dependency-plugin插件用于将依赖包拷贝到${project.build.directory}/lib指定的位置，即lib目录下。

jar包的拷贝机制

配置完成后，通过mvn package指令打包，会在target目录下生成jar包，并将依赖包拷贝到target/lib目录下。

在pom.xml中配置

<build>  <plugins>  <plugin>  <groupId>org.apache.maven.plugins</groupId>  <artifactId>maven-jar-plugin</artifactId>  <version>2.6</version>  <configuration>  <archive>  <manifest>  <addClasspath>true</addClasspath>  <classpathPrefix>lib/</classpathPrefix>  <mainClass>com.xx.Main</mainClass>  </manifest>  </archive>  </configuration>  </plugin>  <plugin>  <groupId>org.apache.maven.plugins</groupId>  <artifactId>maven-dependency-plugin</artifactId>  <version>2.10</version>  <executions>  <execution>  <id>copy-dependencies</id>  <phase>package</phase>  <goals>  <goal>copy-dependencies</goal>  </goals>  <configuration>  <outputDirectory>${project.build.directory}/lib</outputDirectory>  </configuration>  </execution>  </executions>  </plugin>  </plugins>  
</build>  

指定了Main-Class，有了依赖包，那么就可以直接通过java -jar xxx.jar运行jar包。这种方式生成jar包有个缺点，就是生成的jar包太多不便于管理，下面两种方式只生成一个jar文件，包含项目本身的代码、资源以及所有的依赖包，接下来我们 好好分析一下这种打包方式的局限性。

maven-jar-plugin的局限性

如果一个maven项目中有多个子目录，每一个子目录中的pom.xml对应一个项目，它的作用范围只有这一个目录下的。比如扫描配置文件，如果要让一个目录下的pom.xml扫描另一个目录下的配置文件，那是做不到的。在打jar包的时候，只运行当前的pom.xml文件。

当然也有其他的打包方法，比如使用spring-boot-maven-plugin插件在打Jar包时，会引入依赖包。

maven-shade-plugin

由于上面的打包过程实在是过于的繁琐，而且也没有利用到maven管理项目的特色。接下来我们采用maven中的maven-shade-plugin插件进行资源打包，在pom.xml中，加入如下的信息来加入插件。

使用maven-shade-plugin插件打包

在pom.xml中配置：

<build>  <plugins>  <plugin>  <groupId>org.apache.maven.plugins</groupId>  <artifactId>maven-shade-plugin</artifactId>  <version>2.4.1</version>  <executions>  <execution>  <phase>package</phase>  <goals>  <goal>shade</goal>  </goals>  <configuration>  <transformers>  <transformer implementation="org.apache.maven.plugins.shade.resource.Mani                   festResourceTransformer">  <mainClass>com.xx.Main</mainClass>  </transformer>  </transformers>  </configuration>  </execution>  </executions>  </plugin>  </plugins>  
</build>  

配置完成后，执行mvn package即可打包。在target目录下会生成两个jar包，注意不是original-xxx.jar文件，而是另外一个。

和maven-assembly-plugin一样，生成的jar文件包含了所有依赖，所以可以直接运行。如果项目中用到了Spring Framework，将依赖打到一个jar包中，运行时会出现读取XML schema文件出错。

原因是Spring Framework的多个jar包中包含相同的文件spring.handlers和spring.schemas，如果生成一个jar包会互相覆盖。为了避免互相影响，可以使用AppendingTransformer来对文件内容追加合并：

<build>  <plugins>    <plugin>  <groupId>org.apache.maven.plugins</groupId>  <artifactId>maven-shade-plugin</artifactId>  <version>2.4.1</version>  <executions>  <execution>  <phase>package</phase>  <goals>  <goal>shade</goal>  </goals>  <configuration>  <transformers>  <transformer implementation="org.apache.maven.plugins.shade.resource.Mani               festResourceTransformer">  <mainClass>com.xxg.Main</mainClass>  </transformer>  <transformer implementation="org.apache.maven.plugins.shade.resource.App                endingTransformer">  <resource>META-INF/spring.handlers</resource>  </transformer>  <transformer implementation="org.apache.maven.plugins.shade.resource.App                endingTransformer">  <resource>META-INF/spring.schemas</resource>  </transformer>  </transformers>  </configuration>  </execution>  </executions>  </plugin>  </plugins>  
</build>  

这里面配置了一个configuration标签内容，在此标签下面 有一个transformer标签，用来配置Main函数的入口 ( com.xx.Main)，当然此标签内容很复杂，不是上面写的那么简单，上面之所以如此简单，是因为在所有类中(包括第三方Jar)只有一个Main方法。如果第三方jar中有Main方法，就要进行额外的配置，上面这么配置，不一定能执行成功。

在加入这段代码到pom.xml之后，我们就可以用maven的命令去打包了。其指令如下：

• mvn clean compile ：清除之前target编译文件并重新编译
• mvn clean package ：对项目进行打包(因为配置过插件，所以jar包是可执行的)
• mvn clean install ：安装项目，然后就可以使用了

上面的方法，我们还需要点击很多命令去打包。这次利用一个新的插件，可以打包更简单。同样，在pom.xml中加入如下代码。上文的maven-shade-plugin插件代码可以删除。

maven-assembly-plugin

使用maven-assembly-plugin插件打包，这里同样配置了一个manifest标签来配置Main函数的入口。然后通过如下指令来实现打包。

在pom.xml中配置：

<plugin><artifactId>maven-assembly-plugin</artifactId><version>2.4</version><configuration><descriptorRefs><descriptorRef>jar-with-dependencies</descriptorRef></descriptorRefs><archive><manifest><mainClass>Main.Main</mainClass></manifest></archive></configuration><executions><execution><id>make-assembly</id><phase>package</phase><goals><goal>single</goal></goals></execution></executions></plugin>

maven指令

mvn assembly:assembly

含有依赖方面所对应的jar包依赖的核心数据包

<build>  <plugins>  <plugin>  <groupId>org.apache.maven.plugins</groupId>  <artifactId>maven-assembly-plugin</artifactId>  <version>2.5.5</version>  <configuration>  <archive>  <manifest>  <mainClass>com.xxg.Main</mainClass>  </manifest>  </archive>  <descriptorRefs>  <descriptorRef>jar-with-dependencies</descriptorRef>  </descriptorRefs>  </configuration>  </plugin>  </plugins>  
</build>  

打包方式：

mvn package assembly:single  

打包后会在target目录下生成一个xxx-jar-with-dependencies.jar文件，这个文件不但包含了自己项目中的代码和资源，还包含了所有依赖包的内容。所以可以直接通过java -jar来运行。此外还可以直接通过mvn package来打包，无需assembly:single，不过需要加上一些配置：

<plugins>  <plugin>  <groupId>org.apache.maven.plugins</groupId>  <artifactId>maven-assembly-plugin</artifactId>  <version>2.5.5</version>  <configuration>  <archive>  <manifest>  <mainClass>com.xxg.Main</mainClass>  </manifest>  </archive>  <descriptorRefs>  <descriptorRef>jar-with-dependencies</descriptorRef>  </descriptorRefs>  </configuration>  <executions>  <execution>  <id>make-assembly</id>  <phase>package</phase>  <goals>  <goal>single</goal>  </goals>  </execution>  </executions>  </plugin>  </plugins>  
</build>  

其中package、single即表示在执行package打包时，执行assembly:single，所以可以直接使用mvn package打包。

不过，如果项目中用到spring Framework，用这种方式打出来的包运行时会出错，使用下面的方法三可以处理。