隨著從 Java 11 到 Java 12 的更改，我們現在在包含 OSGi 版本注釋的包信息文件上生成 Javadoc 時看到一個奇怪的錯誤。源代碼是：@Version("1.3.0")package org.apache.jackrabbit.oak.commons;import org.osgi.annotation.versioning.Version;錯誤是：[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] ^（查看詳細信息和上下文）這是 Java 12 中的回歸，還是注釋的使用方式有問題，或者如何調用 Javadoc（通過 maven）？
2 回答
智慧大石
TA貢獻1946條經驗 獲得超3個贊
可能是 Javadoc 錯誤，因為 Javadoc 將 Java Annotation 視為Javadoc Tag。
解決方法 1： 禁用此 Javadoc 標記
<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： 在每個注釋前添加一個空 Javadoc 塊
/** */@Version("1.3.0")
package org.apache.jackrabbit.oak.commons;
慕姐8265434
TA貢獻1813條經驗 獲得超2個贊
簡化復制：
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
^
看起來 javadoc 錯誤被分類為JDK-8223117，它被標記為JDK-8222091 的副本：Javadoc 在 package-info.java 上沒有正確處理包注釋，并在 JDK 13 中修復。
同樣的問題也會影響 OpenJDK 11.0.17，因為引入 javadoc 回歸的更改最近被向后移植。這應該在即將發布的 JDK 11u 版本中修復：https ://bugs.openjdk.org/browse/JDK-8295850
添加回答
舉報
0/150
提交
取消