继承的Javadoc父构造函数文档(Javadoc inheriting parent constr

2019-07-18 10:07发布

考虑到我在扩展一个类,如:

public class MyComboBox<T> extends JComboBox<T> {

    public MyComboBox() {
        super();
    }

    public MyComboBox(ComboBoxModel<T> model ) {
        super(model);
    }

}

重新定义父的构造函数(这是安装我的新类,当然)很讨厌足够,而且还复制每个构造文档更是雪上加霜。 更何况,这是不好的进一步继承,因为我现在已经多次更新的文档。

显然, {@inheritDoc} ,因为我不重写任何东西都不行。 这是,但是,我在寻找的行为。 有什么办法来实现这一目标?

如何继承父构造函数的文档?

Answer 1:

使用@see标签,并把该分类成员的名字。 要看到如何显示出来看看JDocs在那里你可以从javadoc中跳转到源代码。

确切synatax是:

 @see com.x.y.z.ClassName#methodName()


Answer 2:

你不能覆盖的构造,因此没有必要传播的javadoc。 只是说明你的目标客户需要了解特定的构造如何contruct的对象。 如果它只是传递到一个扩展对象的构造,然后说这一点。



Answer 3:

我们确实有,甚至在Java 7中一个超类的构造函数。

http://docs.oracle.com/javase/8/docs/api/



文章来源: Javadoc inheriting parent constructors documentation