JPMS 模块化：module-info 与 JLink 精简运行时

# 模块路径：显式声明的模块
java --module-path mods:lib -m order.app/com.example.Main
# 类路径：普通 jar，作为未命名模块运行
java -cp lib/*.jar com.example.LegacyMain

// order-service/src/main/java/module-info.java
module order.service {
    requires order.api;               // 依赖 order.api 模块
    requires java.sql;                // 依赖 JDK 模块
    requires com.fasterxml.jackson.core;

    exports com.example.order.service; // 对外公开的包
}

module order.service {
    exports com.example.order.spi to order.extension;
}

module order.api {
    requires transitive order.model;   // 使用方自动获得 order.model
    exports com.example.order.api;
}

module order.service {
    requires jakarta.persistence;
    opens com.example.order.entity to org.hibernate.orm;
    // 只向 Hibernate 开放实体包的反射访问
}

拆分前：com.example.service 既在 a.jar 又在 b.jar  → 冲突
拆分后：com.example.service.api 在 order-api 模块
        com.example.service.impl 在 order-core 模块 → 不冲突

// order.spi 模块定义接口
module order.spi {
    exports com.example.order.spi;
}

// order.biz 模块提供实现
module order.biz {
    requires order.spi;
    provides com.example.order.spi.PriceCalculator
        with com.example.order.biz.DefaultPriceCalculator;
}

// order.web 模块消费服务
module order.web {
    requires order.spi;
    uses com.example.order.spi.PriceCalculator;
}

// 消费方通过 ServiceLoader 发现所有实现
List<PriceCalculator> calculators = new ArrayList<>();
for (PriceCalculator c : ServiceLoader.load(PriceCalculator.class)) {
    calculators.add(c);
}

order-model（纯领域对象，无外部依赖）
  ↑
order-api（接口与 SPI，依赖 model）
  ↑
order-core（业务实现，依赖 api 与 model）
  ↑
order-app（启动入口，依赖 core）

jdeps --module-path . --generate-module-info out order-service.jar

// 生成模块描述，再用 jmod 或工具画依赖图
jdeps --module-path . -s order.service

order.app → order.core → order.api → order.model
                 └──────→ java.sql, com.fasterxml.jackson.core

第 1 步：先用 jdeps 分析依赖，找出 JDK 内部 API 的调用点
第 2 步：将可模块化的核心 jar 加入模块路径，其余留在类路径
第 3 步：逐个补充 module-info.java，用 --generate-module-info 打底
第 4 步：全部收敛到模块路径后，启用 jlink 做运行时裁剪

# 生成精简运行时到 target/plume-runtime
jlink --module-path "$JAVA_HOME/jmods":target/mods \
      --add-modules order.app,jdk.unsupported \
      --output target/plume-runtime \
      --strip-debug --no-man-pages --no-header-files \
      --compress=2

target/plume-runtime/bin/java -m order.app/com.example.Main

FROM alpine:3.20
COPY target/plume-runtime /opt/plume
COPY target/app /app
ENTRYPOINT ["/opt/plume/bin/java", "-m", "order.app/com.example.Main"]

完整 JDK 镜像约 300MB，jlink 精简运行时加 Alpine 可压到 50MB 以内

<!-- Maven 多模块与 JPMS 并存：每个模块 src/main/java/module-info.java -->
<modules>
  <module>order-model</module>
  <module>order-api</module>
  <module>order-core</module>
  <module>order-app</module>
</modules>

module order.app {
    requires spring.boot;
    requires spring.boot.autoconfigure;
    requires spring.context;
    opens com.example.order.app to spring.core, spring.beans, spring.context;
    uses com.example.order.spi.PriceCalculator;
}

java --add-opens java.base/java.lang=order.app \
     --add-exports java.base/sun.nio.ch=ALL-UNNAMED \
     -m order.app/com.example.Main