java - javadoc 中 @value 的意外结果

Question

Javadoc 似乎只处理声明引用字段的类上的 @value 标记，并且只处理没有类名的引用。

示例:

我有课

/** {@value #F} */
public class A {
    public static final String F = "field";
}

和

/** {@value A#F} */
public class B {}

jdk 1.7 javadoc 工具处理 A 上的 @value 标记，但对于 B 我收到以下警告:

warning - A#F (referenced by @value tag) is an unknown reference.

当我尝试使用 A#F 引用 A 的 javadoc 中的字段时，也会出现此警告。当我使用 @link 标签时，一切都按预期工作。

我找不到任何文档提到 @value 标记可能只引用在 javadoc 所在的类中声明的字段。这是一个错误还是有其他方法可以让 @value 标记显示值？

Answer 1

提供带有引用类的整个包名解决了我的问题:假设类 A 是在包 com.example 中定义的，这对我有用:

/** 
* {@value com.example.A#F} 
*/
public class B {}

希望对您有所帮助。