【Maven技术专题】「实战开发系列」盘点Maven项目中打包需要注意到的那点事儿

Tech逍遥御风
222 阅读7分钟

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，用这种方式打出来的包运行时会出错，使用下面的方法三可以处理。

avatar
文章
阅读
粉丝
相关推荐
深入探讨Maven打包：打造精致的Zip包
850阅读
 · 
5点赞
【Maven技术专题】「实战开发系列」盘点Maven项目中打包需要注意到的那点事儿
823阅读
 · 
8点赞
【Maven技术专题】「入门到精通」教你如何使用Maven中引用依赖本地Jar包，并进行打包输出
685阅读
 · 
9点赞
Maven项目打包生成瘦Jar（Jar瘦身）及指定依赖目录
463阅读
 · 
3点赞
flutter build aar 及一键打包aar并上传Maven私服（阿里云效）
830阅读
 · 
10点赞
动态切换 Spring Boot 打包配置：使用 Maven Profiles 管理 JAR 和 WAR
331阅读
 · 
2点赞
探索maven replacer插件，打包时动态生成版本号
2.5k阅读
 · 
20点赞
Jenkins+Maven+git+Tomcat对Spring boot项目进行打包发布
245阅读
 · 
1点赞
落地实践之基于MAVEN的BUILD插件打包应用程序
1.2k阅读
 · 
5点赞
maven打包全流程原理
844阅读
 · 
7点赞

友情链接：