Linux下使用java -jar运行可执行jar包的正确方式

时间：2021-11-02 18:34:47

问题来源

一般来说，一个稍微大些的项目都会有一些依赖的Jar包，而在将项目部署到服务器的过程中，如果没有持续集成环境的话，也就是说服务器不支持在线编译及打包，那么需要自己上传依赖的Jar包，然而可能服务器上已经存在了该项目所依赖的Jar包（比如项目修复BUG，重新打包上传，而依赖不变），无需再次上传，此时只需将该项目单独打包，在运行的时候指定CLASSPATH即可。

在将Jar包部署到服务器上之后，设置CLASSPATH环境变量，运行java -jar ...命令出现ClassNotFoundException异常。之后又试用了诸多其它参数设置CLASSPATH，例如下面几个命令，同样都是报找不到类异常。

1
 
set CLASSPATH = classpath1;classpath2...
java -classpath ".;D:\mylib\*" -jar jar包 #Windows设置
java -classpath ".:/data/home/mylib/*" -jar jar包 #Linux设置
java -cp ...
java -cp /lib/*

关于在CLASSPATH参数中使用通配符需要注意
正确方式（冒号代表是Linux，Windows使用分号）

1
 
java -classpath "lib/*:." my.package.Program

不正确方式

1
 
java -classpath "lib/a*.jar:." my.package.Program
java -classpath "lib/a*:."     my.package.Program
java -classpath "lib/*.jar:."  my.package.Program
java -classpath  lib/*:.       my.package.Program

解决办法

首先你需要知道Jar包分为可执行Jar和非可执行Jar，一个可执行的Jar文件是一个自包含的Java应用程序，它存储在特别配置的JAR文件中，可以由JVM直接执行它而无需事先提取文件或者设置类路径。要运行存储在非可执行的JAR中的应用程序，必须将它加入到您的类路径中，并用名字调用应用程序的主类。但是使用可执行的JAR文件，我们可以不用提取它或者知道主要入口点就可以运行一个应用程序。可执行JAR有助于方便发布和执行Java应用程序。

对于可执行Jar，在运行java -jar选项的时候，那么环境变量CLASSPATH和在命令行中指定的所有类路径都将被JVM忽略，也就是说，对于一个可执行Jar，使用java -classpath或者java -cp或者set classpath=lib/commons-io-2.4.jar等等命令指定CLASSPATH都是无效的。

对于一个可执行的JAR必须通过MANIFEST.MF文件的头引用它所需要的所有其他从属JAR，引用方式如下

1
 
Class-Path: lib/commons-io-2.4.jar lib/commons-lang3-3.4.jar

如果有多个Jar包那么相互之间使用空格分隔。MANIFEST文件的一般格式如下

1
2
3
4
5
6
7
8
9
 
Manifest-Version: 1.0
Archiver-Version: Plexus Archiver
Built-By: wangxu
X-Compile-Target-JDK: 1.7
X-Compile-Source-JDK: 1.7
Created-By: Apache Maven 3.3.3
Build-Jdk: 1.8.0_45
Main-Class: com.yuewen.statistics.report.service.Main
Class-Path: lib/commons-io-2.4.jar lib/commons-lang3-3.4.jar lib/guava-18.0.jar lib/junit-4.10.jar lib/log4j-api-2.0.jar lib/log4j-core-2.0.jar lib/lombok-1.16.4.jar lib/lucene-analyzers-common-5.5.0.jar lib/lucene-analyzers-smartcn-5.5.0.jar lib/lucene-core-5.5.0.jar lib/lucene-grouping-5.5.0.jar lib/lucene-queries-5.5.0.jar lib/lucene-queryparser-5.5.0.jar lib/mysql-connector-java-5.1.38-bin.jar

其中Manifest-Version表示版本号，一般由IDE工具自动生成，在编写MANIFEST文件的过程中，有如下注意点

  • Main-Class是jar文件的主类，程序的入口
  • Class-Path指定需要的jar，多个jar必须要在一行上，多个jar之间以空格隔开，如果引用的jar在当前目录的子目录下，windows下使用\来分割，linux下用/分割
  • 文件的冒号后面必须要空一个空格，否则会出错
  • 文件的最后一行必须是一个回车换行符，否则也会出错

多条java jar命令的执行顺序问题

通常情况下，我们会在服务器上配置shell脚本去定时调用自己的Jar包，但是当shell脚本中存在多条java -jar命令时，其执行情况是怎么样的呢？是同时并行执行，还是挨个按顺序执行呢？经过测试得出，多条java -jar命令是按顺序执行的，并且只有在第一条java -jar命令执行完毕后，才会执行下一条java -jar命令，依次类推。

参考资料
【1】http://*.com/questions/219585/setting-multiple-jars-in-java-classpath/219801#219801
【2】https://www.ibm.com/developerworks/cn/java/j-jar/


原文链接：http://codepub.cn/2016/05/11/The-correct-way-to-use-java-jar-run-an-executable-jar-package-under-Linux/

标签：

相关文章