java - Javadoc link to src/main/resource or src/test/resource file using relative path

Question

I would find it extremely useful if there was a way to put a link in javadoc to a standard resource file that resides in src/main/resources or src/test/resources so that another coder could quickly navigate to the resource file (in this case a JSON file) in IntelliJ.

These files are used in unit tests and need to be modified often as the schema changes.

The answer here Link to text file (resource) in Javadoc does not help as an absolute path would be too fragile.

Is there a way to do the same thing as @see with resources? Something specific to IntelliJ would be great if javadoc itself falls short.

Answer 1

No need to mention the absolute path. See my package and class structure below. From a sister package if I follow the URI rules I do a .. to go one folder back and mention it like this. It works! On clicking the url the file opens. Although I have illustrated this in eclipse, I think this should be IDE agnostic.

/**
 * 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
 */