generics - 如何在 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)确实。）

Answer 1

我找到了答案。这有效：

@see #setHideOn(HasStyle, Device)

Answer 2

我不得不求助于擦除具有通用参数的方法，例如：

@see #setHideOn(Object, Device)

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