跳到主要内容

JEP 106:将 Javadoc 添加到 javax.tools

概括

扩展javax.toolsAPI 以提供对 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 文档
  • 国际化:最小
  • 本地化:最小