Maven在Java8下忽略Javadoc的編譯錯誤

這篇文章給大家分享的是有關(guān)Maven在Java8下忽略Javadoc的編譯錯誤的內(nèi)容。小編覺得挺實用的，因此分享給大家做個參考，一起跟隨小編過來看看吧。

JavaDoc簡介And基礎(chǔ)知識

(一) Java注釋類型

• //用于單行注釋。

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

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

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

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

1. 通用注釋

2. 方法注釋

引言

好了，介紹完一些基本的知識，下面開始本文的正文。

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

問題描述

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

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

解決辦法

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

<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)過測試，忽略后項目可以正常發(fā)布，不會有什么影響。

感謝各位的閱讀！關(guān)于“Maven在Java8下忽略Javadoc的編譯錯誤”這篇文章就分享到這里了，希望以上內(nèi)容可以對大家有一定的幫助，讓大家可以學到更多知識，如果覺得文章不錯，可以把它分享出去讓更多的人看到吧！