Lan*_*opp 42 java javadoc inheritdoc
我想使用{@inheritDoc}该类从我的抽象类继承方法.在抽象类的文档中,我按名称引用了抽象类.我如何标记这个,所以当子类从超类继承文档时,它用子类的名称替换抽象类的名称？
bgu*_*uiz 45
javadoc生成工具不支持您所描述的内容.
而且我认为这也是有充分理由的:
如果子类中的方法仅仅是抽象方法的实现,那么我认为将抽象类的名称留在那里是正确的.
另一方面,如果子类中的方法不仅仅是一个简单的实现,并且做了一些值得注意的事情(足以在javadoc中提到),那么你应该在子类中的方法上编写一个新的javadoc,而不是调用inheritDoc.
tra*_*god 16
我不知道一种方法,但你可能会详细说明你为什么{@inheritDoc}要这样做.我可能会误解,但似乎令人困惑.您可以记录具体实现与父项的不同之处,并用于@see引用抽象类中的契约.注意" 自动复制方法注释 "可以避免显式的需要{@inheritDoc}.