java - 在 JavaDocs 中显示数组值

Question

假设我有这样的代码:

private static final int[] ARRAY = {5, 10, 15};

/**
 * ????
 */
public void doSomething()
{}

我想知道是否有任何方法可以将 ARRAY 的值放入 doSomething() 方法的文档中。 我可以看到 @value #ARRAY 对于数组根本不起作用:( @link #ARRAY 没有向我显示该值。

我错过了什么吗？

Answer 1

问题是 @value 仅适用于常量，即 static Final 值。数组contents不是常量，只有数组object本身是常量。您可以随时更改这些值。因此，从技术上讲，显示这些值是没有意义的。数组对象本身无法在 Javadoc 创建时以任何有用的方式显示，就像任何其他对象(String 除外)。