The Javadoc for the getPath() method in ClassPathResource states the following.
Return the path for this resource (as resource path within the class path).
However, that is not always true since that implies the returned path is an absolute path within the class path.
If the ClassPathResource was created using the ClassPathResource(String, Class) constructor with a relative path, the returned path is actually a cleaned version of the relative path supplied to the constructor.
In light of that, we should update the Javadoc for getPath() to reflect the actual semantics and introduce a new getAbsolutePath() method for retrieving the absolute path.
The latter is required by the newly introduced ResourceHints.registerResourceIfNecessary(Resource) method (see #29083).
The Javadoc for the
getPath()method inClassPathResourcestates the following.However, that is not always true since that implies the returned path is an absolute path within the class path.
If the
ClassPathResourcewas created using theClassPathResource(String, Class)constructor with a relative path, the returned path is actually a cleaned version of the relative path supplied to the constructor.In light of that, we should update the Javadoc for
getPath()to reflect the actual semantics and introduce a newgetAbsolutePath()method for retrieving the absolute path.The latter is required by the newly introduced
ResourceHints.registerResourceIfNecessary(Resource)method (see #29083).