因为今天一个朋友学习过程中用到了maven项目编写代码,到了最后打包阶段打的包不能运行,一时我也没想起来具体操作步骤,后来我百度学习了一下,特此记录下,以便后续自己查阅。
参考资料:
https://blog.csdn.net/fengyun_yi_pure/article/details/70313603
https://blog.csdn.net/xyr05288/article/details/52797493
https://blog.csdn.net/rambo_china/article/details/7691409
https://blog.csdn.net/semial/article/details/75226448
maven项目中不可避免的需要用到依赖jar,实际使用中有的能从maven仓库找到,有的找不到,所以存在使用本地jar的情况,下面将对使用maven仓库中jar,以及使用本地jar不同情况下打包可运行jar进行介绍。
情景一:使用maven依赖,所有的依赖都从maven仓库查找下载,最终打包成可执行jar,需要修改pom文件如下。
<!--使用maven依赖查找 json-lib --> <dependency> <groupId>net.sf.json-lib</groupId> <artifactId>json-lib</artifactId> <version>2.4</version> <classifier>jdk15</classifier> </dependency>
对应修改pom文件,需指定程序入口,不然会报错 xxxx-1.0-SNAPSHOT.jar中没有主清单属性
<!--情景一,制定程序入口即可。--> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-shade-plugin</artifactId> <version>1.2.1</version> <executions> <execution> <phase>package</phase> <goals> <goal>shade</goal> </goals> <configuration> <transformers> <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"> <mainClass>com.study.App</mainClass> </transformer> </transformers> </configuration> </execution> </executions> </plugin>
打包之后,即可通过 java -jar xxx.jar 运行,
package com.study; import net.sf.json.JSONObject; /** * Hello world! * */ public class App { public static void main( String[] args ) { System.out.println( "Hello World!" ); JSONObject json = new JSONObject(); json.put("name","子落"); System.out.println(json.toString()); } }
运行效果如下,
通过jar可以看出,是将引用的jar中对应的文件解压编译到打包的jar中
最终pom文件如下,
<?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>com.study</groupId> <artifactId>mvnstudy</artifactId> <version>1.0-SNAPSHOT</version> <packaging>jar</packaging> <name>mvnstudy</name> <url>http://www.example.com</url> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <maven.compiler.source>1.7</maven.compiler.source> <maven.compiler.target>1.7</maven.compiler.target> </properties> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.11</version> <scope>test</scope> </dependency> <!--使用maven依赖查找 json-lib --> <dependency> <groupId>net.sf.json-lib</groupId> <artifactId>json-lib</artifactId> <version>2.4</version> <classifier>jdk15</classifier> </dependency> </dependencies> <build> <plugins> <!--情景一,制定程序入口即可。--> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-shade-plugin</artifactId> <version>1.2.1</version> <executions> <execution> <phase>package</phase> <goals> <goal>shade</goal> </goals> <configuration> <transformers> <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"> <mainClass>com.study.App</mainClass> </transformer> </transformers> </configuration> </execution> </executions> </plugin> </plugins> </build> </project>
情景二,本地jar文件及maven依赖混用时打包。
首先介绍下,接下来使用的 testJar-1.0.jar,这个为我随便编写的一个jar文件,模拟本地jar使用场景。
package com.company; public class Mp { public static void println(String str){ System.out.println("Mp println = [" + str + "]"); } }
项目中使用
pom文件中引用
<!--使用本地jar--> <dependency> <groupId>testJar</groupId> <artifactId>junit</artifactId> <version>1.0</version> <scope>system</scope> <systemPath>${project.basedir}/lib/testJar-1.0.jar</systemPath> </dependency>
App代码修改,
package com.study; import com.company.Mp; import net.sf.json.JSONObject; /** * Hello world! * */ public class App { public static void main( String[] args ) { System.out.println( "Hello World!" ); JSONObject json = new JSONObject(); json.put("name","子落"); System.out.println(json.toString()); Mp.println("子落."); } }
这里打包时采用将所有本地jar也一起打包到一个可执行jar中,这样可以直接通过 java - jar xxx.jar运行。也可以通过先将本地jar注册到maven仓库,然后再打包,或者将本地jar复制到lib文件夹,然后通过在Manifest文件class-path中进行引用,这里主要讲,将所有依赖打包到一个jar中。
<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-jar-plugin</artifactId> <configuration> <archive> <manifest> <mainClass>com.study.App</mainClass> </manifest> </archive> </configuration> </plugin> <plugin> <groupId>com.jolira</groupId> <artifactId>onejar-maven-plugin</artifactId> <version>1.4.4</version> <executions> <execution> <configuration> <attachToBuild>true</attachToBuild> <classifier>onejar</classifier> </configuration> <goals> <goal>one-jar</goal> </goals> </execution> </executions> </plugin>
最终pom文件如下,
<?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>com.study</groupId> <artifactId>mvnstudy</artifactId> <version>1.0-SNAPSHOT</version> <packaging>jar</packaging> <name>mvnstudy</name> <url>http://www.example.com</url> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <maven.compiler.source>1.7</maven.compiler.source> <maven.compiler.target>1.7</maven.compiler.target> </properties> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.11</version> <scope>test</scope> </dependency> <!--使用maven依赖查找 json-lib --> <dependency> <groupId>net.sf.json-lib</groupId> <artifactId>json-lib</artifactId> <version>2.4</version> <classifier>jdk15</classifier> </dependency> <!--使用本地jar--> <dependency> <groupId>testJar</groupId> <artifactId>junit</artifactId> <version>1.0</version> <scope>system</scope> <systemPath>${project.basedir}/lib/testJar-1.0.jar</systemPath> </dependency> </dependencies> <build> <plugins> <!--情景一,制定程序入口即可。--> <!--<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-shade-plugin</artifactId> <version>1.2.1</version> <executions> <execution> <phase>package</phase> <goals> <goal>shade</goal> </goals> <configuration> <transformers> <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"> <mainClass>com.study.App</mainClass> </transformer> </transformers> </configuration> </execution> </executions> </plugin>--> <!--情景二,使打包的jar包含lib文件夹中的本地jar--> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-jar-plugin</artifactId> <configuration> <archive> <manifest> <mainClass>com.study.App</mainClass> </manifest> </archive> </configuration> </plugin> <plugin> <groupId>com.jolira</groupId> <artifactId>onejar-maven-plugin</artifactId> <version>1.4.4</version> <executions> <execution> <configuration> <attachToBuild>true</attachToBuild> <classifier>onejar</classifier> </configuration> <goals> <goal>one-jar</goal> </goals> </execution> </executions> </plugin> </plugins> </build> </project>
运行效果如下,
最终编译的文件如下
其中 mvnstudy-1.0-SNAPSHOT.one-jar.jar 既可直接运行的jar,里面包括之前引用的本地 testJar-1.0.jar 如下图,
可以看到以上两种方式,最终编译的jar内部文件是不一样的,第一种是将引用依赖中jar对应的文件解压,然后编译到最终的jar中,第二种是将引用的jar文件直接拿过来放入lib文件夹中,然后以套一层壳的方式运行,并不会对原jar文件进行解压,具体使用哪种方式,还要看实际使用情况。