如何在不覆盖方法本身的情况下覆盖方法的 javadoc？

Question

假设我有两个类：

public abstract class AbstractFoo {

    /**
     * Do bar. Subclasses may override this method, it is not required that they do baz.
     */
    public void bar() {
        // default implementation
    }

}

public class ConcreteFoo extends AbstractFoo {

    /**
     * Do bar. <b>Note:</b> does not do baz, you have to do it yourself.
     */
    @Override
    public void bar() {
        super.bar();
    }
}

在子类 ( ConcreteFoo) 中，我想覆盖bar()的 javadoc 但保持与超类 ( AbstractFoo) 中的实现相同。有没有办法在不覆盖方法的情况下做到这一点？

Answer 1

不，绝对没有办法做到这一点。
但是，您应该使用

/**
 * {@inheritDoc}
 * add whatever you would like here
 */

如果您打算真正覆盖该方法，则表示法作为实现 javadoc。