隨著從 Java 11 到 Java 12 的更改，我們現(xiàn)在在包含 OSGi 版本注釋的包信息文件上生成 Javadoc 時(shí)看到一個(gè)奇怪的錯(cuò)誤。源代碼是：@Version("1.3.0")package org.apache.jackrabbit.oak.commons;import org.osgi.annotation.versioning.Version;錯(cuò)誤是：[ERROR] C:\projects\apache\oak\trunk\oak-commons\src\main\java\org\apache\jackrabbit\oak\commons\package-info.java:17: error: unknown tag: Version[ERROR] @Version("1.3.0")[ERROR] ^（查看詳細(xì)信息和上下文）這是 Java 12 中的回歸，還是注釋的使用方式有問題，或者如何調(diào)用 Javadoc（通過(guò) maven）？
2 回答
智慧大石
TA貢獻(xiàn)1946條經(jīng)驗(yàn) 獲得超3個(gè)贊
可能是 Javadoc 錯(cuò)誤，因?yàn)?Javadoc 將 Java Annotation 視為Javadoc Tag。
解決方法 1： 禁用此 Javadoc 標(biāo)記
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>3.1.0</version>
<configuration>
<tags>
<tag>
<name>Version</name>
<placement>X</placement>
</tag>
</tags>
</configuration>
</plugin>
解決方法 2： 在每個(gè)注釋前添加一個(gè)空 Javadoc 塊
/** */@Version("1.3.0")
package org.apache.jackrabbit.oak.commons;
慕姐8265434
TA貢獻(xiàn)1813條經(jīng)驗(yàn) 獲得超2個(gè)贊
簡(jiǎn)化復(fù)制：
package p;
import static java.lang.annotation.ElementType.PACKAGE;
import java.lang.annotation.Target;
@Target(PACKAGE)
public @interface A {}
@A
package p;
$ javadoc package-info.java A.java
...
package-info.java:1: error: unknown tag: A
@A
^
看起來(lái) javadoc 錯(cuò)誤被分類為JDK-8223117，它被標(biāo)記為JDK-8222091 的副本：Javadoc 在 package-info.java 上沒有正確處理包注釋，并在 JDK 13 中修復(fù)。
同樣的問題也會(huì)影響 OpenJDK 11.0.17，因?yàn)橐?javadoc 回歸的更改最近被向后移植。這應(yīng)該在即將發(fā)布的 JDK 11u 版本中修復(fù)：https ://bugs.openjdk.org/browse/JDK-8295850
添加回答
舉報(bào)
0/150
提交
取消