org.springframework.web.util

Class ServletRequestPathUtils

java.lang.Object

org.springframework.web.util.ServletRequestPathUtils

public abstract class ServletRequestPathUtils
extends Object

Utility class to parse the path of an HttpServletRequest to a RequestPath and cache it in a request attribute for further access. This can then be used for URL path matching with PathPatterns.

Also includes helper methods to return either a previously resolved String lookupPath or a previously parsed RequestPath depending on which is cached in request attributes.

Since:

5.3

Author:

Rossen Stoyanchev

Field Summary

Fields

Modifier and Type	Field and Description
static String	PATH_ATTRIBUTE Name of Servlet request attribute that holds the parsed RequestPath.

Constructor Summary

Constructors

Constructor and Description
ServletRequestPathUtils()

Method Summary

Modifier and Type	Method and Description
static void	clearParsedRequestPath(ServletRequest request) Remove the request attribute PATH_ATTRIBUTE that holds a previously parsed and cached RequestPath.
static Object	getCachedPath(ServletRequest request) Return the pre-resolved String lookupPath or the pre-parsed RequestPath.
static String	getCachedPathValue(ServletRequest request) Variant of getCachedPath(ServletRequest) that returns the path for request mapping as a String.
static RequestPath	getParsedRequestPath(ServletRequest request) Return a previously parsed and cached RequestPath.
static boolean	hasCachedPath(ServletRequest request) Check for a previously resolved String lookupPath or a previously parsed RequestPath.
static boolean	hasParsedRequestPath(ServletRequest request) Check for a previously parsed and cached RequestPath.
static RequestPath	parseAndCache(HttpServletRequest request) Parse the requestURI of the request and its contextPath to create a RequestPath and cache it in the request attribute PATH_ATTRIBUTE.
static void	setParsedRequestPath(RequestPath requestPath, ServletRequest request) Set the cached, parsed RequestPath to the given value.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

PATH_ATTRIBUTE

public static final String PATH_ATTRIBUTE

Name of Servlet request attribute that holds the parsed RequestPath.

Constructor Detail

ServletRequestPathUtils

public ServletRequestPathUtils()

Method Detail

parseAndCache

public static RequestPath parseAndCache(HttpServletRequest request)

Parse the requestURI of the request and its contextPath to create a RequestPath and cache it in the request attribute PATH_ATTRIBUTE.

This method ignores the servletPath and the pathInfo. Therefore in case of a Servlet mapping by prefix, the RequestPath.pathWithinApplication() will always include the Servlet prefix.

getParsedRequestPath

public static RequestPath getParsedRequestPath(ServletRequest request)

Return a previously parsed and cached RequestPath.

Throws:

IllegalArgumentException - if not found

setParsedRequestPath

public static void setParsedRequestPath(@Nullable
                                        RequestPath requestPath,
                                        ServletRequest request)

Set the cached, parsed RequestPath to the given value.

Parameters:

requestPath - the value to set to, or if null the cache value is cleared.

request - the current request

Since:

5.3.3

hasParsedRequestPath

public static boolean hasParsedRequestPath(ServletRequest request)

Check for a previously parsed and cached RequestPath.

clearParsedRequestPath

public static void clearParsedRequestPath(ServletRequest request)

Remove the request attribute PATH_ATTRIBUTE that holds a previously parsed and cached RequestPath.

getCachedPath

public static Object getCachedPath(ServletRequest request)

Return the pre-resolved String lookupPath or the pre-parsed RequestPath.

In Spring MVC, when at least one HandlerMapping has parsed PathPatterns enabled, the DispatcherServlet eagerly parses and caches the RequestPath and the same can be also done earlier with ServletRequestPathFilter. In other cases where HandlerMappings use String pattern matching with PathMatcher, the String lookupPath is resolved separately by each HandlerMapping.

Parameters:

request - the current request

Returns:

a String lookupPath or a RequestPath

Throws:

IllegalArgumentException - if neither is available

getCachedPathValue

public static String getCachedPathValue(ServletRequest request)

Variant of getCachedPath(ServletRequest) that returns the path for request mapping as a String.

If the cached path is a pre-parsed RequestPath then the returned String path value is encoded and with path parameters removed.

If the cached path is a pre-resolved String lookupPath, then the returned String path value depends on how UrlPathHelper that resolved is configured.

Parameters:

request - the current request

Returns:

the full request mapping path as a String

hasCachedPath

public static boolean hasCachedPath(ServletRequest request)

Check for a previously resolved String lookupPath or a previously parsed RequestPath.

Parameters:

request - the current request

Returns:

whether a pre-resolved or pre-parsed path is available