java - 对 javadoc 中方法参数的可重构引用

Question

如何在 javadoc 中引用方法参数，以便重构引用？
例如:

public class A {

    private int field;

    /**
     * @param p 
     * {@link #field} is initialized using the value of p.
     */
    void foo(int p)
    {
        //...

    }
}       

如果我重命名上面代码中的参数p，我想要

"...using the value of p"

相应更改的文本(就像重命名字段会更改 {@link #field} 一样)。
我读了this旧帖子和更多资源，但找不到解决方法。
javadoc支持吗？

Answer 1

由于 Java 删除，方法参数名称是短暂的，它们不是静态类定义的一部分。所以，void foo(int p) 改成 void foo(int x) 不被认为是重构，因为它保证不会影响程序的任何逻辑方式(除非参数重载类字段)。

因此在 javadoc 中不能有标识方法参数的静态链接。当您重构方法时 @param 之后的词会发生变化，这一事实是 IDE 提供的帮助。