# 支持矩阵
IJPay 3.x 采用单分支、单套产物策略:同一份 jar 既可以在 JDK 8 运行,也可以在 JDK 8 以上的版本运行。所有发布模块的 class 文件主版本固定为 52(Java 8)。
# JDK 支持矩阵
| JDK | 定位 | 编译产物 | 验证状态 |
|---|---|---|---|
| 8 | 编译基线,兼容性第一优先级 | class 52 | 本地 clean verify 通过,CI 必测 |
| 11 | 存量项目常用版本 | class 52 | CI 必测 |
| 17 | 推荐运行版本、发布构建 JDK | class 52 | 本地 clean verify 通过,CI 必测 |
| 21 | 当前主流 LTS | class 52 | 本地 clean verify 通过,CI 必测 |
| 25 | 新 LTS,生态跟进中 | class 52 | CI 允许失败(experimental),不阻断发布 |
说明:
- JDK 9+ 构建时使用
release 8,JDK 8 构建时回退到source/target 1.8,两者都会产出 class 52。 - 运行时基线为 Java 8:不使用
List.of、String.isBlank、var、record、switch 表达式、文本块等 Java 9+ 语法与 API。 - 所有直接/传递依赖的基础字节码必须 ≤ 52;允许依赖自身是 multi-release jar(JDK 8 只读取 base 部分)。
# JDK 与 Servlet 规范对应关系
IJPay 3.x 的支付核心(IJPay-Core、IJPay-WxPay、IJPay-AliPay 等)不依赖任何 Servlet 类型。需要原生 HttpServletRequest / HttpServletResponse 时,按容器命名空间选择适配模块:
| 容器 / 框架 | Servlet 命名空间 | Servlet 规范 | IJPay 适配模块 | 基础字节码 |
|---|---|---|---|---|
| Tomcat 9 及以下、Spring Boot 2.x、JFinal、Solon(javax 模式) | javax.servlet | Servlet 4.0 | IJPay-Servlet-Javax | 52 |
| Tomcat 10+、Spring Boot 3.x、Jakarta EE 9+ | jakarta.servlet | Servlet 5.0 | IJPay-Servlet-Jakarta | 52 |
# 为什么 Jakarta 只能用 Servlet 5.0
jakarta.servlet-api:5.0.x的基础字节码为 52(Java 8),可以在 Java 8 基线下编译。jakarta.servlet-api:6.0+(Servlet 6.0/6.1)的基础字节码为 55(Java 11),一旦引入就会破坏「所有产物 class 52」的承诺。- 因此 3.x 的 Jakarta 适配固定使用 Servlet 5.0。Servlet 6.x 能力需要等 IJPay 抬升 Java 基线后,另立模块提供。
Servlet 5.0 与 6.x 在 IJPay 使用到的 API 范围内(请求参数、header、Reader、OutputStream、sendRedirect)行为一致,Servlet 5.0 编译的适配层可以运行在 Tomcat 10.1 / Spring Boot 3.x 等 Servlet 6.0 容器上。
# 模块与坐标(3.0.0)
| 模块 | 说明 | 是否需要 Servlet |
|---|---|---|
IJPay-Core | 核心工具:签名、验签、HTTP、二维码、IP 解析等 | 否 |
IJPay-WxPay | 微信支付(含 API v3) | 否 |
IJPay-AliPay | 支付宝(V2 SDK) | 否 |
IJPay-AliPay-V3 | 支付宝 V3 SDK | 否 |
IJPay-Servlet-Javax | javax.servlet 适配:ServletHttpKit、ServletIpKit、AliPayServletApi | 是(provided) |
IJPay-Servlet-Jakarta | jakarta.servlet 适配:同名三个类 | 是(provided) |
IJPay-Jakarta | Jakarta 聚合依赖(pom),包含常用 trunk 模块与 Jakarta 适配 | 是 |
IJPay-All | javax 聚合包(shade),不包含任何 Servlet 适配类 | 否 |
# 依赖基线说明
为保持 Java 8 兼容,以下依赖停留在最后一个 Java 8 可用版本:
| 依赖 | 当前版本 | 最新版 | 停留原因 |
|---|---|---|---|
com.google.guava:guava | 33.6.0-jre | 33.8.0-jre | 33.7.0 起基础字节码为 53(Java 9) |
org.dom4j:dom4j | 2.1.5 | 2.2.0 | 2.2.0 基础字节码为 55(Java 11) |
com.squareup.okhttp3:okhttp | 4.12.0 | 5.5.1 | 5.x 改为 KMP 拆分 artifact,且与支付宝 SDK 的 4.x 适配存在运行时风险 |
jakarta.servlet:jakarta.servlet-api | 5.0.0 | 6.x | 6.x 基础字节码为 55(Java 11) |
其余依赖(支付宝 SDK、Stripe、Jackson、BouncyCastle、Hutool、fastjson、commons-lang3、SLF4J、commons-codec 等)已升级到当前最新稳定版。
← 资源共享 2.x → 3.x 升级指南 →