Maven在Java8下忽略Javadoc的编译错误

这篇文章给大家分享的是有关Maven在Java8下忽略Javadoc的编译错误的内容。小编觉得挺实用的,因此分享给大家做个参考,一起跟随小编过来看看吧。

创新互联建站专注于温岭企业网站建设,响应式网站设计,商城建设。温岭网站建设公司,为温岭等地区提供建站服务。全流程按需制作,专业设计,全程项目跟踪,创新互联建站专业和态度为您提供的服务

JavaDoc简介And基础知识

(一) Java注释类型

  • //用于单行注释。

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

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

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

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

1. 通用注释

注释中可以出现的关键字以@开始

意义

@author

作者名

@version

版本标识

@since

最早出现的JDK版本

@deprecated

引起不推荐使用的警告  

@see

交叉参考

2. 方法注释

@return

返回值

@throws

异常类及抛出条件

@param

参数名及其意义

引言

好了,介绍完一些基本的知识,下面开始本文的正文。

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

问题描述

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

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加上去,一两个还好,如果您的项目有成千上万个呢?

解决办法

直接修改Maven JavaDoc plugin的配置,忽略这些错误:


 org.apache.maven.plugins
 maven-javadoc-plugin
 2.10.3
 
 
 attach-javadocs
 
 jar
 
  
 -Xdoclint:none
 
 
 

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

感谢各位的阅读!关于“Maven在Java8下忽略Javadoc的编译错误”这篇文章就分享到这里了,希望以上内容可以对大家有一定的帮助,让大家可以学到更多知识,如果觉得文章不错,可以把它分享出去让更多的人看到吧!


当前标题:Maven在Java8下忽略Javadoc的编译错误
网页链接:http://myzitong.com/article/jgcsii.html