2009-03-08 58 views

Trả lời

214

Tính đến 1.5, bạn có thể xác định một tập tin package-info.java và cung cấp một lời nhận xét kiểu javadoc tiêu chuẩn cho một gói:

com/foo/package-info.java:

/** 
* com.foo is a group of bar utils for operating on foo things. 
*/ 
package com.foo; 

//rest of the file is empty 

Language specification for packages

+2

Liên kết trực tiếp đến thông số: http://docs.oracle.com/javase/specs/jls/se7/html/jls-7.html#jls-7.4.1 – gavenkoa

+2

trong intellij bạn có thể nhấp chuột phải vào một gói và tùy chọn để tạo điều này phải nằm trong menu tệp mới – bsautner

3

Với tệp package.html ở cấp gói (ví dụ: trong thư mục cho gói đó). Tệp này phải là tệp HTML được định dạng đầy đủ, với thẻ <html> được xác định trong đó

+1

Thêm deta ils? Tệp sẽ trông như thế nào? – jjnguy

+0

Đó là tệp HTML chứa mô tả gói của bạn. Đó là nó! –

+3

Đây là cách cũ để làm điều đó. Từ Java 1.5 trở đi, bạn có thể sử dụng package-info.java – k2col

38

Cho đến Java 1.4, bạn phải cung cấp tệp HTML package.html, như được mô tả trong các câu trả lời khác.

Vì Java 1.5 bạn cũng có thể cung cấp package-info.java, chứa chú thích Javadoc thông thường (không có HTML). Sau này được ưu tiên, vì nó cung cấp cho bạn một số tính năng bổ sung (đáng chú ý là chú thích gói).

chi tiết: Sun's docs for javadoc

+2

+1 để đề cập đến cả hai cách và sự khác biệt cơ bản giữa chúng. Nhân tiện, ít nhất IntelliJ IDEA hiện có hỗ trợ tốt hơn cho package.html (Ctrl-Q trên tên gói hiển thị gói Javadocs). – Jonik

+1

Cập nhật nhận xét trước của tôi: ngày nay IDEA hỗ trợ 'package-info.java' tốt. – Jonik

Các vấn đề liên quan