如何使用maven打可执行jar包

  使用maven打可执行jar包，通常可以使用两个插件：maven-assembly-plugin和maven-jar-plugin。本文主要介绍使用maven-jar-plugin实现打包。

一、工程结构

  先介绍工程结构，便于后续的打包配置讲解，工程结构图如下：

  上图中java目录为源码目录，resources目录为资源目录，主要存放一些配置文件。

二、打包配置

  使用maven-jar-plugin打包，需要配置使用其他插件，如：maven-compiler-plugin、maven-dependency-plugin、maven-resources-plugin等。配置内容如下：

<build>
    <plugins>
        <!-- 编译插件 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <configuration>
                <source>1.7</source>
                <target>1.7</target>
                <encoding>UTF-8</encoding>
            </configuration>
        </plugin>
        <!-- 依赖插件 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-dependency-plugin</artifactId>
            <configuration>
                <outputDirectory>${project.build.directory}/lib</outputDirectory>
                <excludeTransitive>false</excludeTransitive> <!-- 表示是否不包含间接依赖的包 -->
                <stripVersion>false</stripVersion><!-- 去除版本信息 -->
            </configuration>
            <executions>
                <execution>
                    <id>copy-dependencies</id>
                    <phase>package</phase>
                    <goals>
                        <goal>copy-dependencies</goal>
                    </goals>
                    <configuration>
                        <!-- 拷贝项目依赖包到lib/目录下 -->
                        <outputDirectory>${project.build.directory}/lib</outputDirectory>
                        <excludeTransitive>false</excludeTransitive>
                        <stripVersion>false</stripVersion>
                    </configuration>
                </execution>
            </executions>
        </plugin>

        <!-- 资源插件 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-resources-plugin</artifactId>
            <executions>
                <execution>
                    <id>copy-resources</id>
                    <phase>package</phase>
                    <goals>
                        <goal>copy-resources</goal>
                    </goals>
                    <configuration>
                        <encoding>UTF-8</encoding>
                        <!-- 拷贝项目src/main/resources/下的所有文件到conf/目录下 -->
                        <outputDirectory>${project.build.directory}/conf</outputDirectory>
                        <resources>
                            <resource>
                                <directory>src/main/resources</directory>
                            </resource>
                        </resources>
                    </configuration>
                </execution>
            </executions>
        </plugin>

        <!-- 打包插件 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <configuration>
                <archive>
                    <!-- 生成MANIFEST.MF的设置 -->
                    <manifest>
                        <!-- 为依赖包添加路径, 这些路径会写在MANIFEST文件的Class-Path下 -->
                        <addClasspath>true</addClasspath>
                        <classpathPrefix>lib/</classpathPrefix>
                        <!-- jar启动入口类-->
                        <mainClass>com.kayak.kamp.single.Main</mainClass>
                    </manifest>
                    <manifestEntries>
                        <!-- 在Class-Path下添加配置文件的路径 -->
                        <Class-Path>conf/</Class-Path>
                    </manifestEntries>
                </archive>
                <includes>
                    <!-- 打jar包时，只打包class文件 -->
                    <include>**/*.class</include>
                </includes>
            </configuration>
        </plugin>
    </plugins>
</build>

三、执行打包

  执行打包使用maven命令，因此需要先安装maven工具。Maven的安装《Maven实战系列之在Windows上安装Maven》。

  Maven安装完成之后，cd进入工程主目录，执行如下命令：

mvn clean package

  执行完成之后，主目录中生成一个target目录，该目录是编译和打包输出目录。target目录下有一个conf目录，主要存放工程的配置文件，还有一个lib目录，主要存放工程的依赖包，还有一个jar包，这个jar就是最终的可执行jar包。

四、运行部署jar包

  将上述提到的conf目录、lib目录和jar拷贝到部署目录，然后执行java命令即可运行，命令如下：

java -jar myproject.jar