如何通过 requires static 可选依赖实战优化编译期变量关联并降低运行时的包体积

老静吖_7666

老静吖_7666

2026-05-18

443人浏览

原创

requires static的核心目标是解耦编译期类型引用与运行时模块强制存在,确保编译通过且运行时可选——如SLF4J API编译必需、实现模块运行可无,配合uses和ServiceLoader实现安全插拔。

如何通过 requires static 可选依赖实战优化编译期变量关联并降低运行时的包体积

用 requires static 声明可选依赖,核心目标不是“减少包体积”本身,而是解耦编译期类型引用与运行时模块强制存在之间的绑定关系。它不直接删代码、不压缩 JAR,但能让你在保留扩展能力的同时,避免把插件类、调试工具、非主干功能的模块硬塞进最终部署包中。

明确哪些场景适合 requires static

这类依赖的本质是:编译时必须看见类型定义(否则编译失败),但运行时可以没有——只要你的代码逻辑能安全绕过它们。典型适用情况包括:

  • 日志门面(如 SLF4J API):编译需要 Logger 类型,但运行时可用 JUL、Log4j2 或不加载任何实现
  • 插件接口定义(如 Processor、ExtensionPoint):主模块声明服务契约,扩展模块按需提供,不部署时不影响启动
  • 测试/诊断辅助类(如 JUnit 扩展、Micrometer 指标桥接):仅在特定环境启用,生产镜像里不打包对应实现模块

module-info.java 中的正确写法

关键不是加不加 static,而是搭配 uses 或运行时条件判断,形成闭环。例如:

module com.example.service {
    requires java.base;
    requires static org.slf4j;           // 编译期需要 API,运行期不要求实现
    uses org.slf4j.spi.SLF4JServiceProvider; // 声明 SPI,让 JVM 在有实现时自动发现
}

注意:requires static 本身不触发类加载;真正决定是否加载实现模块的是 uses + ServiceLoader 调用时机,或你手动写的 Class.forName(...) 包裹在 try-catch 中。

Synths.Video
Synths.Video

Synths.Video是一款将文章、博客和文字脚本转换为 AI 主播视频的内容自动化工具。

下载

配合构建工具控制实际打包内容

Java 模块系统只管“能否加载”,不管“是否打进最终产物”。要真正降低运行时包体积,需在构建阶段剔除未使用的模块:

  • 使用 jlink 构建自定义运行时镜像时,只包含 --add-modules 明确列出的模块,requires static 的模块默认不会被递归加入
  • Gradle/Maven 构建中,把可选依赖设为 compileOnly(Maven 的 provided)或通过 profile 控制 scope,确保它们不出现在 runtime classpath/module-path
  • Android 项目中,若用到 Jetpack 组件的可选集成(如 androidx.benchmark),应放在 debugImplementation 下,而非 implementation,避免打入 release APK

验证是否生效的关键检查点

光写对 module-info.java 不够,必须确认三点:

  • 编译能过:引入了 org.slf4j.Logger 等类型,且没报“package not visible”
  • 运行时不报 NoClassDefFoundError:删除对应实现模块(如 slf4j-simple.jar)后,应用仍能启动(前提是没执行到实际调用日志的路径)
  • 运行时行为可控:通过 ServiceLoader.load() 返回空列表,或用 Optional.ofNullable(...) 封装可选逻辑,避免 NPE 或硬崩溃

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

require函数

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

11277

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

8402

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7232

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1204

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

968

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1456

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2969

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20231

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1315

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134万人学习