如何在Javadoc链接中使用通用类型参数？

Question

我有以下代码:

/**
 * [...]
 *
 * @see #setShowOn(T, Device)
 */
 public static <T extends HasStyle> void setHideOn(T widget, Device device) {
     [...]
 }

setShowOn 与 setHideOn 的签名相同。Javadoc 抱怨：

Tag @see: can't find setHideOn(T, Device) in com.github.[...]

我尝试了不同的替代方案(@see #setShowOn(<T>, Device), @see #setShowOn(T extends HasStyle, Device), ...)，但这些在Eclipse上都不能正常工作。只有@see #setShowOn(T, Device)可以正常工作。

- Dominik

Answer 1

我找到了答案。这个方法有效：

@see #setHideOn(HasStyle, Device)

- Dominik

---

那很有道理——在你的例子中，T的擦除必须是HasStyle。谢谢分享！ - pholser

Answer 2

我不得不采用删除具有通用参数的方法的方法，例如：

@see #setHideOn(Object, Device)

在 JOpt Simple 中，我有一个例子 - 在 OptionSet.java 中，有对 ArgumentAcceptingOptionSpec#defaultsTo(V, V...) 的 @linkplain 引用，我必须将其编码为 ArgumentAcceptingOptionSpec#defaultsTo(Object, Object[])。

- pholser

---

奇怪，我在你的文档中看到它可以工作，但我仍然收到之前相同的错误信息。 - Dominik