https://www.cnblogs.com/nizuimeiabc1/p/8618070.html
JDK 8では、DoclintがJavadocに追加され、このツールの主な目的は、W3C HTML 4.01標準に準拠するHTMLドキュメントを取得することです。JDK8では、次のJavadocは、doclintを満たさない限り取得できません。
- 例えば、自動閉鎖HTMLタグを持つことができません
<br/>か<a id="x"/> - 閉じられていないHTMLタグは存在できません。たとえば、存在します
<ul>が、存在しません。</ul> - たとえば、違法なHTML終了タグはありません
</br> - 違法なHTML属性はあり得ず、W3C HTML4.01に基づくdocliintの実装に準拠する必要があります。
- 重複するHTMLID属性はありません
- 空のHTMLhref属性はあり得ません
- ネストされた見出しが正しくない必要があります。たとえば、クラスのドキュメントでは
<h3>、<h4> - 違法なHTMLタグはあり得ません。たとえば、対応するエンティティシンボル
List<String>を使用する必要があります。<> - 破損してはいけません
@link references - 損傷
@param referencesがあってはならず、実際のパラメータ名と一致している必要があります - 損傷
@throws referencesはありません。最初の単語はクラス名である必要があります
これらのルールに違反すると、Javadoc出力が得られないことに注意してください。
1つの解決策は、doclintをオフにすることです。Mavenで実行している場合は、次のadditionalparam設定を使用する必要があります。
<profiles>
<profile>
<id> disable-javadoc-doclint </ id>
<activation>
<jdk> [1.8、）</ jdk>
</
Activation >
<properties> <additionalparam> -Xdoclint：none </ additionalparam>
</ properties>
</ profile>
</ profiles>
または者是追加到maven-javadoc-plugin中：
<plugin>
<groupId> org.apache.maven.plugins </ groupId>
<artifactId> maven-javadoc-plugin </ artifactId>
<version> 2.10.4 </ version>
<configuration>
<encoding> $ {chartset.UTF8 } </ encoding>
<aggregate> true </ Aggregate>
<charset> $ {chartset.UTF8} </ charset>
<docencoding> $ {chartset.UTF8} </ dockencoding>
</ configuration>
<executions>
<execution>
< id> attach-javadocs </ id>
<フェーズ>パッケージ</フェーズ>
<ゴール>
<ゴール>ジャー</ゴール>
</ゴール>
<構成>
<追加パラメータ> -Xdoclint：none </ additionalparam>
</構成>
</実行>
</実行>
</プラグイン>