快捷導(dǎo)航

Maven在Java8下如何忽略Javadoc的編譯錯(cuò)誤詳解

更新時(shí)間：2018年08月23日 08:42:08 作者：劉美勝奇

這篇文章主要給大家介紹了關(guān)于Maven在Java8下如何忽略Javadoc的編譯錯(cuò)誤的相關(guān)資料，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧

JavaDoc簡(jiǎn)介And基礎(chǔ)知識(shí)

(一) Java注釋類型

//用于單行注釋。
/*...*/用于多行注釋，從/*開(kāi)始，到*/結(jié)束，不能嵌套。
/**...*/則是為支持jdk工具javadoc.exe而特有的注釋語(yǔ)句。

說(shuō)明：javadoc 工具能從java源文件中讀取第三種注釋，并能識(shí)別注釋中用@標(biāo)識(shí)的一些特殊變量（見(jiàn)表），制作成Html格式的類說(shuō)明文檔。javadoc不但能對(duì)一個(gè) java源文件生成注釋文檔，而且能對(duì)目錄和包生成交叉鏈接的html格式的類說(shuō)明文檔，十分方便。

(二)JavaDoc中出現(xiàn)的@字符及其意義：

1. 通用注釋

注釋中可以出現(xiàn)的關(guān)鍵字以@開(kāi)始	意義
@author	作者名
@version	版本標(biāo)識(shí)
@since	最早出現(xiàn)的JDK版本
@deprecated	引起不推薦使用的警告
@see	交叉參考

2. 方法注釋

@return	返回值
@throws	異常類及拋出條件
@param	參數(shù)名及其意義

引言

好了，介紹完一些基本的知識(shí)，下面開(kāi)始本文的正文。

Java8對(duì)JavaDoc的語(yǔ)法檢查非常嚴(yán)格，我在進(jìn)行Maven編譯發(fā)布項(xiàng)目到Maven Center的過(guò)程中，經(jīng)常產(chǎn)生因?yàn)镴avaDoc編譯失敗造成發(fā)布失敗，但是很多情況下，都是一兩個(gè)@param參數(shù)沒(méi)有寫(xiě)全，@return沒(méi)有寫(xiě)之類的問(wèn)題，為此，我覺(jué)得非常有必要忽略這些異常。

問(wèn)題描述

各位應(yīng)該都知道發(fā)布一個(gè)Maven項(xiàng)目到Maven的中央倉(cāng)庫(kù)是必須要有JavaDoc，而我們?cè)谑褂肕aven JavaDoc plugin的過(guò)程中，一旦出現(xiàn)某些類似于此的問(wèn)題：

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

都會(huì)造成整個(gè)發(fā)布過(guò)程失敗，解決辦法一般是一個(gè)一個(gè)的把這些@param加上去，一兩個(gè)還好，如果您的項(xiàng)目有成千上萬(wàn)個(gè)呢？

解決辦法

直接修改Maven JavaDoc plugin的配置，忽略這些錯(cuò)誤：

<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>

經(jīng)過(guò)測(cè)試，忽略后項(xiàng)目可以正常發(fā)布，不會(huì)有什么影響。

總結(jié)

以上就是這篇文章的全部?jī)?nèi)容了，希望本文的內(nèi)容對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，如果有疑問(wèn)大家可以留言交流，謝謝大家對(duì)腳本之家的支持。

您可能感興趣的文章: