Class ResourceHandlerUtils
java.lang.Object
org.springframework.web.reactive.resource.ResourceHandlerUtils
Resource handling utility methods to share common logic between
 
ResourceWebHandler and org.springframework.web.reactive.function.server.- Since:
 - 6.2
 - Author:
 - Rossen Stoyanchev
 
- 
Constructor Summary
Constructors - 
Method Summary
Modifier and TypeMethodDescriptionstatic voidassertResourceLocation(Resource location) Assert the given location is not null, and its path ends on slash.static ResourcecreateRelativeResource(Resource location, String resourcePath) Create a resource relative to the givenResource, also decoding the resource path for aUrlResource.static StringinitLocationPath(String path) Check if the given static resource location path ends with a trailing slash, and append it if necessary.static booleanisInvalidPath(String path) Checks for invalid resource input paths rejecting the following: Paths that contain "WEB-INF" or "META-INF" Paths that contain "../" after a call toStringUtils.cleanPath(java.lang.String).static booleanisResourceUnderLocation(Resource location, Resource resource) Check whether the resource is under the given location.static StringnormalizeInputPath(String path) Normalize the given resource path replacing the following: Backslash with forward slash.static booleanshouldIgnoreInputPath(String path) Whether the given input path is invalid as determined byisInvalidPath(String). 
- 
Constructor Details
- 
ResourceHandlerUtils
public ResourceHandlerUtils() 
 - 
 - 
Method Details
- 
assertResourceLocation
Assert the given location is not null, and its path ends on slash. - 
initLocationPath
Check if the given static resource location path ends with a trailing slash, and append it if necessary.- Parameters:
 path- the location path- Returns:
 - the resulting path to use
 
 - 
normalizeInputPath
Normalize the given resource path replacing the following:- Backslash with forward slash.
 - Duplicate occurrences of slash with a single slash.
 - Any combination of leading slash and control characters (00-1F and 7F)
 with a single "/" or "". For example 
" / // foo/bar"becomes"/foo/bar". 
 - 
shouldIgnoreInputPath
Whether the given input path is invalid as determined byisInvalidPath(String). The path is also decoded and the same checks are performed again. - 
isInvalidPath
Checks for invalid resource input paths rejecting the following:- Paths that contain "WEB-INF" or "META-INF"
 - Paths that contain "../" after a call to
 
StringUtils.cleanPath(java.lang.String). - Paths that represent a 
valid URLor would represent one after the leading slash is removed. 
Note: this method assumes that leading, duplicate '/' or control characters (e.g. white space) have been trimmed so that the path starts predictably with a single '/' or does not have one.
- Parameters:
 path- the path to validate- Returns:
 trueif the path is invalid,falseotherwise
 - 
createRelativeResource
public static Resource createRelativeResource(Resource location, String resourcePath) throws IOException Create a resource relative to the givenResource, also decoding the resource path for aUrlResource.- Throws:
 IOException
 - 
isResourceUnderLocation
public static boolean isResourceUnderLocation(Resource location, Resource resource) throws IOException Check whether the resource is under the given location.- Throws:
 IOException
 
 -