maven项目install时候一直报错,检查Maven-javadoc-plugin声明错误(Java 8 配置Maven-javadoc-plugin)
2017-12-07 13:44
417 查看
在升级JDK至1.8之后,使用
(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,例如
不能有损坏的
不能有损坏的
不能有损坏的
注意违反这些规则的话,将不会得到Javadoc的输出。
一种解决办法就是关闭doclint,如果你在Maven中运行,你需要使用
或者是添加到
(转自)本文链接: http://www.codepub.cn/2016/10/18/Java-8-configure-maven-java-doc-plugin/
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,例如
<br/>或者
<a id="x"/>
不能有未关闭的HTML tags,例如有
<ul>而没有
</ul>
不能有非法的HTML end tags,例如
</br>
不能有非法的HTML attributes,需要符合doclint基于W3C HTML 4.01的实现
不能有重复的HTML id attribute
不能有空的HTML href attribute
不能有不正确的嵌套标题,例如类的文档说明中必须有
<h3>而不是
<h4>
不能有非法的HTML tags,例如
List<String>需要用
<>对应的实体符号
不能有损坏的
@link references
不能有损坏的
@param references,它们必须匹配实际的参数名称
不能有损坏的
@throws references,第一个词必须是一个类名称
注意违反这些规则的话,将不会得到Javadoc的输出。
一种解决办法就是关闭doclint,如果你在Maven中运行,你需要使用
additionalparam设置:
1234567891011 | <profiles> <profile> <id>disable-javadoc-doclint</id> <activation> <jdk>[1.8,)</jdk> </activation> <properties> <additionalparam>-Xdoclint:none</additionalparam> </properties> </profile></profiles> |
maven-javadoc-plugin中:
1234567891011121314151617181920212223 | <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <version>2.10.4</version> <configuration> <encoding>${chartset.UTF8}</encoding> <aggregate>true</aggregate> <charset>${chartset.UTF8}</charset> <docencoding>${chartset.UTF8}</docencoding> </configuration> <executions> <execution> <id>attach-javadocs</id> <phase>package</phase> <goals> <goal>jar</goal> </goals> <configuration> <additionalparam>-Xdoclint:none</additionalparam> </configuration> </execution> </executions></plugin> |
相关文章推荐
- java项目,配置maven,编译项目
- Java Maven linux 配置 --避免Gem space 错误
- ssh 返回错误 Too many authentic authentication failures for root 的时候检查 ssh 配置
- 配置java的maven项目下的ssh框架
- 1.Maven+SpringMVC+Eclipse软件安装配置,Maven报插件错误,Eclipse总是卡死的解决办法,导入一个maven工程后 一直显示importing maven project
- Maven构建项目后项目报Error错误Java compiler level does not match the version of the installed Java project fac
- maven mvn 3.0 以上 运行 mvn install的时候 java.lang.NoClassDefFoundError 错误的解决办法。
- Maven编译打包项目 mvn clean install 遇到的错误
- eclipse进行Debug的时候,发出“java breakpoint unable to install breakpoint”错误
- 运行 maven install的时候出现错误 not a jre
- 在POM配置Maven plugin提示错误“Plugin execution not covered by lifecycle configuration”的解决方案
- Maven 创建项目的时候 [INFO] The plugin 'org.apache.maven.plugins:maven-archetype-plugin' does not exist or no valid version could be fo
- IntelliJ IDEA14.1中java项目Maven中没有配置JDK时的问题
- Maven java web 项目 单元测试 报 class not found 错误
- 如何解决maven搭建项目的时候,src/main/java无法建立的问题,提示信息The folder is already a source folder.(文件夹已经是源文件夹。)
- maven项目编译漏掉src/main/java下的xml配置文件
- 项目启动的时候报错:java.lang.IllegalStateException,需要配置webAppRootKey
- IntelliJ IDEA14.1中java项目Maven中没有配置JDK时的问题
- 在导入maven项目时出现maven-compiler-plugin:2.3.2:compile插件的错误
- 安装php WampServer之后,运行的时候报错“phpMyAdmin - 错误 缺少 mysqli 扩展。请检查 PHP 配置。”