如何制作带有默认评论的摘要 class？

Question

我有一个带有抽象方法的超类我想提供一些关于该方法的评论，如果任何子类继承了这个方法，这些评论也会随之而来。

class MySuper {

    //some comments
    protected abstract void myAbstractMethod();
}

class MyChild extends MySuper {

    //some comments
    @Override
    public void updateLanguage() {

    }
}

Answer 1

您需要添加适当的 java-doc 评论，而不是实施 class 将获得这些评论。

此技术也用于 jdk 中的多个地方 - 继承方法只是为了获取它们的文档。

Answer 2

定义抽象方法时，您应该使用 java-doc 来帮助必须编写实现的人。

在扩展 class 中，我希望找到一个 java-doc 来解释这个实现。