java - 如何在不覆盖方法本身的情况下覆盖方法的 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 但保持在父类(super class)中的实现( AbstractFoo )。有没有办法在不覆盖方法的情况下做到这一点？

Answer 1

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

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

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