53

我在开发中使用 Eclipse、Maven 和 Java。我使用 Maven 下载依赖项(jar 文件和可用的 javadoc)和 Maven 的 eclipse 插件来为 Eclipse 生成 .project 和 .classpath 文件。当下载的依赖项没有附加 javadoc 时,我在 .classpath 文件中手动添加了 javadoc 的链接,以便我可以在 Eclipse 中看到依赖项的 javadoc。然后,当我运行 Maven 的 eclipse 插件来重新生成 .classpath 文件时,它当然会消除该更改。

有没有办法配置Maven的eclipse插件在运行Maven的eclipse插件时自动为javadoc添加classpath属性?

我只对没有为 maven 存储库中的依赖项提供 javadoc 和/或源的答案感兴趣,这对我来说最常见。使用 downloadSources 和/或 downloadJavadocs 属性不会解决这个问题。

4

6 回答 6

43

来自 Maven Eclipse 插件常见问题解答

以下示例显示了如何在命令行中执行此操作:

mvn eclipse:eclipse -DdownloadSources=true  -DdownloadJavadocs=true 

或在您的 pom.xml 中:

<project>
  [...]
  <build>
    [...]
    <plugins>
      [...]
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-eclipse-plugin</artifactId>
        <configuration>
          <downloadSources>true</downloadSources>
          <downloadJavadocs>true</downloadJavadocs>
        </configuration>
      </plugin>
      [...]
    </plugins>
    [...]
  </build>
  [...]
</project>
于 2008-09-18T21:26:57.447 回答
29

我正在运行 STS 2.8.1,它基本上是 eclipse + spring 工具;在现有的 maven 项目中,我右键单击项目 -> maven -> 下载源和下载 JavaDocs

于 2012-02-07T12:24:42.663 回答
25

如何使用 Maven Eclipse 插件从其他存储库下载源代码和 javadoc 工件中所述?, 你可以这样做:

在 Eclipse 中转到 Windows-> 首选项-> Maven。选中“下载 Artifact Javadoc”框。这对我来说效果很好。

Maven 偏好

于 2014-06-19T19:37:08.630 回答
17

您可以考虑通过使用install-file 目标手动将 javadoc jar 安装到本地存储库并传入 -Dclassifier=javadoc 选项来完全避免此问题。一旦你这样做了,mvn 生成的 .classpath 应该是正确的。

如果您使用远程 repo 作为中央代理,您还可以将 javadocs 部署到该 repo,然后使用该代理的其他所有人现在也将自动获取 javadocs。

于 2008-09-27T04:15:29.997 回答
4

通常 Javadocs 不主要用作依赖项。因为这些在编译和运行时都不需要。只是为了在开发或调试时帮助开发人员。

假设使用 java IDE Eclipse,我们可以使用引用的 java 文档。以下是我们可以将 javadocs/sources 与相应的 jar 关联的方法。

1.如果是非maven项目:

下载 javadocs jar 或压缩文件,无论是否可用,并将其放在某个目录中。右键单击 IDE Eclipse 中的应用程序项目,单击 Properties 并选择 Java Build Path,然后选择 Java Build Path 下的标签 Libraries。现在展开您要与 java docs/source 链接的 jar。选择 Javadoc 位置链接并单击编辑按钮,将出现一个新窗口,我们需要在其中选择 javadocs jar 路径。单击确定,我们已将 javadoc/source 与相应的 jar 链接起来。

在此处输入图像描述

2.如果是maven项目

如果我们使用的是 Maven 项目,则在 Project Explorer 视图中的项目下的 Maven 依赖项下的 jar 文件,如下所示。现在右键单击要添加 Javadoc/源的 jar 文件, 选择 Maven,然后单击要与项目链接的 Javadoc 或源。现在 IDE 将自动下载所需的 javadoc/source 并将其与项目中的相应 jar 链接。

在此处输入图像描述

您可以通过右键单击IDE中的项目并单击Java Build Path并选择Java Build Path下的Libraries选项卡然后展开所需的jar来验证这一点,当您单击Edit按钮时,您将看到链接的路径带有相应 jar 的 Javadoc/Source,如下图所示。

在此处输入图像描述

3. 如果是 Maven 项目并且我们正在设置默认行为:

Eclipse 将在开始时下载 javadoc/source 以及所需的主要 jar。默认情况下,Maven 设置指令下载项目中链接的所有 jar 的 Javadoc/源。

点击 Windows - 首选项 - 选择 Maven 并点击复选框 Download Artifact Javadoc 如下图所示

在此处输入图像描述

现在单击应用并保存它,现在当您创建新的 Maven 项目时,默认情况下 Javadocs 将被下载并与项目中的所有依赖 jar 链接。
您可以通过右键单击项目和属性进行验证,在 Java Build 路径下可以看到 javadocs 与所有 jar 链接,如下所示。

在此处输入图像描述

如果您的项目是 Maven 项目,那么最好使用第二种方法,因为通过使用这种方法,IDE 和 Maven 会负责下载 Javadoc/源的正确版本并将其与相关 jar 链接。

方法 3rd 有点昂贵,因为将为所有依赖 jar 下载 javadoc/sources,可能您对所有依赖 jars 的 javadocs/sources 不感兴趣。

于 2017-04-09T08:16:32.927 回答
-2

有依赖的来源会有所帮助吗?您可以告诉 eclipse 插件下载这些(并在 .classpath 中引用它们)-DdownloadSources=true

于 2008-09-04T18:30:18.910 回答