Question

我正在尝试为我的项目生成一个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}，但出于某种原因，它在这里不起作用......

Answer 1

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

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

应该这样改变：

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

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

Answer 2

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

引用vararg时，Javadoc @link无法正常工作（String [] ...）

2 个答案: