欧美成人午夜免费全部完,亚洲午夜福利精品久久,а√最新版在线天堂,另类亚洲综合区图片小说区,亚洲欧美日韩精品色xxx

扣丁學(xué)堂解析Maven在Java8下如何忽略Javadoc編譯錯(cuò)誤詳解

2018-08-24 14:45:21 1379瀏覽

今天扣丁學(xué)堂Java培訓(xùn)老師給大家介紹一下關(guān)于Maven在Java8下如何忽略Javadoc的編譯錯(cuò)誤，下面我們通過示例代碼一起來看一下吧。

(一)Java注釋類型

//用于單行注釋。

/*...*/用于多行注釋，從/*開始，到*/結(jié)束，不能嵌套。

/**...*/則是為支持jdk工具javadoc.exe而特有的注釋語句。

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

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

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

問題描述

各位應(yīng)該都知道發(fā)布一個(gè)Maven項(xiàng)目到Maven的中央倉庫是必須要有JavaDoc，而我們在使用MavenJavaDocplugin的過程中，一旦出現(xià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

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

解決辦法

直接修改MavenJavaDocplugin的配置，忽略這些錯(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)過測試，忽略后項(xiàng)目可以正常發(fā)布，不會有什么影響。

以上就是關(guān)于扣丁學(xué)堂解析Maven在Java8下如何忽略Javadoc編譯錯(cuò)誤詳解的全部內(nèi)容，希望本文的內(nèi)容對大家學(xué)習(xí)Java開發(fā)有所幫助，想要了解更多關(guān)于Java開發(fā)方面內(nèi)容的小伙伴，請關(guān)注扣丁學(xué)堂Java培訓(xùn)官網(wǎng)、微信等平臺，扣丁學(xué)堂IT職業(yè)在線學(xué)習(xí)教育平臺為您提供權(quán)威的Java開發(fā)環(huán)境搭建視頻，通過千鋒扣丁學(xué)堂金牌講師在線錄制的Java視頻教程，讓你快速掌握J(rèn)ava從入門到精通開發(fā)實(shí)戰(zhàn)技能?？鄱W(xué)堂Java技術(shù)交流群：670348138。

【關(guān)注微信公眾號獲取更多學(xué)習(xí)資料】

查看更多關(guān)于“Java開發(fā)資訊”的相關(guān)文章>>