java - 如何将 javadoc 链接到私有字段？

Question

如何将 javadoc 链接到私有字段？

class Foo {
  private String bar;
  public String getBar() { return bar; }
}

{@link Foo#getBar()}作品。

{@link Foo#bar}没有。

Answer 1

语法很好，以下两个都在一个类中工作（并且没有理由链接到来自不同类的私有字段）：

public class Demo {
  private int num = 0;
  /**
  * Access field {@link Demo#num} / {@link #num}  ...
  */
  private void foo() { ... }
...

在生成 javadoc 时，例如，通过 ant，只需指定应包含私有字段（默认的最小访问权限是“受保护”，而不是“私有”）：

<target name="javadoc" depends="compile" description="gen javadoc">
  <javadoc destdir="build/docs"
           author="true"
           version="true"
           use="true"
           access="private"
           windowtitle="Demo API">

    <fileset dir="src/main" defaultexcludes="yes">
      <include name="com/**"/>
    </fileset>

    <doctitle><![CDATA[<h1>Test</h1>]]></doctitle>
    <link offline="true" href="http://download.oracle.com/javase/6/docs/api/" packagelistLoc="doc"/>
  </javadoc>
</target>

Answer 2

我认为你在评论中写的很好，你只需要告诉 JavaDoc 在文档中也包含私有字段。JavaDoc 为此提供了一个选项 -private。检查这个答案。