java - Javadoc 继承父构造函数文档

Question

考虑到我正在扩展一个类，例如：

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

    public MyComboBox() {
        super();
    }

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

}

重新定义父类的构造函数（当然，这适合我的新类）很烦人，但还要复制每个构造函数的文档就更糟了。更不用说这对进一步继承不利，因为我现在必须多次更新文档。

显然，{@inheritDoc}不会工作，因为我没有覆盖任何东西。然而，这是我正在寻找的行为。有什么办法可以做到这一点？

如何继承父构造函数文档？

Answer 1

使用 @see 标记并放置类和成员名称。要了解它是如何显示的，请查看JDocs，您可以在其中从 javadoc 跳转到源代码。

确切的语法是：

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

Answer 2

您不能覆盖构造函数，因此无需传播 javadocs。只需解释您的对象的客户需要了解该特定构造函数如何构造该对象。如果它只是将构造传递给扩展对象，那么就这么说吧。