当JavaDoc标签不完整时,Maven不能在Java 8中工作

问题:

由于我使用Maven,我已经能够在我的本地存储库项目中构建并安装了不完整的Javadoc标签(例如,缺少的参数)。
但是,由于我迁移到Java 8(1.8.0-ea-b90),Maven对于缺少文档标签是绝对严格的,并且在我尝试构建或安装Javadoc不是的项目时,显示出与Javadoc问题相关的许多Javadoc错误“完善”。我试图在本地存储库中编译和安装的一些项目是我没有控制权的第三方项目。因此,在所有这些项目中修复所有Javadocs的解决方法似乎在我的方案中是不可行的。
这是我在项目中执行mvn clean package install时看到的输出的一小部分:
class=”lang-none prettyprint-override”>

[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中进行了配置:
class=”lang-xml prettyprint-override”>

<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):
class=”lang-xml prettyprint-override”>

<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:否@param …命令行为:/ Library / Java / Home / bin / javadoc @options @packages
请参阅’/ Users / sergioc / Documents / workspaces / heal / minitoolbox / target / apidocs’目录中生成的Javadoc文件。
在org.apache.maven.plugin.javadoc.AbstractJavadocMojo.executeJavadocCommandLine(AbstractJavadocMojo.java:5043)在org.apache.maven.plugin.javadoc.AbstractJavadocMojo.executeReport(AbstractJavadocMojo.java:1990)在org.apache.maven.plugin .javadoc.JavadocJar.execute(JavadocJar.java:181)在org.apache.maven.plugin.DefaultBuildPluginManager.executeMojo(DefaultBuildPluginManager.java:101)在org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java :209)在org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:153)在org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:145)在org.apache。在org.apache.maven.lifecycle.internal.LifecycleStarter上的org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(LifecycleModuleBuilder.java:59)上的maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(LifecycleModuleBuilder.java:84)。 singleThreadedBuild(LifecycleStarter。在org.apache.maven.DefaultMaven中的org.apache.maven.DefaultMaven.doExecute(DefaultMaven.java:320)上的org.apache.maven.lifecycle.internal.LifecycleStarter.execute(LifecycleStarter.java:161)上的java:183) org.apache.maven.cli.MavenCli.doMain(MavenCli.java:196)在org.apache.maven.cli.MavenCli.execute(MavenCli.java:537)上的.execute(DefaultMaven.java:156)。 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。在org.codehaus.plexus.classworlds.launcher.Launcher.launchEnhanced(Launcher.java:290)在org.codehaus()调用(DelegatingMethodMethodAttributeImpl.java:43)java.lang.reflect.Method.invoke(Method.java:491) .plexus.classworlds.launcher.Launcher.launch(Launcher.java:230)在org.codehaus.plexus.classworlds.launcher.Launcher.mainWithExitCode(Launcher.j ava:409)在org.codehaus.plexus.classworlds.launcher.Launcher.main(Launcher.java:352)

关于如何构建源代码的任何解决方法,安装项目并在Java 7中使用Javadoc JAR一步生成?

回答:

最好的解决方案是修复javadoc错误。如果由于某种原因不可能(即:自动生成的源代码),则可以禁用此检查。
 DocLint is a new feature in Java 8,总结如下:

提供一种在开发周期早期发现Javadoc评论中错误的方法,并且可以轻松地链接回源代码。

默认情况下启用,并在生成Javadoc之前运行大量检查。您需要为指定的in this thread关闭Java 8。您必须将其添加到您的maven配置中:

<profiles>
  <profile>
    <id>java8-doclint-disabled</id>
    <activation>
      <jdk>[1.8,)</jdk>
    </activation>
    <properties>
      <javadoc.opts>-Xdoclint:none</javadoc.opts>
    </properties>
  </profile>
</profiles>
<build>
  <plugins>
    <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>
                    <additionalparam>${javadoc.opts}</additionalparam>
                </configuration>
            </execution>
        </executions>
    </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>${javadoc.opts}</additionalparam>
              </configuration>
            </plugin>
          </reportPlugins>
        </configuration>
      </plugin>
   </plugins>
</build>

 
 
Code问答: http://codewenda.com/topics/python/
Stackoverflow: Maven is not working in Java 8 when JavaDoc tags are incomplete

*转载请注明本文链接以及stackoverflow的英文链接

发表评论

电子邮件地址不会被公开。 必填项已用*标注

− 4 = 6