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

Question

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

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

此外，即使缺少源文件，为什么 Eclipse 仍然无法找到 javadoc，因为 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 位置。