JDK 7升8 maven 编译报错

在JDK由版本7升级到8时，使用maven编译会报doc错误，原因是JAVA8不支持JAVA7编写的doc，报错信息如下：

@param name 未找到
@return 的用法无效

可以使添加配置-Xdoclint:none，忽略这个问题

如果使用的maven-javadoc-plugin版本在3.0.0以前，配置如下：

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

3.0.0以后，可以使用如下配置：

  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-javadoc-plugin</artifactId>
      <configuration>
        <doclint>none</doclint>
      </configuration>
    </plugin>
  </plugins>

Ant可以使用additionalparam配置，参考http://ant.apache.org/manual/Tasks/javadoc.html

Gradle不支持additionalparam配置，可以使用如下方式：

  if (JavaVersion.current().isJava8Compatible()) {
    allprojects {
      tasks.withType(Javadoc) {
        options.addStringOption('Xdoclint:none', '-quiet')
      }
    }
  }

 

转载于:https://www.cnblogs.com/yytxdy/p/11457550.html