跳到主要内容

JEP 106：在 javax.tools 中添加 Javadoc

QWen Max 中英对照

概述​

扩展 javax.tools API 以提供对 javadoc 的访问。

动机​

通过 API 调用工具的情况日益普遍，这是大型软件环境的一部分，而不是通过启动新进程来执行。这样可以避免启动额外的 JVM，从而提升性能，并且提供了更安全的调用 API。

描述​

API 的改动相对较小，但新方法背后的实现涉及对现有实现进行一定程度的重构。主要任务是将所有现有的 java.io.File 用法更改为相应的 javax.tools.FileObject 用法。这项工作的很大一部分已经在 JDK 7 中完成，但由于可能依赖新的 NIO API，剩余的工作不得不推迟。

测试​

将提供单元（jtreg）测试来检验新功能。不会有特定平台的要求。

风险与假设​

一般来说，javadoc 是非常古老的代码，很长一段时间没有进行过太多的维护。重构可能不像预期的那样简单，存在一定的风险。

依赖​

到目前为止，可能已经依赖了新的 NIO API，但该 API 现在已经在 JDK 7 中提供。

影响​

  • JCP：JSR 199 的维护审查
  • 兼容性：最小化
  • 文档：仅 API 文档
  • 国际化：最小化
  • 本地化：最小化