Câu hỏi ngắn: Có thể tạo Javadoc cho các biến cục bộ không? (Tôi chỉ muốn một lời giải thích cho biến địa phương của tôi khi lơ lửng trên nó trong Eclipse) Cảm ơn bất kỳ gợi ý :-)Javadoc cho các biến cục bộ?
Trả lời
Biến cục bộ phải được khai báo một vài dòng trên mức sử dụng của nó. Chỉ cần sử dụng bình luận bình thường nếu bạn cần. Nhưng quan trọng hơn, hãy giữ các phương thức ngắn gọn, chọn các tên có ý nghĩa cho chúng và chỉ khai báo chúng khi bạn cần chúng. Hầu hết thời gian, hoàn toàn không cần thiết để nhận xét các biến cục bộ.
thích
int numberOfBooks = books.size();
qua
// the number of books
int n;
... // 50 lines of code
n = books.size();
Tôi đồng ý nó không cần thiết * hầu hết thời gian *, nhưng chỉ có những thứ phức tạp hơn để giải thích hơn số lượng sách và những thứ như vậy, đặc biệt khi thực hiện các phép tính phức tạp hơn, v.v. –
Không, nó không được hỗ trợ vì thế hệ javadoc sẽ bỏ qua nó.
Có thể. Chỉ cần thực hiện bình luận javadoc thông thường ở trên biến.
public class ExampleClass {
/** A really cool variable */
int localVariable;
...
Bây giờ bạn có thể di chuột lên trên biến trong mã tiếp tục xuống và nhận xét sẽ được hiển thị.
Có thể thực hiện bằng cách sử dụng Annotations
.
Tạo một kiểu chú thích đơn giản như sau:
@Retention(RetentionPolicy.SOURCE)
@Target(ElementType.LOCAL_VARIABLE)
@interface LocalVariableDocumentation {
String value();
}
Và sử dụng nó trên biến địa phương của bạn:
@LocalVariableDocumentation("A very important object!")
Object anImportantObject;
Eclipse sẽ hiển thị các chú thích trong tooltip.
Giải pháp tuyệt vời, tại sao câu trả lời này không được chấp nhận? – Ced
Cách duy nhất có thể là với các biến toàn cục. Các biến cục bộ không thể được chú thích bằng JavaDoc.
Chỉ cần tạo một liên kết để biến địa phương của bạn
String someLocalVariable;
/**
* This a local variable: {@link #someLocalVariable}
*/
Điều này không hoạt động trên Eclipse Mars, phải không? – Ced
Bạn có thể bao gồm mô tả biến thành phương pháp của javadoc bình luận –
Đôi khi bạn phải gỡ lỗi mã người khác và biến cục bộ là lộn xộn, nó sẽ giúp đỡ. – Ced