Javadoc liên kết đến phương thức trong lớp khác

Hiện tại tôi đang tham khảo các phương thức trong các lớp khác với cú pháp Javadoc này:

@see {@link com.my.package.Class#method()}

Và trong những gì tôi hiểu từ tài liệu này là cách chính xác để làm điều này. Nhưng bây giờ đến phần buồn cười, hoặc bực bội. Khi tôi tạo javadoc này, trước hết tôi gặp lỗi sau:

warning - Tag @see:illegal character: "123" in "{@link com.my.package.Class#method()}"
warning - Tag @see:illegal character: "64" in "{@link com.my.package.Class#method()}"
warning - Tag @see: reference not found: {@link com.my.package.Class#method()}

Mã HTML được tạo ra này là:

"," <code>com.my.package.Class#method()}</code> ","

Và tất nhiên tôi không có liên kết. Bất cứ ai có thể cho tôi biết những gì đang xảy ra, và bất kỳ gợi ý về cách khắc phục điều này?

Theo các ký tự bảng ASCII 123 và 64 cho wold đại diện cho {và @, vậy tại sao các ký tự này không hợp lệ khi cú pháp này đúng theo tài liệu?

Đối với thẻ Javadoc @see, bạn không cần sử dụng @link; Javadoc sẽ tạo một liên kết cho bạn. Thử

@see com.my.package.Class#method()

Dưới đây là thông tin thêm về @see.

Bên cạnh đó @see, một cách tổng quát hơn để giới thiệu đến một lớp khác và có thể là phương thức của lớp đó {@link somepackage.SomeClass#someMethod(paramTypes)}. Điều này có lợi ích là có thể sử dụng được ở giữa một mô tả javadoc.

Từ tài liệu javadoc (mô tả về thẻ @link) :

Thẻ này rất giống với @see - cả hai đều yêu cầu các tham chiếu giống nhau và chấp nhận chính xác cùng một cú pháp cho gói. Class # thành viên và nhãn. Sự khác biệt chính là {@link} tạo liên kết nội tuyến thay vì đặt liên kết trong phần "Xem thêm". Ngoài ra, thẻ {@link} bắt đầu và kết thúc bằng dấu ngoặc nhọn để tách nó khỏi phần còn lại của văn bản nội tuyến.

Vì vậy, giải pháp cho vấn đề ban đầu là bạn không cần cả tham chiếu "@see" và "{@link ...}" trên cùng một dòng. Thẻ "@link" là tự cung cấp và, như đã lưu ý, bạn có thể đặt nó ở bất cứ đâu trong khối javadoc. Vì vậy, bạn có thể kết hợp hai cách tiếp cận:

/**
 * some javadoc stuff
 * {@link com.my.package.Class#method()}
 * more stuff
 * @see com.my.package.AnotherClass
 */