可重复引用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,我想要

"......使用p的值"

相应更改的文本(正如重命名字段将更改{@link #field}).
我读了这篇旧帖子,还有更多来源,但找不到办法.
javadoc是否支持它？

Answer 1

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

因此，在 javadoc 中不能有标识方法参数的静态链接。当您重构方法时，after 一词会@param发生变化，这一事实本身就是 IDE 提供的一个好处。