引用 vararg (String[]...) 时 Javadoc @link 不起作用答案

【问题标题】：Javadoc @link not working when referencing a vararg (String[]...)引用 vararg (String[]...) 时 Javadoc @link 不起作用
【发布时间】：2018-07-04 21:02:51
【问题描述】：

我正在尝试为我的项目生成 Javadoc，但我似乎找不到如何创建指向精确方法的链接：

public static Html select(Buffer<String> contentBuffer, String id, String name, String classes, boolean isMultiple, String[]... attributeList)

我试过了：

{@link #select(Buffer, String, String, String, boolean, String:A...) select()}
{@link #select(Buffer, String, String, String, boolean, String[]...) select()}

但是根本没有创建链接...我在链接标签上收到错误error: unexpected text。

我错过了什么吗？

编辑：我已经知道如何形成一个有效的{@link}，但由于某种原因，它在这里不起作用......

【问题讨论】：

How to reference a method in javadoc?的可能重复
@GeorgHenkel ：正如您清楚地看到的那样，我在尝试解决我的问题时已经遵循了{@link ...} 的规则。为什么要给我链接这个？ ...
{@link #select(Buffer, String, String, String, boolean, String[]...)} 对我来说似乎不错
@oleg.cherednik 这对我来说似乎也不错，但我总是遇到同样的错误。
这可能是 1.8 的错误 - 使用 1.8.0_162 我也得到了无效链接。使用 9.0.1 可以正确生成链接。

标签： java javadoc

【解决方案1】：

不应该是{@link #select(Buffer, String, String, String, boolean, String[]...) select} 吗？

【讨论】：

【解决方案2】：

在 java-8 中（可能是由于 very old javadoc bug 的回归），当链接 URL 的片段部分使用省略号 "..." 表示可变参数参数时，@link 声明无法正确呈现链接。相反，应该使用数组语法。所以你的链接声明

{@link #select(Buffer, String, String, String, boolean, String[]...) select()}

应该这样改变：

{@link #select(Buffer, String, String, String, boolean, String[][]) select()}

另请注意，在 java-9 中，该错误是不可重现的。

【讨论】：