maven 打包jar文件（含可执行jar包）

最近在研究docker，要打包一个可以独立执行的jar包，于是研究了很久，对于maven plugin还未深入研究，之后会再次补充此文章，先简单介绍一下常用的几种plugin和适用情况

访问我的个人网站获取更多文章

项目说明

• spring framework
• spring boot

plugin 介绍

spring-boot-maven-plugin

<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>

主要用于运行maven管理的spring-boot应用运行，cmd: mvn spring-boot:run；

* 另外，使用以下方式指定spring-boot-starter-parent，运行mvn package可以打包为可执行jar包，同时生成.origin结尾的工具包 *

<!--这里不能使用dependencyManagement的方式，会导致compiler不能正确使用jdk-->
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.3.5.RELEASE</version>
<relativePath/>
</parent>

maven compiler plugin

<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>

作用是打包jar包，指定jdk版本等信息

docker-maven-plugin

 <build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
<!-- tag::plugin[] -->
<plugin>
<groupId>com.spotify</groupId>
<artifactId>docker-maven-plugin</artifactId>
<version>0.4.3</version>
<configuration>
<imageName>${docker.image.prefix}/${project.artifactId}</imageName>
<dockerDirectory>src/main/docker</dockerDirectory>
<resources>
<resource>
<targetPath>/</targetPath>
<directory>${project.build.directory}</directory>
<include>${project.build.finalName}.jar</include>
</resource>
</resources>
</configuration>
</plugin>
<!-- end::plugin[] -->
</plugins>
</build>

imageName指定了镜像的名字，本例为 waylau/docker-spring-boot
dockerDirectory指定 Dockerfile 的位置
resources是指那些需要和 Dockerfile 放在一起，在构建镜像时使用的文件，一般应用 jar 包需要纳入。本例，只需一个 jar 文件。
这个工具主要用来打包jar包同时生成docker的image,需要配合spring-boot-maven-plugin使用

maven-jar-plugin

  <plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<configuration>
<archive>
<manifest>
<mainClass>com.**.**</mainClass>
<addClasspath>true</addClasspath>
<classpathPrefix>lib/</classpathPrefix>
</manifest>
</archive>
</configuration>
</plugin>

这个插件的作用是用来修改生成的清单文件 MANIFEST.MF，这个文件是jar包执行所必须的，但是仅使用该plugin则仅仅是在清单文件中添加了mainclass 和classpath,指定的lib目录实际为/target目录下的，所以需要在程序主目录下运行

mvn dependency:copy-dependencies -DoutputDirectory=target/lib

将所有的依赖jar打包到target/lib下面，这样jar包可以运行了，但必须和lib目录放在一个文件夹下面。

以下两个工具各有所长，不再介绍，对于spring boot的项目，仅需要一个spring-boot-maven-plugin就足够了，但是对于非spring-boot项目，需要结合多个plugin进行配置

maven-assembly-plugin

maven-shade-plugin

参考链接

shade plugin
jar plugin
docker plugin