constants - 如何链接到 JavaDoc 中的所有类常量

Question

我经常觉得我想在 JavaDoc 中引用 @see Class#{all_constants} 。有什么办法吗？例如，如果我想提供对 bitflag 可能值的引用怎么办？

Answer 1

不幸的是，我还没有找到一个标准的方法来做到这一点。您当然可以创建一个相对 HREF，如下所示：

<a href="../../constant-values.html#my.package.MyClass">MyClass constants</a>

<a href="../../../../constant-values.html#my.deeply.nested.package.MyClass">MyClass constants</a>

问题是，重构时使用它并不安全。相对路径必须根据包名中的符号数量进行调整，并且完全限定的类名必须是锚点的一部分。它非常容易出错，并且不太可能被任何 IDE 支持。我很高兴发现有更好的答案，但这就是我现在所拥有的。