参数 --add-opens
用于在运行时开放模块和包,允许反射访问它们的内部实现。
为什么需要这个参数?
在 Java 9 及以后版本中,引入了模块系统(Project Jigsaw),通过模块化来增强 Java 平台的可维护性和安全性。默认情况下,模块化系统会对模块内部的实现细节进行封装,防止外部模块通过反射等方式访问这些内部细节。
然而,有些库或应用程序需要通过反射访问某些内部 API,这时可以使用 --add-opens
参数来显式地开放这些内部 API。
具体到命令,--add-opens java.base/java.util.concurrent.atomic=ALL-UNNAMED
的作用是允许运行在未命名模块(通常是类路径)中的代码反射访问 java.util.concurrent.atomic
包中的内部类和成员。这在某些情况下是必要的,例如某些代理库、AOP 框架或监控工具可能需要访问这些内部实现以增强或修改现有的行为。
示例
假设你的应用程序使用了某个第三方库,这个库在 Java 9 之前通过反射访问 java.util.concurrent.atomic
包中的某些类或成员来实现功能。如果直接在 Java 9 或更高版本上运行,不使用 --add-opens
参数,可能会遇到类似于 IllegalAccessException
的异常。通过添加 --add-opens
参数,可以允许这种访问继续进行,从而确保应用程序的兼容性和正常运行。
总结
在你的命令中:
CMD ["java", "--add-opens", "java.base/java.util.concurrent.atomic=ALL-UNNAMED", "-jar", "/opt/agent/agent-0.0.1-SNAPSHOT.jar"]
--add-opens java.base/java.util.concurrent.atomic=ALL-UNNAMED
确保了 agent-0.0.1-SNAPSHOT.jar
可以通过反射访问 java.util.concurrent.atomic
包中的类和成员,避免了由于模块化系统的封装机制带来的访问限制问题。这通常是为了兼容某些需要访问内部 API 的库或工具。