maven: 打包可运行的jar包(java application)及依赖项处理

maven: 打包可运行的jar包(java application)及依赖项处理

IDE环境中，可以直接用exec-maven-plugin插件来运行java application，类似下面这样：

1 <plugin>
2     <groupId>org.codehaus.mojo</groupId>
3     <artifactId>exec-maven-plugin</artifactId>
4     <version>1.2.1</version>
5     <executions>
6         <execution>
7             <goals>
8                 <goal>exec</goal>
9             </goals>
10         </execution>
11     </executions>
12     <configuration>
13         <executable>java</executable>
14         <arguments>
15             <argument>-classpath</argument>
16             <classpath>
17             </classpath>
18             <argument>ctas.importer.reader.app.Program</argument>
19         </arguments>
20     </configuration>
21 </plugin>

18行，改成自己的Main-Class类，然后用mvn exec:exec来运行，但是部署到生产环境中时，服务器上通常并不具备maven环境，只能用 java
-jar xxx.jar这种方式来运行，下面是一些处理细节：
 
一、依赖项的处理
java application运行时需要查找依赖的第三方jar，如果查找classpath失败，就会报错，可以先用
mvn dependency:copy-dependencies -DoutputDirectory=target/lib
命令，把依赖的jar包全部导出到target/lib这个目录下
 
二、利用maven-jar-plugin修改META-INF\MANIFEST.MF 清单文件
java application的最终jar里，用解压工具打开后，可以看到META-INF目录下，有一个重要的清单文件 MANIFEST.MF，这里面可以指定 Main-Class及classpath，结构如下：

1 Manifest-Version: 1.0
2 Built-By: jimmy
3 Build-Jdk: 1.7.0_09
4 Class-Path: lib/DataEntity-1.0.jar ...
5 Created-By: Apache Maven 3.2.3
6 Main-Class: ctas.importer.reader.app.Program
7 Archiver-Version: Plexus Archiver

其中第4行指定了classpath，也就是所依赖的jar包在什么地方，第6行表示main函数的入口类，默认情况下mvn clean package生成的jar包里，清单文件上并没有这2行，需要在pom.xml中添加插件

1 <plugin>
2     <groupId>org.apache.maven.plugins</groupId>
3     <artifactId>maven-jar-plugin</artifactId>
4     <configuration>
5         <archive>
6             <manifest>
7                 <mainClass>ctas.importer.reader.app.Program</mainClass>
8                 <addClasspath>true</addClasspath>
9                 <classpathPrefix>lib/</classpathPrefix>
10             </manifest>
11         </archive>
12         <classesDirectory>
13         </classesDirectory>
14     </configuration>
15 </plugin>

第7行指定Main-Class，第9行指定classpath的相对路径，这样mvn package后，清单文件里就会自动添加Main-Class和Class-Path这二项
ok了，部署时把jar包和lib目录，都上传到服务器上 ，然后测试一下，顺利的话 java -jar  xxx.jar就可以了，如果要在后台运行，前面加 nohup