JAR-使用JAVA命令编译打包一个可执行jar包

一.开发一个演示项目

项目源代码开发

• 项目名称叫jar-package-example(其实只是一个文件夹, 用以将演示的所有文件夹和文件存放在其中, 没啥其它作用), 为了方便, 后文统一叫jar-package-example目录为项目根目录.

• 项目下有三个子文件夹:

  • lib: 存放依赖包
  • src: 存放源码文件
  • target: 存放编译后的class文件以及作为打包的目标文件夹

  [root@xs jar-package-example]# ls -t
  target  src  lib
  [root@xs jar-package-example]# pwd
  /root/jar-package-example
  [root@xs jar-package-example]#
  

创建包结构

在src源码文件夹下创建包结构:

====> com.sfg.xs

=====> portal

=====> utils

[root@xs jar-package-example]# ls -t
target  src  lib
[root@xs jar-package-example]# pwd
/root/jar-package-example
[root@xs jar-package-example]# mkdir -p src/com/sfg/xs/portal
[root@xs jar-package-example]# mkdir -p src/com/sfg/xs/utils
[root@xs jar-package-example]# cd src/com/sfg/xs
[root@xs xs]# ls -t
utils  portal
[root@xs xs]# pwd
/root/jar-package-example/src/com/sfg/xs
[root@xs xs]#

至此, 演示所用的包结构已创建完成.

将依赖包放入项目根路径的lib目录下

编写代码文件

在com.sfg.xs.utils包下放入一个工具类CipherUtil.java, 工具类代码如下:

package com.sfg.xs.utils;

import com.alibaba.druid.filter.config.ConfigTools;

/**
 * @Author:周建林
 * @Time:2020/12/25 14:56
 * @Description
 */
public class CipherUtil {
    public static String encrypt(String password) throws Exception {
        return ConfigTools.encrypt(password);
    }

    public static String decrypt(String password) throws Exception {
        return ConfigTools.decrypt(password);
    }
}

放入工具类之后如图:

在com.sfg.xs.portal包下放入两个入口类EncryptPortal.java和DecryptPortal.java, 两个入口类类代码如下:

package com.sfg.xs.portal;

import com.sfg.xs.utils.CipherUtil;
import org.apache.commons.lang3.StringUtils;

/**
 * @Author:周建林
 * @Time:2020/12/25 15:02
 * @Description
 */
public class EncryptPortal {
    public static void main(String[] args) throws Exception {
        if(args == null || args.length == 0) {
            System.err.println("请输入密码!");
            System.exit(1);
        }
        String password = args[0];
        if(StringUtils.isBlank(password)) {
            System.out.println(password);
        }else{
            System.out.println(CipherUtil.encrypt(password));
        }
        System.exit(0);
    }
}

package com.sfg.xs.portal;

import com.sfg.xs.utils.CipherUtil;
import org.apache.commons.lang3.StringUtils;

/**
 * @Author:周建林
 * @Time:2020/12/25 15:26
 * @Description
 */
public class DecryptPortal {
    public static void main(String[] args) throws Exception {
        if(args == null || args.length == 0) {
            System.err.println("请输入密码!");
            System.exit(1);
        }
        String password = args[0];
        if(StringUtils.isBlank(password)) {
            System.out.println(password);
        }else{
            System.out.println(CipherUtil.decrypt(password));
        }
        System.exit(0);
    }
}

放入入口类之后如图:

至此, 演示所用的源代码已经准备完成. 下面开始编译项目.

二.编译与打包项目

编译代码

进入项目根目录, 执行编译命令

[root@xs jar-package-example]# ls -lrt
total 12
drwxr-xr-x 2 root root 4096 Dec 28 15:01 lib
drwxr-xr-x 3 root root 4096 Dec 28 15:05 src
drwxr-xr-x 2 root root 4096 Dec 28 16:03 target
[root@xs jar-package-example]# javac -d target -extdirs lib -encoding utf-8 src/com/sfg/xs/portal/*.java src/com/sfg/xs/utils/*.java
# 此命令在jdk14版本执行失败了, 换jdk8成功, 其它版本未验证. jdk14版本下使用报错不允许-extdirs参数, 不知道是我使用方法不对还是其它原因
[root@xs jar-package-example]#

编译之后, 即在项目根目录的target目录下生成了class文件

