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