Java

Wednesday July 03 2024

注意

1
2
3
# windows 错误: 编码 GBK 的不可映射字符。
## 添加编译参数指定字符集编码 `-encoding UTF-8`
javac -encoding UTF-8 -d out/single --module-source-path single -m helloworld

1
2
3
4
5
# `--module-source-path src` 从 src 目录下检索java 模块，但是需要整个模块代码目录在src下才能正常编译
javac -d out --module-source-path src -m helloworld

# IDE 项目目录、gradle、maven 有自己的代码目录规范，编译时不是采用 `--module-source-path` 应该是编译全部 java 文件进行编译
javac -d out/helloworld src/helloworld/org/bougainvilleas/ilj/HelloWorld.java src/helloworld/module-info.java

module-info.java

1
module helloworld{}

HelloWorld.java 注意包类路径

1
2
3
4
5
6
7
8
9
package cn.aiclr.ilj;

public class HelloWorld {

    public static void main(String[] args) {
        System.err.println("Hello modular world");
    }
    
}

编译

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
# java9 之前
javac -d out \
src/cn/aiclr/ilj/A.java \
src/cn/aiclr/ilj/B.java

# java9 及以后 会添加反映模块名称的 helloworld 目录  out/helloworld
# 将module-info.java 作为额外源文件进行编译
javac -d out/helloworld \
src/helloworld/cn/aiclr/ilj/HelloWorld.java \
src/helloworld/module-info.java

# --module-source-path src 在 src 下检索 模块 helloworld
javac -d out --module-source-path src -m helloworld

运行 classes

1
2
3
4
5
6
# 运行 模块 classes --module-path = -p   --module = -m
java --module-path out \
--module helloworld/cn.aiclr.ilj.HelloWorld

java -p out \
-m helloworld/cn.aiclr.ilj.HelloWorld

打包

需要先建立 mods 目录

1
2
3
4
5
mkdir mods

jar -cvfe mods/helloworld.jar \
cn.aiclr.ilj.HelloWorld \
-C out/helloworld .

运行 jar

1
2
3
4
5
6
7
8
9
# 运行 module jar （构建jar时 指定了入口点 cn.aiclr.ilj.Helloworld）
java -p mods -m helloworld

# --show-module-resolution 跟踪模块系统采取的操作
java --show-module-resolution -p mods -m helloworld

# --limit-modules java.base 阻止通过服务绑定解析其他平台模块
java --show-module-resolution --limit-modules java.base \
-p mods -m helloworld

jlink 创建仅包含运行应用程序所需模块的运行时 image

jlink 不执行自动服务绑定即：不会根据 uses 子句自动将服务提供者包含在映像中
java.base 具有大量uses子句，所有这些服务类型的提供者位于其他各种平台模块中
默认绑定所有这些服务将会增大映像的大小，不会根据 uses 子句自动将服务提供者包含在映像中

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
# --module-path mods/:$JAVA_HOME/jmods 构造一个模块路径
# 包含 mods 目录（helloworld 模块位置）
# 包含要链接到 image 中的平台模块的JDK安装目录
# 与 javac java 不同 必须将平台模块显示添加到 jlink 模块路径中
#
# --add-modules helloworld 
# 表示 helloworld 是需要在运行时 image 中运行的根模块
#
# --launcher 定义了一个入口点来直接运行 image 中的模块
# --output 表示运行时 image 的目录名称
jlink --module-path mods/:$JAVA_HOME/jmods \
--add-modules helloworld \
--launcher hello=helloworld \
--output helloworld-image

# 查看
tree helloworld-image

# helloworld-image/
# ├── bin
# │   ├── hello
# │   ├── java
# │   └── keytool
# ├── conf
# ├── include
# ├── legal
# │   └── java.base
# ├── lib
# ├── man
# └── release

运行

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
tree helloworld-image/bin/

# helloworld-image/bin/
# ├── hello #直接启动 helloworld 模块的可执行脚本
# ├── java # 仅能解析 helloworld 及其依赖项的 java runtime
# └── keytool

# 运行
./helloworld-image/bin/hello

./helloworld-image/bin/java --list-modules

多模块

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
src
├── hello
│   ├── module-info.java
│   └── cn
│       └── aiclr
│           └── hello
│               └── HelloWorld.java
└── hi
    ├── module-info.java
    └── cn
        └── aiclr
            └── hi
                └── HI.java

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// hello 依赖 hi 模块
// cat src/hi/module-info.java 
module hi
{
    exports cn.aiclr.hi;
}
// cat src/hello/module-info.java 
module hello
{
    requires hi;
}

//cat src/hi/cn/aiclr/hi/HI.java 
package cn.aiclr.hi;

public class HI {

    public static String say() {
       return "hi";
    }
    
}
//cat src/hello/cn/aiclr/hello/HelloWorld.java 
package cn.aiclr.hello;

import cn.aiclr.hi.HI;

public class HelloWorld {

    public static void main(String[] args) {
        System.err.println(HI.say());
    }
    
}

编译多模块

1
2
3
4
5
6
7
8
# --module-source-path src 在 src 下 检索 模块

# 编译 hello 
# hello 依赖 hi 也会编译 hi
javac -d out --module-source-path src -m hello

# 编译 hi 不会编译 hello
javac -d out --module-source-path src -m hi

运行 classes

1
2
3
4
5
6
7
8
# module path 需要包含运行所需的所有模块
java -p out -m hello/cn.aiclr.hello.HelloWorld

# unix module path 使用 : 号分割
java -p out/hello:out/hi -m hello/cn.aiclr.hello.HelloWorld

# windows module path 使用 ; 号分割 注意不要使用 powershell
java -p out/hello;out/hi -m hello/cn.aiclr.hello.HelloWorld

打包

分模块打包放到同一目录下

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
tree out
# out/
# ├── hello
# │   ├── module-info.class
# │   └── cn
# │       └── aiclr
# │           └── hello
# │               └── HelloWorld.class
# └── hi
#     ├── module-info.class
#     └── cn
#         └── aiclr
#             └── hi
#                 └── HI.class

# -e, --main-class=CLASSNAME jar名不用与模块名保持一致
jar -cvfe mods/hello.jar cn.aiclr.hello -C out/hello .

jar -cvf mods/hi.jar -C out/hi .

运行

jar包放到同一目录下

1
2
3
4
5
6
tree mods
# mods/
# ├── hello.jar
# └── hi.jar

java -p mods -m hello

jlink

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# -p --module-path mods/:$JAVA_HOME/jmods 构造一个模块路径
# 包含 mods 目录（helloworld 模块位置）
# 包含要链接到 image 中的平台模块的JDK安装目录
# 与 javac java 不同 必须将平台模块显示添加到 jlink 模块路径中
#
# --add-modules hello 
# 表示 hello 是需要在运行时 image 中运行的根模块
# 会 自动将其 requires 的模块添加到 images
# 
# --launcher 定义了一个入口点来直接运行 image 中的模块
# --output 表示运行时 image 的目录名称

jlink -p mods/:$JAVA_HOME/jmods \
--add-modules hello \
--launcher hello=hello \
--output sayHi

tree sayHi
# sayHi/
# ├── bin
# │   ├── hello
# │   ├── java
# │   └── keytool
# ├── conf
# ├── include
# ├── legal
# ├── lib
# ├── man
# └── release

# 运行
./sayHi/bin/hello

Tags:

Java