2013-08-01 36 views

Trả lời

9

Thẻ @since nên được sử dụng để xác định phiên bản nào bạn thêm phương pháp, giai cấp, vv Đây là gợi ý của bạn để các nhà phát triển khác mà họ nên chỉ mong đợi phương thức khi chúng chạy với phiên bản cụ thể của gói. Tôi sẽ xem xét những phần quan trọng này của tài liệu nếu bạn đang chuyển mã của mình dưới dạng thư viện nhằm mục đích cho người khác sử dụng.

/** 
* @author Firstname Lastname <address @ example.com> 
* @version 1.6  (current version number of program) 
* @since  1.5  (the version of the package this class was first added to) 
*/ 

Để biết thêm thông tin xin truy cập:

http://en.wikipedia.org/wiki/Javadoc

javadoc: @version and @since

+0

cảm ơn, tôi đã nhầm lẫn kể từ trên wiki, ví dụ được đưa ra là phiên bản giống như ngày của gói! – Don

+0

Wikipedia không phải là một tham chiếu quy phạm. Sử dụng tài liệu tham khảo được cung cấp. – EJP

3

Thẻ @since không được sử dụng để xác định ngày thay vì nó được sử dụng để cung cấp thông tin về các thông tin phiên bản cuối cùng

/**  
* @since 1.7 
*/ 
2

@since 1.1

kể từ khi được theo sau bởi một số mà chỉ một số loại ID phiên bản. Bất kỳ định dạng sẽ làm nhưng định dạng NN được ưa thích

1

@since chú thích được sử dụng để mô tả khi các chức năng đầu tiên tồn tại, đó là số phiên bản.

1

Như tôi biết @Since được sử dụng để chỉ ra phiên bản bắt đầu một số triển khai.

@Since 1.0 // meaning is this method start from version 1.0