java - JDK是否缺少某些源文件？

Question

我使用 Eclipse (Luna) 和 JDK 8 update 5，并且我已经开始学习 JavaFX。我在 javafx.scene.media 包中使用 JavaFX 媒体播放 - Media、MediaPlayer、MediaView 等类 - 我注意到这些类中的任何一个都没有附加 Javadoc:“注意:此元素的 Javadoc 可以在附加的源代码和附加的 Javadoc 中都找不到。”其他 JavaFX 包中的所有类似乎都很好，并且它们的 Javadocs 都已正确附加。 javafx.scene.media 中还有 4 个工作正常的类 - AudioClipBuilder、MediaBuilder、MediaPlayerBuilder 和 MediaViewBuilder(这 4 个类已弃用...) - 但其余的缺少 Javadocs。

我查看了 jfxrt.jar 的设置，它的 Javadoc 位置:http://docs.oracle.com/javase/8/docs/api/源附件是JDK中的“javafx-src.zip”。我检查了 javafx-src.zip 中的源文件，javafx/scene/media 中唯一的文件是 4 个已弃用的正在运行的 Builder 类。这就解释了为什么这 4 个类都有可用的 Javadocs，但我的问题是:为什么包中的其余类缺少源文件？ (有人知道还有其他类缺少源文件吗？)我重新安装了 JDK，但它们仍然消失了。

此外，即使源文件丢失，为什么 Eclipse 仍然无法找到 javadocs，因为 http://docs.oracle.com/javase/8/docs/api/是否设置为 javadoc 位置？

Answer 1

看来您所看到的情况只是内部 Oracle JavaFX 发行版构建过程中的临时错误和疏忽，将在未来版本中进行纠正:

• RT-37790: REGRESSION: Various source files are missing from javafx-src.zip
• RT-33865: REGRESSION: Media javadoc is missing

链接的问题跟踪器需要注册，但任何人都可以注册以在引用的链接中查看问题。

Eclipse 在 http://docs.oracle.com/javase/8/docs/api/ 处找不到 JavaFX JavaDocs ，因为文档不存在。目前 JavaFX 文档未与 Java 8 文档集成。 JavaFX API 文档链接为 Java 8 client technologies page指向http://docs.oracle.com/javase/8/javafx/api/ ，(奇怪的是，这个链接在 Internet Explorer 中为我解析，但在 Firefox 中则不然)。我可以看到 JavaFX Media 类的文档就在那里。

我不是 Eclipse/e(fx)clipse 用户，因此我不确定以下内容，但我建议更新您的 Eclipse javadoc 配置 URL 以包含 JavaFX API 链接。如果您使用e(fx)clipse tools，则有可能，这些工具可能会为您配置正确的 javadoc 位置。