扣丁学堂解析Maven在Java8下如何忽略Javadoc编译错误详解

2018-08-24 14:45:21 466浏览

今天扣丁学堂Java培训老师给大家介绍一下关于Maven在Java8下如何忽略Javadoc的编译错误，下面我们通过示例代码一起来看一下吧。

(一)Java注释类型

//用于单行注释。

/*...*/用于多行注释，从/*开始，到*/结束，不能嵌套。

/**...*/则是为支持jdk工具javadoc.exe而特有的注释语句。

说明：javadoc工具能从java源文件中读取第三种注释，并能识别注释中用@标识的一些特殊变量（见表），制作成Html格式的类说明文档。javadoc不但能对一个java源文件生成注释文档，而且能对目录和包生成交叉链接的html格式的类说明文档，十分方便。

(二)JavaDoc中出现的@字符及其意义：

Java8对JavaDoc的语法检查非常严格，我在进行Maven编译发布项目到MavenCenter的过程中，经常产生因为JavaDoc编译失败造成发布失败，但是很多情况下，都是一两个@param参数没有写全，@return没有写之类的问题，为此，我觉得非常有必要忽略这些异常。

问题描述

各位应该都知道发布一个Maven项目到Maven的中央仓库是必须要有JavaDoc，而我们在使用MavenJavaDocplugin的过程中，一旦出现某些类似于此的问题：

Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.7:jar (attach-javadocs) on project [projectname]: MavenReportException: Error while creating archive:
Exit code: 1 - [path-to-file]:[linenumber]: warning: no description for @param

都会造成整个发布过程失败，解决办法一般是一个一个的把这些@param加上去，一两个还好，如果您的项目有成千上万个呢？

解决办法

直接修改MavenJavaDocplugin的配置，忽略这些错误：

<plugin>
 <groupId>org.apache.maven.plugins</groupId>
 <artifactId>maven-javadoc-plugin</artifactId>
 <version>2.10.3</version>
 <executions>
 <execution>
 <id>attach-javadocs</id>
 <goals>
 <goal>jar</goal>
 </goals>
 <configuration> 
 <additionalparam>-Xdoclint:none</additionalparam>
 </configuration>
 </execution>
 </executions>
</plugin>

经过测试，忽略后项目可以正常发布，不会有什么影响。

以上就是关于扣丁学堂解析Maven在Java8下如何忽略Javadoc编译错误详解的全部内容，希望本文的内容对大家学习Java开发有所帮助，想要了解更多关于Java开发方面内容的小伙伴，请关注扣丁学堂Java培训官网、微信等平台，扣丁学堂IT职业在线学习教育平台为您提供权威的Java开发环境搭建视频，通过千锋扣丁学堂金牌讲师在线录制的Java视频教程，让你快速掌握Java从入门到精通开发实战技能。扣丁学堂Java技术交流群：670348138。

【关注微信公众号获取更多学习资料】

查看更多关于“Java开发资讯”的相关文章>>