【问题标题】:Javadoc annotation for "copying" documentation用于“复制”文档的 Javadoc 注释
【发布时间】:2014-11-30 13:06:54
【问题描述】:

在我的应用程序中,我有几个类具有包保护方法和关联的 JavaDoc。然后我在同一个包中有一些其他类与公共方法——在某些情况下,公共方法只不过是包保护方法的“代理”——对于这种情况,我很想“继承” pp方法中的JavaDoc,但我不知道该怎么做

@inheritDoc 适用于继承情况
@see@link 创建指向类/方法文档的指针

我想“复制”文档,而不是创建指向其他方法文档的链接。 我一直在找这种注解,但没有找到。

有什么想法吗?

顺便说一句:如果我创建一个接口并在一个类中实现它,则使用 NetBeans,即使我没有使用 @inheritDoc 注释类方法,我在使用类方法时也可以看到接口文档——仍然想知道为什么!

谢谢, 卡罗

【问题讨论】:

    标签: annotations documentation javadoc


    【解决方案1】:

    根据 JavaDocs 文档,这仅在三种情况下可行:-

    • 当类中的方法覆盖超类中的方法时
    • 当接口中的方法覆盖超接口中的方法时
    • 当类中的方法实现接口中的方法时

    鉴于您没有覆盖方法,这似乎是不可能的。

    请看这里:Automatic re-use of method comments

    【讨论】:

      猜你喜欢
      • 2020-02-06
      • 2011-08-02
      • 2019-05-14
      • 2010-10-24
      • 2015-11-02
      • 2010-10-17
      • 2018-11-23
      • 2012-04-09
      • 2014-06-23
      相关资源
      最近更新 更多