java当javadoc未附加到依赖项时，如何在Maven的eclipse插件中将javadoc引用到依赖项

Question

我在开发中使用Eclipse、Maven和Java。我使用Maven下载依赖项（jar文件和javadoc，如果可用），并使用Maven的eclipse插件生成依赖项。项目和。Eclipse的类路径文件。当下载的依赖项没有附加javadoc时，我会在中手动添加javadoc的链接。类路径文件，以便在Eclipse中查看依赖项的javadoc。然后当我运行Maven的eclipse插件来重新生成。类路径文件，它当然消除了这种变化

有没有办法配置Maven的eclipse插件，以便在运行Maven的eclipse插件时自动为javadoc添加类路径属性

我只对maven存储库中没有为依赖项提供javadoc和/或源代码的答案感兴趣，这对我来说是最常见的情况。使用downloadSources和/或downloadJavadocs属性无助于解决此问题

Answer 1

来自Maven Eclipse插件FAQ

The following example shows how to do this in the command-line:

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

or in your 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>

Answer 2

您可以考虑通过使用^ {A1}手动安装JavaDoc jar并在-dCuulth= JavaDoc选项中传递来完全避免这个问题。一旦你这样做了。mvn生成的类路径应该是正确的

如果您使用远程repo作为central的代理，您还可以将javadocs部署到该repo，那么使用该代理的所有其他人现在也将自动获得javadocs

Answer 3

如How to download sources and javadoc artifacts with Maven Eclipse plugin from other repository?中所述，您可以执行以下操作：

在Eclipse中转到Windows->；偏好->；专家选中“下载工件Javadoc”框这对我很有效

Answer 4

一般来说，Javadocs主要不是用作依赖项。因为这些在编译和运行时都不是必需的。它只是在开发或调试时帮助开发人员

假设使用JavaIDEEclipse，我们可以使用引用的java文档。下面是我们可以将javadocs/源与相应的jar关联的方法

1。如果是非maven项目：

下载javadocsjar或压缩文件（任何可用文件），并将其放在某个目录中。 右键单击IDEEclipse中的应用程序项目，单击属性并选择Java构建路径，然后选择Java构建路径下的选项卡库。现在展开要与java文档/源链接的jar。选择Javadoc位置链接并单击编辑按钮，一个新窗口出现，我们需要在其中选择javadocs jar路径。单击OK，我们已经将javadoc/源代码与相应的jar链接起来

2。如果是maven项目

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

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

3。如果是Maven项目，并且我们正在设置默认行为：

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

单击Windows–preferences–选择Maven并单击复选框Download Artifact Javadoc，如下所示

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

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

第三种方法成本有点高，因为将下载所有依赖JAR的javadoc/源代码，可能您对所有依赖JAR的javadoc/源代码不感兴趣

Answer 5

有依赖关系的来源会有帮助吗？您可以告诉eclipse插件使用-DdownloadSources=true下载这些（并在.classpath中引用它们）

Answer 6

我正在运行STS2.8.1，它基本上是eclipse+spring工具；在现有的maven项目中，我右键单击该项目->；maven->；下载源代码并下载JavaDocs