Package io.microsphere.spring.web.util

Class WebRequestUtils

java.lang.Object
io.microsphere.spring.web.util.WebRequestUtils
public abstract class WebRequestUtils extends Object
WebRequest Utilities class
Since:
1.0.0
Author:
Mercy

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final String
    METHOD_HEADER_NAME
    The header name for HTTP method
    static final String
    PATH_ATTRIBUTE
    Name of Servlet request attribute that holds a resolved lookupPath.

  • Method Summary

    Modifier and Type
    Method
    Description
    static void
    addCookie(org.springframework.web.context.request.NativeWebRequest request, String cookieName, String cookieValue)
    Adds the specified cookie to the response.
    static void
    addHeader(org.springframework.web.context.request.NativeWebRequest request, String headerName, String... headerValues)
    Adds a response header with the given name and value.
    static Object
    getBestMatchingHandler(org.springframework.web.context.request.NativeWebRequest request)
    Get the mapped handler for the best matching pattern.
    static String
    getBestMatchingPattern(org.springframework.web.context.request.NativeWebRequest request)
    Get the best matching pattern within the handler mapping.
    static String
    getContentType(org.springframework.web.context.request.NativeWebRequest request)
     
    static String
    getCookieValue(org.springframework.web.context.request.NativeWebRequest request, String cookieName)
    Get the cookie value for the given cookie name.
    static String
    getHeader(org.springframework.web.context.request.NativeWebRequest request, String headerName)
    Get the header value from the request by the given header name.
    static String[]
    getHeaderValues(org.springframework.web.context.request.NativeWebRequest request, String headerName)
    Get the header values from the request by the given header name.
    static Map<String,org.springframework.util.MultiValueMap<String,String>>
    getMatrixVariables(org.springframework.web.context.request.NativeWebRequest request)
    Get a map with URI variable names and a corresponding MultiValueMap of URI matrix variables for each.
    static String
    getMethod(org.springframework.web.context.request.NativeWebRequest request)
    Get the HTTP method of the current request.
    static String
    getPathWithinHandlerMapping(org.springframework.web.context.request.NativeWebRequest request)
    Get the path within the handler mapping, in case of a pattern match, or the full relevant URI (typically within the DispatcherServlet's mapping) else.
    static Set<org.springframework.http.MediaType>
    getProducibleMediaTypes(org.springframework.web.context.request.NativeWebRequest request)
    Get the set of producible MediaTypes applicable to the mapped handler.
    static <T> T
    getRequestBody(org.springframework.web.context.request.NativeWebRequest request, Class<T> requestBodyType)
     
    static String
    getResolvedLookupPath(org.springframework.web.context.request.NativeWebRequest request)
    Return a previously resolved lookupPath.
    protected static SpringWebHelper
    getSpringWebHelper(org.springframework.web.context.request.NativeWebRequest request)
     
    static Map<String,String>
    getUriTemplateVariables(org.springframework.web.context.request.NativeWebRequest request)
    Get the URI templates map, mapping variable names to values.
    static boolean
    hasBody(org.springframework.web.context.request.NativeWebRequest request)
     
    static boolean
    isPreFlightRequest(org.springframework.web.context.request.NativeWebRequest request)
    Returns true if the request is a valid CORS pre-flight one by checking OPTIONS method with Origin and Access-Control-Request-Method headers presence.
    static org.springframework.http.MediaType
    parseContentType(org.springframework.web.context.request.NativeWebRequest request)
     
    static void
    setHeader(org.springframework.web.context.request.NativeWebRequest request, String headerName, String headerValue)
    Sets a response header with the given name and value.
    static void
    writeResponseBody(org.springframework.web.context.request.NativeWebRequest request, String name, String value)
    Write value to the response body.

    Methods inherited from class java.lang.Object

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

  • Field Details

    • METHOD_HEADER_NAME

      public static final String METHOD_HEADER_NAME
      The header name for HTTP method
      See Also:

    • PATH_ATTRIBUTE

      public static final String PATH_ATTRIBUTE
      Name of Servlet request attribute that holds a resolved lookupPath.
      Since:
      Spring Framework 5.3

  • Method Details

    • getMethod

      @Nullable public static String getMethod(@Nonnull org.springframework.web.context.request.NativeWebRequest request)
      Get the HTTP method of the current request.
      Parameters:
      request - the NativeWebRequest
      Returns:
      the HTTP method if found, otherwise null
      See Also:
      • HttpServletRequest.getMethod()
      • HttpRequest.getMethod()

    • isPreFlightRequest

      public static boolean isPreFlightRequest(@Nonnull org.springframework.web.context.request.NativeWebRequest request)
      Returns true if the request is a valid CORS pre-flight one by checking OPTIONS method with Origin and Access-Control-Request-Method headers presence.

    • getContentType

      public static String getContentType(@Nonnull org.springframework.web.context.request.NativeWebRequest request)

    • parseContentType

      @Nullable public static org.springframework.http.MediaType parseContentType(@Nonnull org.springframework.web.context.request.NativeWebRequest request)

    • hasBody

      public static boolean hasBody(@Nonnull org.springframework.web.context.request.NativeWebRequest request)

    • getResolvedLookupPath

      public static String getResolvedLookupPath(@Nonnull org.springframework.web.context.request.NativeWebRequest request)
      Return a previously resolved lookupPath.
      Parameters:
      request - the current request
      Returns:
      the previously resolved lookupPath
      Throws:
      IllegalArgumentException - if the lookup path is not found

    • getHeader

      @Nullable public static String getHeader(@Nonnull org.springframework.web.context.request.NativeWebRequest request, String headerName)
      Get the header value from the request by the given header name.
      Parameters:
      request - the NativeWebRequest
      headerName - the name of header
      Returns:
      the header value if found, otherwise null
      See Also:
      • HttpServletRequest.getHeader(String)
      • HttpMessage.getHeaders()
      • HttpHeaders.getFirst(String)

    • getHeaderValues

      @Nullable public static String[] getHeaderValues(@Nonnull org.springframework.web.context.request.NativeWebRequest request, String headerName)
      Get the header values from the request by the given header name.
      Parameters:
      request - the NativeWebRequest
      headerName - the name of header
      Returns:
      the header values if found, otherwise null
      See Also:
      • HttpServletRequest.getHeaders(String)
      • HttpMessage.getHeaders()
      • HttpHeaders.get(Object)

    • setHeader

      public static void setHeader(@Nonnull org.springframework.web.context.request.NativeWebRequest request, @Nullable String headerName, @Nullable String headerValue)
      Sets a response header with the given name and value. If the header had already been set, the new value overwrites all previous values.
      Parameters:
      request - the NativeWebRequest
      headerName - the name of header
      headerValue - the header value
      See Also:
      • HttpServletResponse.setHeader(String, String)
      • HttpHeaders.set(String, String)

    • addHeader

      public static void addHeader(@Nonnull org.springframework.web.context.request.NativeWebRequest request, @Nullable String headerName, @Nullable String... headerValues)
      Adds a response header with the given name and value. This method allows response headers to have multiple values.
      Parameters:
      request - the NativeWebRequest
      headerName - the name of header
      headerValues - the header values
      See Also:
      • HttpServletResponse.addHeader(String, String)
      • HttpHeaders.add(String, String)

    • getCookieValue

      @Nullable public static String getCookieValue(@Nonnull org.springframework.web.context.request.NativeWebRequest request, String cookieName)
      Get the cookie value for the given cookie name.
      Parameters:
      request - the NativeWebRequest
      cookieName - the name of Cookie
      Returns:
      the cookie value if found, otherwise null

    • addCookie

      public static void addCookie(@Nonnull org.springframework.web.context.request.NativeWebRequest request, String cookieName, String cookieValue)
      Adds the specified cookie to the response. This method can be called multiple times to set more than one cookie.
      Parameters:
      request - the NativeWebRequest
      cookieName - the name of Cookie
      cookieValue - the cookie value
      See Also:
      • HttpServletResponse.addCookie(Cookie)
      • ServerHttpResponse.addCookie(ResponseCookie)

    • getRequestBody

      @Nullable public static <T> T getRequestBody(@Nonnull org.springframework.web.context.request.NativeWebRequest request, Class<T> requestBodyType)

    • writeResponseBody

      public static void writeResponseBody(@Nonnull org.springframework.web.context.request.NativeWebRequest request, String name, String value)
      Write value to the response body.
      Parameters:
      request - the NativeWebRequest
      name - the name
      value - the value

    • getBestMatchingHandler

      @Nullable public static Object getBestMatchingHandler(@Nonnull org.springframework.web.context.request.NativeWebRequest request)
      Get the mapped handler for the best matching pattern.
      Parameters:
      request - the NativeWebRequest
      Returns:
      the mapped handler for the best matching pattern if found, otherwise null
      See Also:
      • HandlerMethod
      • org.springframework.web.servlet.function.RouterFunction
      • org.springframework.web.reactive.function.server.RouterFunction
      • org.springframework.web.servlet.HandlerMapping#getHandler
      • org.springframework.web.reactive.HandlerMapping#getHandler
      • org.springframework.web.servlet.HandlerMapping#BEST_MATCHING_HANDLER_ATTRIBUTE
      • org.springframework.web.reactive.HandlerMapping#BEST_MATCHING_HANDLER_ATTRIBUTE

    • getPathWithinHandlerMapping

      @Nullable public static String getPathWithinHandlerMapping(@Nonnull org.springframework.web.context.request.NativeWebRequest request)
      Get the path within the handler mapping, in case of a pattern match, or the full relevant URI (typically within the DispatcherServlet's mapping) else.
      Parameters:
      request - the NativeWebRequest
      Returns:
      the path within handler mapping if found, otherwise null
      See Also:
      • org.springframework.web.servlet.handler.AbstractUrlHandlerMapping#exposePathWithinMapping
      • org.springframework.web.reactive.handler.AbstractUrlHandlerMapping#lookupHandler
      • org.springframework.web.servlet.HandlerMapping#PATH_WITHIN_HANDLER_MAPPING_ATTRIBUTE
      • org.springframework.web.reactive.HandlerMapping#PATH_WITHIN_HANDLER_MAPPING_ATTRIBUTE

    • getBestMatchingPattern

      @Nullable public static String getBestMatchingPattern(@Nonnull org.springframework.web.context.request.NativeWebRequest request)
      Get the best matching pattern within the handler mapping.
      Parameters:
      request - the NativeWebRequest
      Returns:
      the best matching pattern within the handler mapping if found, otherwise null
      See Also:
      • RequestMapping.path()
      • org.springframework.web.servlet.handler.AbstractUrlHandlerMapping#exposePathWithinMapping
      • org.springframework.web.reactive.handler.AbstractUrlHandlerMapping#lookupHandler
      • org.springframework.web.servlet.HandlerMapping#BEST_MATCHING_PATTERN_ATTRIBUTE
      • org.springframework.web.reactive.HandlerMapping#BEST_MATCHING_PATTERN_ATTRIBUTE

    • getUriTemplateVariables

      @Nullable public static Map<String,String> getUriTemplateVariables(@Nonnull org.springframework.web.context.request.NativeWebRequest request)
      Get the URI templates map, mapping variable names to values.
      Parameters:
      request - the NativeWebRequest
      Returns:
      the URI template variables if found, otherwise null
      See Also:
      • PathVariable
      • org.springframework.web.servlet.handler.AbstractUrlHandlerMapping#exposeUriTemplateVariables
      • org.springframework.web.reactive.handler.AbstractUrlHandlerMapping#lookupHandler
      • org.springframework.web.servlet.HandlerMapping#URI_TEMPLATE_VARIABLES_ATTRIBUTE
      • org.springframework.web.reactive.HandlerMapping#URI_TEMPLATE_VARIABLES_ATTRIBUTE

    • getMatrixVariables

      @Nullable public static Map<String,org.springframework.util.MultiValueMap<String,String>> getMatrixVariables(org.springframework.web.context.request.NativeWebRequest request)
      Get a map with URI variable names and a corresponding MultiValueMap of URI matrix variables for each.
      Parameters:
      request - the NativeWebRequest
      Returns:
      the matrix variables if found, otherwise null
      See Also:
      • MatrixVariable
      • org.springframework.web.servlet.mvc.method.annotation.MatrixVariableMapMethodArgumentResolver#resolveArgument
      • org.springframework.web.reactive.result.method.annotation.MatrixVariableMapMethodArgumentResolver#resolveArgumentValue
      • org.springframework.web.servlet.HandlerMapping#MATRIX_VARIABLES_ATTRIBUTE
      • org.springframework.web.reactive.HandlerMapping#MATRIX_VARIABLES_ATTRIBUTE

    • getProducibleMediaTypes

      @Nullable public static Set<org.springframework.http.MediaType> getProducibleMediaTypes(@Nonnull org.springframework.web.context.request.NativeWebRequest request)
      Get the set of producible MediaTypes applicable to the mapped handler.
      Parameters:
      request - the NativeWebRequest
      Returns:
      the producible media types if found, otherwise null
      See Also:
      • RequestMapping.produces()
      • org.springframework.web.servlet.mvc.method.RequestMappingInfoHandlerMapping#handleMatch
      • org.springframework.web.reactive.result.method.RequestMappingInfoHandlerMapping#handleMatch
      • org.springframework.web.servlet.HandlerMapping#PRODUCIBLE_MEDIA_TYPES_ATTRIBUTE
      • org.springframework.web.reactive.HandlerMapping#PRODUCIBLE_MEDIA_TYPES_ATTRIBUTE

    • getSpringWebHelper

      protected static SpringWebHelper getSpringWebHelper(org.springframework.web.context.request.NativeWebRequest request)