代码之家 › 专栏 › 技术社区 › drJava

在JavaDoc中将方法参数与类成员链接

javadoc java

drJava · 技术社区 · 7 年前

  /**
   * I would like to see this comment
   */
  private int       lineNumber;

  /**
   * Creates a new {@link GroupByMetaData} object.
   *
   * @param aLineNumber {@link GroupByMetaData#lineNumber}
   */
  public GroupByMetaData( int aLineNumber )
  {
    super();
    this.lineNumber = aLineNumber;
  }

以下结果为:;

1 回复 | 直到 7 年前

VGR 7 年前

没有办法将一个项目javadoc复制到另一个项目中,除了 {@inheritDoc} 只能从同一项的超类文档中插入。

构造函数设置私有int字段是内部实现的一部分。您的javadoc不应提及,或者 {@link}

私有javadoc通常与公共javadoc不同。私有javadoc将包含一些重要的实现细节,这些细节不应该被类的普通用户看到。例如:

/**
 * Line of input this object will analyze.  This is never negative.
 * Controls the loops in the `read` method and the `translate` method.
 */
private int lineNumber;

推荐文章

junsung kang · Cassandra突然挂起,返回WindowsFileSystemException:“该进程不可访问,因为该文件正被另一个进程使用”

1 年前

vaibhav nalamalpu · Intellij 2023.1无法打开(即使在重新安装后)[关闭]

1 年前

Katlock · 如何在Spring中将Restpage转换为特定的对象类型?

1 年前