[root@xs jar-package-example]# cd target/
[root@xs target]# ls -lrt
total 4
drwxr-xr-x 3 root root 4096 Dec 28 16:03 com
[root@xs target]# ls -rlt com/
total 4
drwxr-xr-x 3 root root 4096 Dec 28 16:03 sfg
[root@xs target]# ls -rlt com/sfg/xs
total 8
drwxr-xr-x 2 root root 4096 Dec 28 16:03 portal
drwxr-xr-x 2 root root 4096 Dec 28 16:03 utils
[root@xs target]# ls -rlt com/sfg/xs/portal/
total 8
-rw-r--r-- 1 root root 859 Dec 28 16:03 DecryptPortal.class
-rw-r--r-- 1 root root 859 Dec 28 16:03 EncryptPortal.class
[root@xs target]# ls -rlt com/sfg/xs/utils/
total 4
-rw-r--r-- 1 root root 485 Dec 28 16:03 CipherUtil.class
[root@xs target]#

编译命令参数解释说明: javac -d target -extdirs lib -encoding utf-8 src/com/sfg/xs/portal/*.java src/com/sfg/xs/utils/*.java

注意, 所有的说明都基于在项目根目录的情况下.

• -d target: 指定将编译后的二进制文件输出到当前目录的target目录下
• -extdirs lib: 指定项目使用到的扩展依赖包所在的目录
• -encoding utf-8: 使用utf-8字符集进行编码
• 最后的参数为编译的源文件路径, 支持星号作通配符, 多个源文件使用空格隔开. 编译时, 会根据类文件中的package头生成包路径

至此, 源代码与代码编译都已完成. 后面可以进行打jar包了.

项目打jar包

依赖包处理

本次演示将依赖包一并打入jar包中使用, 因此先将依赖包及其整个所在目录都复制到target目录下.

[root@xs target]# pwd
/root/jar-package-example/target
[root@xs target]# cp -r ../lib ./
[root@xs target]# ls -lrt
total 8
drwxr-xr-x 3 root root 4096 Dec 28 16:03 com
drwxr-xr-x 2 root root 4096 Dec 28 16:06 lib
[root@xs target]#

编写MANIFETS.MF文件

如果需要打出来的jar包可以直接使用java -jar命令执行的话, 则需要MANIFEST.MF文件, 并且需要指出默认的执行入口类.其文件格式为"key: value"形式, 冒号后面必须有空格, 文件末尾必须以换行符结尾.

另附上一份儿MANIFEST.MF文件说明链接: https://docs.oracle.com/en/java/javase/15/docs/specs/jar/jar.html#jar-manifest

1. 进入项目根目录下的target目录下, 创建META-INF文件夹

[root@xs target]# pwd
/root/jar-package-example/target
[root@xs target]# ls -lrt
total 8
drwxr-xr-x 3 root root 4096 Dec 28 16:03 com
drwxr-xr-x 2 root root 4096 Dec 28 16:06 lib
[root@xs target]# mkdir META-INF
[root@xs target]# ls -lrt
total 12
drwxr-xr-x 3 root root 4096 Dec 28 16:03 com
drwxr-xr-x 2 root root 4096 Dec 28 16:06 lib
drwxr-xr-x 2 root root 4096 Dec 28 16:07 META-INF
[root@xs target]#

1. 进入刚刚新建的META-INF目录, 创建MANIFEST.MF文件

[root@xs META-INF]# pwd
/root/jar-package-example/target/META-INF
[root@xs META-INF]# ls -lrt
total 0
[root@xs META-INF]# touch MANIFEST.MF
[root@xs META-INF]# ls -lrt
total 0
-rw-r--r-- 1 root root 0 Dec 28 16:08 MANIFEST.MF
[root@xs META-INF]#

1. 编写MANIFEST.MF文件内容

Manifest-Version: 1.0	# 表明文件版本
Class-Path: . ./lib/commons-lang3-3.8.1.jar ./lib/druid-1.1.10.jar	# 指定依赖包路径
Main-Class: com.sfg.xs.portal.EncryptPortal	# 指定默认的执行入口类
# 最后必须以换行符结尾

执行命令打包

进入target目录下, 执行打包命令: jar -cfM jar-package-example.jar *, 命令中, jar包名随自己取.

[root@xs target]# pwd
/root/jar-package-example/target
[root@xs target]# ls -lrt
total 12
drwxr-xr-x 3 root root 4096 Dec 28 16:03 com
drwxr-xr-x 2 root root 4096 Dec 28 16:06 lib
drwxr-xr-x 2 root root 4096 Dec 28 16:16 META-INF
[root@xs target]# jar -cfM jar-package-example.jar *
[root@xs target]# ls -lrt
total 2956
drwxr-xr-x 3 root root    4096 Dec 28 16:03 com
drwxr-xr-x 2 root root    4096 Dec 28 16:06 lib
drwxr-xr-x 2 root root    4096 Dec 28 16:16 META-INF
-rw-r--r-- 1 root root 3011900 Dec 28 16:18 jar-package-example.jar
[root@xs target]#

三.运行jar包看看效果