JEP 106:将 Javadoc 添加到 javax.tools
概括
扩展javax.tools
API 以提供对 javadoc 的访问。
动机
人们越来越普遍希望通过 API 调用工具作为更大软件环境的一部分,而不是通过执行新流程。这通过避免启动额外的 JVM 的需要并提供用于更类型安全的调用的 API 来提高性能。
描述
API 的更改相对较小,但新方法背后的实现涉及对现有实现的一定程度的重构。主要任务是将 的所有现有用途更改java.io.File
为 的相应用途javax.tools.FileObject
。大部分工作已经在 JDK 7 中完成,但由于可能依赖于新的 NIO API,剩余 的工作不得不推迟。
测试
将提供单元(jtreg)测试来练习新功能。不会有任何特定于平台的要求。
风险和假设
一般来说,javadoc 是非常古老的代码,很长一段时间以来都没有太多的 TLC。存在重构不会像预期那么简单的风险。
依赖关系
到目前为止,可能存在对新 NIO API 的依赖,但现在它已在 JDK 7 中可用。
影响
- JCP:JSR 199 的维护审查
- 兼容性:最小
- 文档:仅限 API 文档
- 国际化:最小
- 本地化:最小