标签：java程序打包

Javac/Jar/Java是JDK的发布包中带的三个基本工具，用于对Java源码进行编译打包运行，本文将介绍这几个工具的使用方法。

1. 代码和演示环境

代码地址：https://gitee.com/pphh/blog/tree/master/171221_java_compile_run/
演示环境：Windows 7 SP1, JDK 9.0.1

下面的所有命令演示都是在目录./171221_java_compile_run/中进行，文件的目录结构如下，

+ Simple.java
+ src
  - App.java
  + common
    - java/com/pphh/demo/Logger.java
  + main
    - java/com/pphh/demo/AppPkg.java
+ src2
  - AppLogger.java
+ src3
  - AppJ7.java
  - AppJ8.java
+ target
  - app.jar
  - common.jar
  + classes

2. Java源码编译

在开发完Java代码后，首先需要对源码进行编译。JDK中带的编译工具为Javac。

javac的命令格式为，

javac [options] [sourcefiles]

其中：
options 命令行选项
sourcefiles 待编译的代码文件

a) 简单的编译

只需要输入代码的文件地址即可

javac ./Simple.java
java Simple

b) 指定编译后的输出目录

使用-d选项，指定编译后的class文件输入目录

javac -d ./target/classes Simple.java
javac -d ./target/classes ./src/main/java/com/pphh/demo/AppPkg.java

c) 编译某个目录下的多个代码文件

使用-sourcepath选项，指定一个代码目录，然后通过通配符*.java获取指定目录下的所有代码文件进行编译，

set src_dir=./src/common/java/com/pphh/demo/
javac -d ./target/classes -sourcepath %src_dir% %src_dir%/*.java

上述命令会将指定目录下Logger.java文件进行编译，并按照package（com.pphh.demo）放置编译好的class文件，具体位置为,
./target/classes/com/pphh/demo/Logger.class

d) 有依赖的编译

可以通过-cp选项，指定依赖的class/Jar文件或所在目录。
例如程序代码src2/AppLogger.java有对前一步产生的Logger.class有依赖，其编译命令为，

javac -cp ./target/classes -d ./target/classes src2/AppLogger.java

上述命令指定了在依赖文件目录为/target/classes，编译代码后，将在目录./target/classes中产生一个AppLogger.class文件。

e) CLASSPATH

在编译的时候，Javac会从如下几个地方查找依赖class文件，

在指定依赖的时候，可以通过上述几个方法定义依赖的class文件。

f) 编译时指定源码和目标代码的Java版本

可以通过-source/-target选项指定。

javac -d ./target/classes ./src3/AppJ7.java -source 7 -target 7
javac -d ./target/classes ./src3/AppJ8.java -source 8 -target 8

在JDK 9中Javac支持的Java版本包括6, 7, 8, 9，JDK9不再支持-source 5之前的版本。

需要注意的是，源发行版必须高于目标发行版，换句话说Java 7语言级别的代码，可以编译成Java 7/8/9语言级别的目标class文件，但不能编译成Java 6语言级别目标代码。

3. class文件打包

对代码编译之后，为了方便发布和使用，需要使用工具jar对这些class文件进行打包成Jar包。Jar是Java Archives的缩写，意思为Java归档文件。

jar的命令格式为，

jar [options] [ [--release VERSION] [-C dir] files] ...

其中：
options 命令行选项
--release VERSION创建多版本的Jar包，这是JDK9新功能
-C DIR 更改目录路径

a) 简单的打包命令

在打包前，先切换到class文件目录，然后执行打包命令，

cd ./target/classes
jar cvf ../common.jar ./

上述命令将./target/classes目录下所有文件打好包为common.jar，并放置在上一层目录中，也就是./target/下面。

将common.jar放置在classes目录之外，这是为了区分class和jar包文件，防止在下一次运行命令时，将刚刚生成的common.jar也打入下一个包中，形成循环。

b) 打包时更改目录路径到根目录

很多时候我们希望直接指定class的目录路径，但是我们不要使用如下的命令，

jar cvf ./target/common.jar ./target/classes（不推荐此命令，请使用-C选项）

因为上面的命令没有更改目录结构。如果通过解压工具解压common.jar包，会发现里面classes文件目录结构是不对的，classes文件并没有放置在根目录，而且放置在target/classes/中，这个是不对的。

这个时候要使用-C选项，更改目录路径到根目录

jar -cvf ./target/common.jar -C ./target/classes/ .

c) 设置主程序

每一个Jar包都可以设置一个运行主程序，当使用Java -jar命令运行Jar包时，会自动执行这个主程序。

设置主程序要使用-e选项，

jar -cvfe ./target/common1.jar Simple -C ./target/classes/ .
jar -cvfe ./target/common2.jar AppLogger -C ./target/classes/ .
jar -cvfe ./target/common3.jar com.pphh.demo.AppPkg -C ./target/classes/ .

上面的命令将Jar包中的主程序分别设置为Simple\AppLogger\com.pphh.demo.AppPkg，包的运行见后面。

d) 选择指定的class文件打包

除了指定一个class目录，我们还可以指定某些class文件打成Jar包。

下面将指定的一个App.class打入app.jar包中，

jar -cvf ./target/app.jar -C ./target/classes/ Simple.class

下面将一个Logger.class归档为一个日志类库包中，

jar -cvf ./target/logger.jar -C ./target/classes/ ./com/pphh/demo/Logger.class

4. 执行Java程序

在将源码编译成可执行的class文件后，接下来就可以使用java工具来启动运行。

java的命令格式为，

java [options] mainclass [args...]

其中：
options 命令行选项
mainclass 主程序类文件
args 命令行参数

a) 简单的编译运行

javac Simple.java
java Simple

b) 指定class文件或目录

javac -d ./target/classes Simple.java
java -classpath ./target/classes Simple
java -classpath "./target/classes/Simple.class;" Simple

c) 运行一个在指定package的运行程序

javac -d ./target/classes ./src/main/java/com/pphh/demo/AppPkg.java
java -classpath ./target/classes com.pphh.demo.AppPkg

d) 运行一个已配置主程序的Jar包

java -jar ./target/common1.jar
java -jar ./target/common2.jar
java -jar ./target/common3.jar

e) 运行一个未配置主程序的Jar包，通过命令指定运行的主程序

java -classpath "./target/common.jar" Simple
java -classpath "./target/common.jar" AppLogger
java -classpath "./target/common.jar" com.pphh.demo.AppPkg

5. 参考文献