尽管存在引用 cleary，Javadoc 显示错误“未找到引用”

Question

在 Java8 中，javadoc 检查变得更加严格。常见的解决方案是禁用严格的 javadoc 检查。尽管如此，我还是开始尝试修复一些项目中的错误。
但是有一个错误我没有解决。

对应的类：

package foo;

import com.google.gwt.user.client.ui.TextArea;
[...]

public class MyClass {

  [...]

  /**
   * @see TextArea#getValue()
   */
  public String getValue() {
      [...]
  }

  /**
   * @see TextArea#setValue(String value)
   */
  public void setValue(String value) {
      [...]
  }

  /**
   * @see TextArea#setValue(String, boolean)
   */
  public void setValue(String value, boolean fireEvents) {
      [...]
  }
}

还有错误信息：

[ERROR] ...\MyClass.java:44: error: reference not found
[ERROR] * @see TextArea#setValue(String value)  
[ERROR] ^
[ERROR] ...\MyClass.java:51: error: reference not found
[ERROR] * @see TextArea#setValue(String, boolean)

错误消息指出它在setValue-Methods 的Javadoc 中找不到TextArea - 但另一方面在getValue-Methods 上找到TextArea 没有问题。

据我所知，我关注了How to specify a name 和@see reference。

有什么线索吗？非常感谢！

Answer 1

我遇到了同样的问题。 但是我解决了没有()的方法。

@see ClassTest.method

Answer 2

好的，我现在得到了答案，这有点棘手！

• TextArea 扩展 ValueBoxBase<String>
• TextArea#getValue() 没有参数，所以一切都很好
• TextArea 中不存在方法TextArea#setValue(String value)，而是在超类中定义：ValueBoxBase#setValue(Object, boolean)。

但就是这样！ “技术上”没有方法setValue(String)。而是setValue(Object)。 javadoc 无法自行解决此问题，或者这只是一个错误。

因此，我发现解决此问题的唯一方法是使用对超类的引用。

/**
 * @see com.google.gwt.user.client.ui.ValueBoxBase#setValue(Object, boolean)
 */

Answer 3

代替：

/**
 * @see TextArea#getValue()
 */

试试：

/**
 * @see com.google.gwt.user.client.ui.TextArea#getValue()
 */