maven中使用assembly打包

借助assembly打可执行jar包

---

前言

最近在做的一个功能需要将单java文件（main方法）打成可执行的jar包，进行部署调用，从网上搜集了一些相关的内容，在实现过程中也踩了一些坑，特此记录一下，做个备份。

---

一、idea引入assembly依赖

            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-assembly-plugin</artifactId>
                <version>3.0.0</version>
                <executions>
                    <execution>
                        <id>make-assembly</id>
                        <phase>package</phase>
                        <goals>
                            <!--只执行一次-->
                            <goal>single</goal>
                        </goals>
                        <configuration>
                            <archive>
                                <manifest>
                                 <!--jar包的入口 main方法-->
                                  <mainClass>com.xxx.MainClass</mainClass>
                                </manifest>
                            </archive>
                            <!-- 生成的jar包的名称前缀 -->
                            <finalName>ProjectName</finalName>
                            <descriptors>
                            	<!-- assembly插件的配置文件路径 -->
                                <descriptor>src/main/assembly/assembly.xml</descriptor>
                            </descriptors>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

二、添加assembly.xml配置文件

 我是在src/main目录下新建assembly文件夹，在文件夹下添加assembly.xml文件，文件用于指定assembly
插件的一些参数，比如包的类型，jar、zip、war，以及生成的包内包含的文件所在目录等等 直接上配置：

<assembly>
    <id>dep</id>
    <formats>
        <!--支持 zip，tar，tar.gz，tar.bz2，jar，dir，war 等 -->
        <format>jar</format>
    </formats>
    <includeBaseDirectory>false</includeBaseDirectory>
    <fileSets>
        <fileSet>
            <directory>src/main/java</directory>
            <outputDirectory>/</outputDirectory>
            <fileMode>0644</fileMode>
        </fileSet>
        <fileSet>
            <directory>src/main/resources</directory>
            <outputDirectory>/</outputDirectory>
            <fileMode>0644</fileMode>
        </fileSet>
        <fileSet>
            <directory>${profile.dir}</directory>
            <outputDirectory>/</outputDirectory>
            <!-- 表示的是包含下面格式的资源文件 -->
            <includes>
                <include>*.xml</include>
                <include>*.properties</include>
                <include>**/*.xml</include>
                <include>**/*.properties</include>
            </includes>
            <fileMode>0644</fileMode>
        </fileSet>
        <fileSet>
            <directory>${project.basedir}/target/classes/</directory>
            <outputDirectory>/</outputDirectory>
            <includes>
                <include>/**/*.class</include>
                <include>*.xml</include>
                <include>*.properties</include>
                <include>*.yaml</include>
            </includes>
        </fileSet>

    </fileSets>
    <dependencySets>
        <dependencySet>
            <outputDirectory>/</outputDirectory>
            <useProjectArtifact>true</useProjectArtifact>
            <unpack>true</unpack>
            <scope>runtime</scope>
        </dependencySet>
        <dependencySet>
            <outputDirectory>/</outputDirectory>
            <useProjectArtifact>true</useProjectArtifact>
            <unpack>true</unpack>
            <scope>system</scope>
        </dependencySet>
        <dependencySet>
            <outputDirectory>lib</outputDirectory>
        </dependencySet>
    </dependencySets>
</assembly>

字段	含义
fileSet	用于指定包内包含文件所在的路径，需要将class文件和模板文件打到jar包中，所以需要指定resources和classes所在的路径
dependencySet	dependencySet可将项目的依赖打入jar包中，unpack为true，表示将依赖的jar包解成.class文件，false表示使用依赖的jar包形式
outputDirectory	依赖的路径

三、打包

执行maven命令进行打包 mvn clean package ，由于pom文件中phase配置将插件运行绑定到package命令，所以执行package命令时会将assembly的包一起打出来。最后jar包的命名为{finalName}-{assembly.xml中id}.jar

总结

在开始使用的时候，打包可以成功，但是执行java -jar的时候会报出

Error: A JNI error has occurred, please check your installation and try again
Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/http/ParseException

的错误，经过调试，发现是jar包中没有main方法的依赖文件，后来增加assembly.xml中增加dependencySet属性，会将main的依赖解出.class文件，才可以运行。