1

我正在开发大型 Java 企业软件（如果您介意的话，可以使用MatrixOne / ENOVIA V6）。维护人员提供了某种 Javadoc，它看起来很普通的 Javadoc，我可以在浏览器中将其作为 HTML 阅读。

但是，我无法将它集成到 Eclipse 中，这很痛苦，因为我必须往返于我的浏览器。在 Eclipse 中，我只是害怕Note: This element neither has attached source nor attached Javadoc and hence no Javadoc could be found.： 在此处输入图像描述

在了解到可以在项目和.jar级别定义 Javadoc 之后，我尝试同时执行这两种操作，因为我知道：

  1. javadoc 文件夹包含一个package-list文件，它似乎合理地定义了文档包
  2. javadoc 文件夹包含典型的文件夹/子文件夹包结构，它本身包含ClassName.html文件。例如com.matrixone.apps.domain，我的文件的行与包含大量文件package-list的结构匹配com/matrixone/apps/domainClassName.html
  3. javadoc 文件夹不包含index.html文件

当我尝试定义我的 Javadoc 时，Validate...由于缺少index.html. 然后，如果我创建一个虚拟index.html文件，则验证有效，但在悬停供应商类/方法时我仍然看不到 Javadoc。

所以我的问题是：让这个倾斜的 Javadoc 在 Eclipse 中显示缺少什么？我此时看到的子问题是：

  1. 创建一个虚拟index.html文件是个坏主意吗？如果是，我该怎么办？（即 Eclipse 期望什么标签/元信息？）
  2. 对标准 Javadoc 文件 ( String.html) 与其中一个供应商 Javadoc ( DomainObject.html) 的快速比较表明，我的 javadoc 中没有 Eclipse 可能使用的元信息。例如，我的供应商 Javadoc 不包含 Javadoc 中存在的许多<meta>标签。 →有人知道Eclipse 用于获取方法/类 Javadoc 的逻辑/启发式方法吗？也许指向我的代码？有了这些信息，我或许能够找出我的 Javadoc 出了什么问题，并希望能够修复它。String.html<head>
  3. 如果您遇到过类似的问题，您认为合适的任何东西。

我目前在 Windows 7 下的 Java 7 上使用 Eclipse Juno SR1。

当然，请随时发表评论以询问我忘记包含的信息。谢谢你的帮助！

4

1 回答 1

1

我有类似的问题；但是，我没有尝试通过使用 JavaDoc for JDOM 的本地副本来解决它。相反，我尝试使用适当的 URL（当前 JDOM 版本的 JavaDoc URL 是http://jdom.org/docs/apidocs/）。因此，在我的 Eclipse 项目的 Java 构建路径配置中的 jdom.jar 库上，我配置了 URL 并点击了验证按钮。Eclipse 似乎认为它是有效的，但我仍然遇到同样的错误，即没有任何附加的 JavaDoc。

然后我发现 jdom.org 也有用于旧版本 JDOM 的 JavaDoc ( http://www.jdom.org/docs/apidocs.1.1/ )。因此，我在 jdom.jar 库 JavaDoc 配置上进行了尝试，并且成功了！

我学到的教训是，当 Eclipse 决定是否使用配置的 JavaDoc 时（考虑是否附加），库的版本似乎被考虑在内。 确保库版本与库的 JavaDoc 版本相匹配（现在我已经找到它似乎很明显）。

希望这可以帮助。

于 2013-08-13T18:37:16.887 回答