source - spring boot java 11




當Javadoc標籤不完整時,Maven在Java 8中不工作 (10)

由於我使用Maven,我已經能夠在我的本地存儲庫項目中構建和安裝Javadoc標籤不完整(例如缺少參數)。

然而,自從我遷移到Java 8(1.8.0-ea-b90)以來,Maven對於缺失的文檔標籤是絕對嚴格的,並且當我嘗試構建或安裝Javadoc不是Javadoc的項目時,顯示出與Javadoc問題相關的大量Javadoc錯誤“完善”。 我試圖編譯並安裝在本地存儲庫中的一些項目是我無法控制的第三方項目。 所以,在所有這些項目中修復所有Javadoc的解決方法在我的方案中似乎並不可行。

這是我在我的項目中執行mvn clean package install時看到的輸出的一小部分:

[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 9.026s
[INFO] Finished at: Mon Apr 08 21:06:17 CEST 2013
[INFO] Final Memory: 27M/437M
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.9:jar (attach-javadocs) on project jpc: MavenReportException: Error while creating archive:
[ERROR] Exit code: 1 - /Users/sergioc/Documents/workspaces/heal/jpc/src/main/java/org/jpc/engine/prolog/PrologDatabase.java:10: error: @param name not found
[ERROR] * @param terms the terms to assert
[ERROR] ^
[ERROR] /Users/sergioc/Documents/workspaces/heal/jpc/src/main/java/org/jpc/engine/prolog/PrologDatabase.java:11: warning: no description for @return
[ERROR] * @return
[ERROR] ^

Javadoc Maven插件在我的POM中是這樣配置的:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.9</version>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <goals>
                <goal>jar</goal>
            </goals>
        </execution>
    </executions>
</plugin>

正如我之前所說的,如果我回到Java 7,一切工作都很好。也許這是一個與在Java 8中運行的Maven相關的錯誤? 我如何使用Java 8使其工作(即能夠構建項目的Javadoc並將其代碼安裝在本地存儲庫中)? 我已經在OSX中使用Maven 3.0.3和3.0.5進行了測試。

更新:

如果我使用<failOnError>false</failOnError>更改我的Javadoc插件配置(感謝Martin):

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.9</version>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <goals>
                <goal>jar</goal>
            </goals>
        </execution>
    </executions>
</plugin>

然後該項目安裝在我的本地存儲庫中。 但是,Javadoc JAR仍未生成。

我在控制台中看到的輸出的一個片段是:

[錯誤] MavenReportException:創建歸檔時出錯:退出代碼:1 - /Users/....java:18:warning:no @param ...命令行為:/ Library / Java / Home / bin / javadoc @options @packages

參考'/ Users / sergioc / Documents / workspaces / heal / minitoolbox / target / apidocs'目錄中生成的Javadoc文件。

在org.apache.maven.plugin處的org.apache.maven.plugin.javadoc.AbstractJavadocMojo.executeReport(AbstractJavadocMojo.java:1990)上的org.apache.maven.plugin.javadoc.AbstractJavadocMojo.executeJavadocCommandLine(AbstractJavadocMojo.java:5043) .javadoc.JavadocJar.execute(JavadocJar.java:181)at org.apache.maven.plugin.DefaultBuildPluginManager.executeMojo(DefaultBuildPluginManager.java:101)at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java :209)在org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:145)上的org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:153)。在org.apache.maven.lifecycle.internal.LifecycleStarter的org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(LifecycleModuleBuilder.java:59)中的maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(LifecycleModuleBuilder.java:84)。在org.apache.maven.lifecycle.internal.Lifecyc的singleThreadedBuild(LifecycleStarter.java:183) lestarter.execute(LifecycleStarter.java:161)at org.apache.maven.DefaultMaven.doExecute(DefaultMaven.java:320)at org.apache.maven.DefaultMaven.execute(DefaultMaven.java:156)at org.apache.maven .cli.MavenCli.execute(MavenCli.java:537)at org.apache.maven.cli.MavenCli.doMain(MavenCli.java:196)at org.apache.maven.cli.MavenCli.main(MavenCli.java:141 )at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:57)at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)at java.lang.reflect。在org.codehaus.plexus.classworlds.launcher.Launcher.launch(Launcher.java: 230)at org.codehaus.plexus.classworlds.launcher.Launcher.main(Launcher.java:352)org.codehaus.plexus.classworlds.launcher.Launcher.mainWithExitCode(Launcher.java:409)

有關如何構建源代碼的任何解決方法,安裝項目並在與Java 7一起工作時一步生成Javadoc JAR?


可用於任何Java版本的最短解決方案:

<profiles>
    <profile>
        <id>disable-java8-doclint</id>
        <activation>
            <jdk>[1.8,)</jdk>
        </activation>
        <properties>
            <additionalparam>-Xdoclint:none</additionalparam>
        </properties>
    </profile>
</profiles>

只需將它添加到你的POM中,你就可以走了。

這基本上是@ ankon的回答加@ zapp 的答案 。

對於maven-javadoc-plugin 3.0.0用戶:

更換

<additionalparam>-Xdoclint:none</additionalparam>

通過

<doclint>none</doclint>


下面添加

JAVA_TOOL_OPTIONS = -DadditionalJOption = -Xdoclint:無

進入Jenkins作業配置>構建環境>將環境變量注入構建過程>屬性內容

通過Jenkins Maven解決了我的代碼構建問題:-)


使用java 8和java 7工作的最簡單方法是在構建中使用配置文件:

<profiles>
  <profile>
    <id>doclint-java8-disable</id>
    <activation>
      <jdk>[1.8,)</jdk>
    </activation>

    <build>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-javadoc-plugin</artifactId>
          <configuration>
            <additionalparam>-Xdoclint:none</additionalparam>
          </configuration>
        </plugin>
      </plugins>
    </build>
  </profile>
</profiles>

僅覆蓋maven-javadoc-plugin配置,不能解決mvn site的問題(例如在發布階段使用)。 這是我必須做的事情:

<profile>
  <id>doclint-java8-disable</id>
  <activation>
    <jdk>[1.8,)</jdk>
  </activation>
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <configuration>
          <additionalparam>-Xdoclint:none</additionalparam>
        </configuration>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-site-plugin</artifactId>
        <version>3.3</version>
        <configuration>
          <reportPlugins>
            <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-javadoc-plugin</artifactId>
              <configuration>
                <additionalparam>-Xdoclint:none</additionalparam>
              </configuration>
            </plugin>
          </reportPlugins>
        </configuration>
      </plugin>
    </plugins>
  </build>
</profile>

您可以嘗試將failOnError屬性(請參閱插件文檔 )設置為false

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.9</version>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <goals>
                <goal>jar</goal>
            </goals>
            <configuration>
              <failOnError>false</failOnError>
            </configuration>
        </execution>
    </executions>
</plugin>

正如您從文檔中看到的,默認值為true


我不確定這是否會有所幫助,但即使我最近使用oozie-4.2.0版本也面臨同樣的問題。 閱讀完上面的答案後,我剛剛通過命令行添加了maven選項,它對我很有幫助。 所以,只是在這里分享。

我正在使用java 1.8.0_77 ,還沒有嘗試過使用java 1.7

bin / mkdistro.sh -DskipTests -Dmaven.javadoc.opts =' - Xdoclint:-html'


我對派對有點遲,但我也被迫搜索解決方法,最終在這裡找到了,然後找到了它。

以下是對我有用的東西: -

export JAVA_TOOL_OPTIONS=-DadditionalJOption=-Xdoclint:none

然後開始你的Maven構建,任何Linux發行版等等。它的好處是它不需要Maven 配置文件修改 - 我無法做到這一點,因為我的目標是重建一堆Centos rpm包,所以不得不走得很深。


我想補充一些其他答案的見解

就我而言

-Xdoclint:無

沒有工作。

首先,在我的項目中,我根本不需要javadoc。 只有一些必要的插件獲得了構建時間依賴性。

所以,解決我的問題最簡單的方法是:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <configuration>
        <skip>true</skip>
    </configuration>
</plugin>

添加到pom文件的全局屬性部分:

<project>
    ...
    <properties>
        <additionalparam>-Xdoclint:none</additionalparam>
    </properties>

在其他答案(在插件部分中添加屬性)中提供的常見解決方案由於某些原因而不起作用。 只有通過全局設置,我才能成功構建javadoc jar。


由於它取決於用於運行maven命令的JRE版本,因此您不希望在默認情況下在pom.xml中禁用DocLint

因此,從命令行可以使用開關-Dadditionalparam=-Xdoclint:none

例如: mvn clean install -Dadditionalparam=-Xdoclint:none





javadoc