Liên kết Javadoc tới tệp src/main/resource hoặc src/test/resource bằng đường dẫn tương đối

Question

Tôi sẽ thấy nó cực kỳ hữu ích nếu có cách đặt liên kết trong javadoc vào tệp tài nguyên chuẩn nằm trong src/main/tài nguyên hoặc src/test/resources để một coder khác có thể nhanh chóng điều hướng đến tệp tài nguyên (trong trường hợp này là tệp JSON).

Các tệp này được sử dụng trong các bài kiểm tra đơn vị và cần được sửa đổi thường xuyên khi thay đổi lược đồ.

Câu trả lời ở đây Link to text file (resource) in Javadoc không giúp ích như một đường dẫn tuyệt đối sẽ quá mong manh.

Có cách nào để làm điều tương tự như @ xem với tài nguyên không? Một cái gì đó cụ thể để IntelliJ sẽ là tuyệt vời nếu javadoc chính nó rơi ngắn.

Answer 1

Không cần phải đề cập đến đường dẫn tuyệt đối. Xem gói và cấu trúc lớp học của tôi bên dưới. Từ một gói chị em nếu tôi làm theo các quy tắc URI, tôi làm .. để quay lại một thư mục và đề cập đến nó như thế này. Nó hoạt động! Khi nhấp vào url, tệp sẽ mở. Mặc dù tôi đã minh họa điều này trong nhật thực, tôi nghĩ rằng điều này sẽ là IDE bất khả tri.

/** 
* Removes all the stop words like a, for, the etc. from the text. For a 
* full list of stop words check 
* <a href="file:../resources/stopWords.txt">/resources/stopWords.txt</a> 
* 
* @return String free of all the stop-words 
* @param text 
*   The string to be cleaned, do null check at your end 
*/