Làm thế nào để liên kết javadoc với trường riêng?

Question

làm cách nào để tạo liên kết javadoc thành trường riêng tư?

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

{@link Foo#getBar()} hoạt động.

{@link Foo#bar} thì không.

Answer 1

Cú pháp là tốt, cả hai công việc sau đây trong một lớp học (và không có lý do gì để liên kết đến một lĩnh vực tư nhân từ một lớp khác nhau):

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

Khi tạo javadoc, ví dụ, thông qua kiến, chỉ cần chỉ định rằng các trường riêng tư phải được bao gồm (quyền truy cập tối thiểu mặc định là "được bảo vệ", không phải là "riêng tư"):

<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

Tôi nghĩ rằng những gì bạn đang viết trong các bình luận là tốt, bạn chỉ cần nói với JavaDoc cũng bao gồm các trường riêng trong tài liệu. JavaDoc có một tùy chọn -private cho việc này. Kiểm tra this answer.