如何提示Javadoc关于基类的泛型参数?

时间:2016-02-17 14:52:37

标签: java javadoc

我已经完成了以下设置:

基类:

class GenericBuilder<T extends GenericBuilder> {
    /**
     * Some documentation.
     */
    public T withParam1(ParamType param) { /* ... */ }
}

两个派生类:

public class ConcreteBuilder1 extends GenericBuilder<ConcreteBuilder1> {
    // some unique parameters
}

public class ConcreteBuilder2 extends GenericBuilder<ConcreteBuilder2> {
    // some unique parameters
}

我介绍了GenericBuilder以避免当前从它派生的两个构建器之间的代码重复。

在生成的Javadoc HTML页面中,每个类的方法显示为T withParam1(ParamType param),而不是ConcreteBuilder1 withParam1(ParamType param)ConcreteBuilder2 withParam1(ParamType param)。我还注意到,生成的页面声称,ConcreteBuilders正在扩展Object,可能是因为GenericBuilder是一个包级别的类,但是将它公开与我想要完成的内容相矛盾并且没有真正解决我的问题。

问题是:如何向Javadoc提示,T在ConcreteBuilders的上下文中具有非常具体的含义?

0 个答案:

没有答案