安装java警告_maven项目install时候一直报错,检查Maven-javadoc-plugin声明错误(Java 8 配置Maven-javadoc-plugin)或者是:警告: @thro...

在升级JDK至1.8之后,使用Maven-javadoc-plugin插件打包报错,[ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.10.4:jar (attach-javadocs) on project 详细信息如下

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.10.4:jar (attach-javadocs) on project StatisticsReport: MavenReportException: Error while generating Javadoc:

[ERROR] Exit code: 1 - D:\Multi-module-project\StatisticsReport\src\main\java\com\yuewen\statistics\report\service\db\PullData.java:29: 警告: @param 没有说明

[ERROR] @param preparedStatement

[ERROR] ^

[ERROR] D:\Multi-module-project\StatisticsReport\src\main\java\com\yuewen\statistics\report\service\db\PullData.java:30: 警告: @param 没有说明

[ERROR]@param params

[ERROR] ^

[ERROR] D:\Multi-module-project\StatisticsReport\src\main\java\com\yuewen\statistics\report\service\db\PullData.java:31: 警告: @return 没有说明

[ERROR] @return

[ERROR] ^

[ERROR] D:\Multi-module-project\StatisticsReport\src\main\java\com\yuewen\statistics\report\service\db\PullData.java:32: 警告: @throws 没有说明

[ERROR]@throws SQLException

[ERROR] ^

[ERROR] D:\Multi-module-project\StatisticsReport\src\main\java\com\yuewen\statistics\report\service\db\PullData.java:34: 警告: logFlag没有 @param

[ERROR] public static ResultSet pullData(PreparedStatement preparedStatement, boolean logFlag, String… params) throws SQLException {

[ERROR] ^

[ERROR] D:\Multi-module-project\StatisticsReport\src\main\java\com\yuewen\statistics\report\service\db\PullData.java:51: 警告: @param 没有说明

[ERROR] @param preparedStatement

[ERROR] ^

[ERROR] D:\Multi-module-project\StatisticsReport\src\main\java\com\yuewen\statistics\report\service\db\PullData.java:52: 警告: @param 没有说明

[ERROR]@param params

[ERROR] ^

[ERROR] D:\Multi-module-project\StatisticsReport\src\main\java\com\yuewen\statistics\report\service\db\PullData.java:53: 警告: @return 没有说明

[ERROR] * @return

[ERROR] ^

经查得知,在JDK 8中,Javadoc中添加了doclint,而这个工具的主要目的是旨在获得符合W3C HTML 4.01标准规范的HTML文档,在JDK 8中,已经无法获取如下的Javadoc,除非它满足doclint:

不能有自关闭的HTML tags,例如
或者

不能有未关闭的HTML tags,例如有

  • 而没有

不能有非法的HTML end tags,例如

不能有非法的HTML attributes,需要符合doclint基于W3C HTML 4.01的实现

不能有重复的HTML id attribute

不能有空的HTML href attribute

不能有不正确的嵌套标题,例如类的文档说明中必须有

而不是

不能有非法的HTML tags,例如List需要用<>对应的实体符号

不能有损坏的@link references

不能有损坏的@param references,它们必须匹配实际的参数名称

不能有损坏的@throws references,第一个词必须是一个类名称

注意违反这些规则的话,将不会得到Javadoc的输出。

一种解决办法就是关闭doclint,如果你在Maven中运行,你需要使用additionalparam设置:

disable-javadoc-doclint

[1.8,)

-Xdoclint:none

或者是添加到maven-javadoc-plugin中:

org.apache.maven.plugins

maven-javadoc-plugin

2.10.4

${chartset.UTF8}

true

${chartset.UTF8}

${chartset.UTF8}

attach-javadocs

package

jar

-Xdoclint:none

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值