程序包 cn.taketoday.web.servlet

类 UrlPathHelper

java.lang.Object
cn.taketoday.web.servlet.UrlPathHelper
public class UrlPathHelper extends Object
Helper class for URL path matching. Provides support for URL paths in RequestDispatcher includes and support for consistent URL decoding.
从以下版本开始:
4.0 2022/4/7 21:34
作者:
Juergen Hoeller, Rob Harrop, Rossen Stoyanchev, Harry Yang
另请参阅:

  • 字段详细资料

    • PATH_ATTRIBUTE

      public static final String PATH_ATTRIBUTE
      Name of Servlet request attribute that holds a resolved lookupPath.

    • WEBSPHERE_URI_ATTRIBUTE

      private static final String WEBSPHERE_URI_ATTRIBUTE
      Special WebSphere request attribute, indicating the original request URI. Preferable over the standard Servlet 2.4 forward attribute on WebSphere, simply because we need the very first URI in the request forwarding chain.
      另请参阅:

    • log

      private static final cn.taketoday.logging.Logger log

    • websphereComplianceFlag

      @Nullable static volatile Boolean websphereComplianceFlag

    • alwaysUseFullPath

      private boolean alwaysUseFullPath

    • urlDecode

      private boolean urlDecode

    • removeSemicolonContent

      private boolean removeSemicolonContent

    • defaultEncoding

      private String defaultEncoding

    • readOnly

      private boolean readOnly

    • defaultInstance

      public static final UrlPathHelper defaultInstance
      Shared, read-only instance with defaults. The following apply:
      • alwaysUseFullPath=false
      • urlDecode=true
      • removeSemicolon=true
      • defaultEncoding=Constant.DEFAULT_ENCODING

    • rawPathInstance

      public static final UrlPathHelper rawPathInstance
      Shared, read-only instance for the full, encoded path. The following apply:
      • alwaysUseFullPath=true
      • urlDecode=false
      • removeSemicolon=false
      • defaultEncoding=Constant.DEFAULT_ENCODING

  • 构造器详细资料

    • UrlPathHelper

      public UrlPathHelper()

  • 方法详细资料

    • setAlwaysUseFullPath

      public void setAlwaysUseFullPath(boolean alwaysUseFullPath)
      Whether URL lookups should always use the full path within the current web application context, i.e. within ServletContext.getContextPath().

      If set to false the path within the current servlet mapping is used instead if applicable (i.e. in the case of a prefix based Servlet mapping such as "/myServlet/*").

      By default this is set to "false".

    • setUrlDecode

      public void setUrlDecode(boolean urlDecode)
      Whether the context path and request URI should be decoded -- both of which are returned undecoded by the Servlet API, in contrast to the servlet path.

      Either the request encoding or the default Servlet spec encoding (ISO-8859-1) is used when set to "true".

      By default this is set to true.

      Note: Be aware the servlet path will not match when compared to encoded paths. Therefore use of urlDecode=false is not compatible with a prefix-based Servlet mapping and likewise implies also setting alwaysUseFullPath=true.

      另请参阅:

    • isUrlDecode

      public boolean isUrlDecode()
      Whether to decode the request URI when determining the lookup path.

    • setRemoveSemicolonContent

      public void setRemoveSemicolonContent(boolean removeSemicolonContent)
      Set if ";" (semicolon) content should be stripped from the request URI.

      Default is "true".

    • shouldRemoveSemicolonContent

      public boolean shouldRemoveSemicolonContent()
      Whether configured to remove ";" (semicolon) content from the request URI.

    • setDefaultEncoding

      public void setDefaultEncoding(String defaultEncoding)
      Set the default character encoding to use for URL decoding. Default is ISO-8859-1, according to the Servlet spec.

      If the request specifies a character encoding itself, the request encoding will override this setting. This also allows for generically overriding the character encoding in a filter that invokes the ServletRequest.setCharacterEncoding method.

      参数:
      defaultEncoding - the character encoding to use
      另请参阅:

    • getDefaultEncoding

      protected String getDefaultEncoding()
      Return the default character encoding to use for URL decoding.

    • setReadOnly

      private void setReadOnly()
      Switch to read-only mode where further configuration changes are not allowed.

    • checkReadOnly

      private void checkReadOnly()

    • resolveAndCacheLookupPath

      public String resolveAndCacheLookupPath(HttpServletRequest request)
      Resolve the lookupPath and cache it in a request attribute with the key PATH_ATTRIBUTE for subsequent access via getResolvedLookupPath(ServletRequest).
      参数:
      request - the current request
      返回:
      the resolved path

    • getResolvedLookupPath

      public static String getResolvedLookupPath(ServletRequest request)
      Return a previously resolved lookupPath.
      参数:
      request - the current request
      返回:
      the previously resolved lookupPath
      抛出:
      IllegalArgumentException - if the not found

    • getLookupPathForRequest

      @Deprecated public String getLookupPathForRequest(HttpServletRequest request, @Nullable String name)
      已过时。
      in favor of using resolveAndCacheLookupPath(HttpServletRequest) and getResolvedLookupPath(ServletRequest).
      Variant of getLookupPathForRequest(HttpServletRequest) that automates checking for a previously computed lookupPath saved as a request attribute. The attribute is only used for lookup purposes.
      参数:
      request - current HTTP request
      name - the request attribute that holds the lookupPath
      返回:
      the lookup path

    • getLookupPathForRequest

      public String getLookupPathForRequest(HttpServletRequest request)
      Return the mapping lookup path for the given request, within the current servlet mapping if applicable, else within the web application.

      Detects include request URL if called within a RequestDispatcher include.

      参数:
      request - current HTTP request
      返回:
      the lookup path
      另请参阅:

    • skipServletPathDetermination

      private boolean skipServletPathDetermination(HttpServletRequest request)
      Check whether servlet path determination can be skipped for the given request.
      参数:
      request - current HTTP request
      返回:
      true if the request mapping has not been achieved using a path or if the servlet has been mapped to root; false otherwise

    • getPathWithinServletMapping

      public String getPathWithinServletMapping(HttpServletRequest request)
      Return the path within the servlet mapping for the given request, i.e. the part of the request's URL beyond the part that called the servlet, or "" if the whole URL has been used to identify the servlet.
      参数:
      request - current HTTP request
      返回:
      the path within the servlet mapping, or ""
      另请参阅:

    • getPathWithinServletMapping

      protected String getPathWithinServletMapping(HttpServletRequest request, String pathWithinApp)
      Return the path within the servlet mapping for the given request, i.e. the part of the request's URL beyond the part that called the servlet, or "" if the whole URL has been used to identify the servlet.

      Detects include request URL if called within a RequestDispatcher include.

      E.g.: servlet mapping = "/*"; request URI = "/test/a" → "/test/a".

      E.g.: servlet mapping = "/"; request URI = "/test/a" → "/test/a".

      E.g.: servlet mapping = "/test/*"; request URI = "/test/a" → "/a".

      E.g.: servlet mapping = "/test"; request URI = "/test" → "".

      E.g.: servlet mapping = "/*.test"; request URI = "/a.test" → "".

      参数:
      request - current HTTP request
      pathWithinApp - a precomputed path within the application
      返回:
      the path within the servlet mapping, or ""
      另请参阅:

    • getPathWithinApplication

      public String getPathWithinApplication(HttpServletRequest request)
      Return the path within the web application for the given request.

      Detects include request URL if called within a RequestDispatcher include.

      参数:
      request - current HTTP request
      返回:
      the path within the web application
      另请参阅:

    • getRemainingPath

      @Nullable private String getRemainingPath(String requestUri, String mapping, boolean ignoreCase)
      Match the given "mapping" to the start of the "requestUri" and if there is a match return the extra part. This method is needed because the context path and the servlet path returned by the HttpServletRequest are stripped of semicolon content unlike the requestUri.

    • getSanitizedPath

      private static String getSanitizedPath(String path)
      Sanitize the given path. Uses the following rules:
      • replace all "//" by "/"

    • getRequestUri

      public String getRequestUri(HttpServletRequest request)
      Return the request URI for the given request, detecting an include request URL if called within a RequestDispatcher include.

      As the value returned by request.getRequestURI() is not decoded by the servlet container, this method will decode it.

      The URI that the web container resolves should be correct, but some containers like JBoss/Jetty incorrectly include ";" strings like ";jsessionid" in the URI. This method cuts off such incorrect appendices.

      参数:
      request - current HTTP request
      返回:
      the request URI

    • getContextPath

      public String getContextPath(HttpServletRequest request)
      Return the context path for the given request, detecting an include request URL if called within a RequestDispatcher include.

      As the value returned by request.getContextPath() is not decoded by the servlet container, this method will decode it.

      参数:
      request - current HTTP request
      返回:
      the context path

    • getServletPath

      public String getServletPath(HttpServletRequest request)
      Return the servlet path for the given request, regarding an include request URL if called within a RequestDispatcher include.

      As the value returned by request.getServletPath() is already decoded by the servlet container, this method will not attempt to decode it.

      参数:
      request - current HTTP request
      返回:
      the servlet path

    • getOriginatingRequestUri

      public String getOriginatingRequestUri(HttpServletRequest request)
      Return the request URI for the given request. If this is a forwarded request, correctly resolves to the request URI of the original request.

    • getOriginatingContextPath

      public String getOriginatingContextPath(HttpServletRequest request)
      Return the context path for the given request, detecting an include request URL if called within a RequestDispatcher include.

      As the value returned by request.getContextPath() is not decoded by the servlet container, this method will decode it.

      参数:
      request - current HTTP request
      返回:
      the context path

    • getOriginatingServletPath

      public String getOriginatingServletPath(HttpServletRequest request)
      Return the servlet path for the given request, detecting an include request URL if called within a RequestDispatcher include.
      参数:
      request - current HTTP request
      返回:
      the servlet path

    • getOriginatingQueryString

      public String getOriginatingQueryString(HttpServletRequest request)
      Return the query string part of the given request's URL. If this is a forwarded request, correctly resolves to the query string of the original request.
      参数:
      request - current HTTP request
      返回:
      the query string

    • decodeAndCleanUriString

      private String decodeAndCleanUriString(HttpServletRequest request, String uri)
      Decode the supplied URI string and strips any extraneous portion after a ';'.

    • decodeRequestString

      public String decodeRequestString(HttpServletRequest request, String source)
      Decode the given source string with a URLDecoder. The encoding will be taken from the request, falling back to the default "ISO-8859-1".

      The default implementation uses URLDecoder.decode(input, enc).

      参数:
      request - current HTTP request
      source - the String to decode
      返回:
      the decoded String
      另请参阅:

    • decodeInternal

      private String decodeInternal(HttpServletRequest request, String source)

    • determineEncoding

      protected String determineEncoding(HttpServletRequest request)
      Determine the encoding for the given request. Can be overridden in subclasses.

      The default implementation checks the request encoding, falling back to the default encoding specified for this resolver.

      参数:
      request - current HTTP request
      返回:
      the encoding for the request (never null)
      另请参阅:

    • removeSemicolonContent

      public String removeSemicolonContent(String requestUri)
      Remove ";" (semicolon) content from the given request URI if the removeSemicolonContent property is set to "true". Note that "jsessionid" is always removed.
      参数:
      requestUri - the request URI string to remove ";" content from
      返回:
      the updated URI string

    • removeSemicolonContentInternal

      private static String removeSemicolonContentInternal(String requestUri)

    • removeJsessionid

      private String removeJsessionid(String requestUri)

    • decodePathVariables

      public Map<String,String> decodePathVariables(HttpServletRequest request, Map<String,String> vars)
      Decode the given URI path variables via decodeRequestString(jakarta.servlet.http.HttpServletRequest, java.lang.String) unless setUrlDecode(boolean) is set to true in which case it is assumed the URL path from which the variables were extracted is already decoded through a call to getLookupPathForRequest(HttpServletRequest).
      参数:
      request - current HTTP request
      vars - the URI variables extracted from the URL path
      返回:
      the same Map or a new Map instance

    • decodeMatrixVariables

      public cn.taketoday.util.MultiValueMap<String,String> decodeMatrixVariables(HttpServletRequest request, cn.taketoday.util.MultiValueMap<String,String> vars)
      Decode the given matrix variables via decodeRequestString(jakarta.servlet.http.HttpServletRequest, java.lang.String) unless setUrlDecode(boolean) is set to true in which case it is assumed the URL path from which the variables were extracted is already decoded through a call to getLookupPathForRequest(HttpServletRequest).
      参数:
      request - current HTTP request
      vars - the URI variables extracted from the URL path
      返回:
      the same Map or a new Map instance

    • shouldRemoveTrailingServletPathSlash

      private boolean shouldRemoveTrailingServletPathSlash(HttpServletRequest request)