程序包 cn.taketoday.web.util

类 UriComponentsBuilder

java.lang.Object
cn.taketoday.web.util.UriComponentsBuilder
所有已实现的接口:
UriBuilder, Cloneable
直接已知子类:
ServletUriComponentsBuilder
public class UriComponentsBuilder extends Object implements UriBuilder, Cloneable
Builder for UriComponents.

Typical usage involves:

  1. Create a UriComponentsBuilder with one of the static factory methods (such as fromPath(String) or fromUri(URI))
  2. Set the various URI components through the respective methods (scheme(String), userInfo(String), host(String), port(int), path(String), pathSegment(String...), queryParam(String, Object...), and fragment(String).
  3. Build the UriComponents instance with the build() method.
从以下版本开始:
4.0
作者:
Arjen Poutsma, Rossen Stoyanchev, Phillip Webb, Oliver Gierke, Brian Clozel, Sebastien Deleuze, Sam Brannen, Harry Yang
另请参阅:

  • 字段详细资料

  • 构造器详细资料

    • UriComponentsBuilder

      protected UriComponentsBuilder()
      Default constructor. Protected to prevent direct instantiation.
      另请参阅:

    • UriComponentsBuilder

      protected UriComponentsBuilder(UriComponentsBuilder other)
      Create a deep copy of the given UriComponentsBuilder.
      参数:
      other - the other builder to copy from

  • 方法详细资料

    • newInstance

      public static UriComponentsBuilder newInstance()
      Create a new, empty builder.
      返回:
      the new UriComponentsBuilder

    • fromPath

      public static UriComponentsBuilder fromPath(String path)
      Create a builder that is initialized with the given path.
      参数:
      path - the path to initialize with
      返回:
      the new UriComponentsBuilder

    • fromUri

      public static UriComponentsBuilder fromUri(URI uri)
      Create a builder that is initialized from the given URI.

      Note: the components in the resulting builder will be in fully encoded (raw) form and further changes must also supply values that are fully encoded, for example via methods in UriUtils. In addition please use build(boolean) with a value of "true" to build the UriComponents instance in order to indicate that the components are encoded.

      参数:
      uri - the URI to initialize with
      返回:
      the new UriComponentsBuilder

    • fromUriString

      public static UriComponentsBuilder fromUriString(String uri)
      Create a builder that is initialized with the given URI string.

      Note: The presence of reserved characters can prevent correct parsing of the URI string. For example if a query parameter contains '=' or '&' characters, the query string cannot be parsed unambiguously. Such values should be substituted for URI variables to enable correct parsing: 

       String uriString = "/hotels/42?filter={value}";
 UriComponentsBuilder.fromUriString(uriString).buildAndExpand("hot&cold");
      参数:
      uri - the URI string to initialize with
      返回:
      the new UriComponentsBuilder

    • fromHttpUrl

      public static UriComponentsBuilder fromHttpUrl(String httpUrl)
      Create a URI components builder from the given HTTP URL String.

      Note: The presence of reserved characters can prevent correct parsing of the URI string. For example if a query parameter contains '=' or '&' characters, the query string cannot be parsed unambiguously. Such values should be substituted for URI variables to enable correct parsing: 

       String urlString = "https://example.com/hotels/42?filter={value}";
 UriComponentsBuilder.fromHttpUrl(urlString).buildAndExpand("hot&cold");
      参数:
      httpUrl - the source URI
      返回:
      the URI components of the URI

    • fromHttpRequest

      public static UriComponentsBuilder fromHttpRequest(HttpRequest request)
      Create a new UriComponents object from the URI associated with the given HttpRequest while also overlaying with values from the headers "Forwarded" (RFC 7239), or "X-Forwarded-Host", "X-Forwarded-Port", and "X-Forwarded-Proto" if "Forwarded" is not found.
      参数:
      request - the source request
      返回:
      the URI components of the URI

    • fromOriginHeader

      public static UriComponentsBuilder fromOriginHeader(String origin)
      Create an instance by parsing the "Origin" header of an HTTP request.
      另请参阅:

    • encode

      public final UriComponentsBuilder encode()
      Request to have the URI template pre-encoded at build time, and URI variables encoded separately when expanded.

      In comparison to UriComponents.encode(), this method has the same effect on the URI template, i.e. each URI component is encoded by replacing non-ASCII and illegal (within the URI component type) characters with escaped octets. However URI variables are encoded more strictly, by also escaping characters with reserved meaning.

      For most cases, this method is more likely to give the expected result because in treats URI variables as opaque data to be fully encoded, while UriComponents.encode() is useful when intentionally expanding URI variables that contain reserved characters.

      For example ';' is legal in a path but has reserved meaning. This method replaces ";" with "%3B" in URI variables but not in the URI template. By contrast, UriComponents.encode() never replaces ";" since it is a legal character in a path.

      When not expanding URI variables at all, prefer use of UriComponents.encode() since that will also encode anything that incidentally looks like a URI variable.

    • encode

      public UriComponentsBuilder encode(Charset charset)
      A variant of encode() with a charset other than "UTF-8".
      参数:
      charset - the charset to use for encoding

    • build

      public UriComponents build()
      Build a UriComponents instance from the various components contained in this builder.
      返回:
      the URI components

    • build

      public UriComponents build(boolean encoded)
      Variant of build() to create a UriComponents instance when components are already fully encoded. This is useful for example if the builder was created via fromUri(URI).
      参数:
      encoded - whether the components in this builder are already encoded
      返回:
      the URI components
      抛出:
      IllegalArgumentException - if any of the components contain illegal characters that should have been encoded.

    • buildInternal

      private UriComponents buildInternal(UriComponentsBuilder.EncodingHint hint)

    • buildAndExpand

      public UriComponents buildAndExpand(Map<String,?> uriVariables)
      Build a UriComponents instance and replaces URI template variables with the values from a map. This is a shortcut method which combines calls to build() and then UriComponents.expand(Map).
      参数:
      uriVariables - the map of URI variables
      返回:
      the URI components with expanded values

    • buildAndExpand

      public UriComponents buildAndExpand(Object... uriVariableValues)
      Build a UriComponents instance and replaces URI template variables with the values from an array. This is a shortcut method which combines calls to build() and then UriComponents.expand(Object...).
      参数:
      uriVariableValues - the URI variable values
      返回:
      the URI components with expanded values

    • build

      public URI build(Object... uriVariables)
      从接口复制的说明: UriBuilder
      Build a URI instance and replaces URI template variables with the values from an array.
      指定者:
      build 在接口中 UriBuilder
      参数:
      uriVariables - the map of URI variables
      返回:
      the URI

    • build

      public URI build(Map<String,?> uriVariables)
      从接口复制的说明: UriBuilder
      Build a URI instance and replaces URI template variables with the values from a map.
      指定者:
      build 在接口中 UriBuilder
      参数:
      uriVariables - the map of URI variables
      返回:
      the URI

    • toUriString

      public String toUriString()
      Build a URI String.

      Effectively, a shortcut for building, encoding, and returning the String representation: 

       String uri = builder.build().encode().toUriString()

      However if URI variables have been provided then the URI template is pre-encoded separately from URI variables (see encode() for details), i.e. equivalent to: 

       String uri = builder.encode().build().toUriString()
      另请参阅:

    • uri

      public UriComponentsBuilder uri(URI uri)
      Initialize components of this builder from components of the given URI.
      参数:
      uri - the URI
      返回:
      this UriComponentsBuilder

    • uriComponents

      public UriComponentsBuilder uriComponents(UriComponents uriComponents)
      Set or append individual URI components of this builder from the values of the given UriComponents instance.

      For the semantics of each component (i.e. set vs append) check the builder methods on this class. For example host(String) sets while path(String) appends.

      参数:
      uriComponents - the UriComponents to copy from
      返回:
      this UriComponentsBuilder

    • scheme

      public UriComponentsBuilder scheme(@Nullable String scheme)
      从接口复制的说明: UriBuilder
      Set the URI scheme which may contain URI template variables, and may also be null to clear the scheme of this builder.
      指定者:
      scheme 在接口中 UriBuilder
      参数:
      scheme - the URI scheme

    • schemeSpecificPart

      public UriComponentsBuilder schemeSpecificPart(String ssp)
      Set the URI scheme-specific-part. When invoked, this method overwrites user-info, host, port, path, and query.
      参数:
      ssp - the URI scheme-specific-part, may contain URI template parameters
      返回:
      this UriComponentsBuilder

    • userInfo

      public UriComponentsBuilder userInfo(@Nullable String userInfo)
      从接口复制的说明: UriBuilder
      Set the URI user info which may contain URI template variables, and may also be null to clear the user info of this builder.
      指定者:
      userInfo 在接口中 UriBuilder
      参数:
      userInfo - the URI user info

    • host

      public UriComponentsBuilder host(@Nullable String host)
      从接口复制的说明: UriBuilder
      Set the URI host which may contain URI template variables, and may also be null to clear the host of this builder.
      指定者:
      host 在接口中 UriBuilder
      参数:
      host - the URI host

    • port

      public UriComponentsBuilder port(int port)
      从接口复制的说明: UriBuilder
      Set the URI port. Passing -1 will clear the port of this builder.
      指定者:
      port 在接口中 UriBuilder
      参数:
      port - the URI port

    • port

      public UriComponentsBuilder port(@Nullable String port)
      从接口复制的说明: UriBuilder
      Set the URI port . Use this method only when the port needs to be parameterized with a URI variable. Otherwise use UriBuilder.port(int). Passing null will clear the port of this builder.
      指定者:
      port 在接口中 UriBuilder
      参数:
      port - the URI port

    • path

      public UriComponentsBuilder path(String path)
      从接口复制的说明: UriBuilder
      Append to the path of this builder.

      The given value is appended as-is to previous path values without inserting any additional slashes. For example: 

      
 builder.path("/first-").path("value/").path("/{id}").build("123")

 // Results is "/first-value/123"

      By contrast pathSegment does insert slashes between individual path segments. For example: 

      
 builder.pathSegment("first-value", "second-value").path("/")

 // Results is "/first-value/second-value/"

      The resulting full path is normalized to eliminate duplicate slashes.

      Note: When inserting a URI variable value that contains slashes in a path, whether those are encoded depends on the configured encoding mode. For more details, see encode(), or otherwise if building URIs indirectly via WebClient or RestTemplate, see its encodingMode. Also see the URI Encoding section of the reference docs.

      指定者:
      path 在接口中 UriBuilder
      参数:
      path - the URI path

    • pathSegment

      public UriComponentsBuilder pathSegment(String... pathSegments) throws IllegalArgumentException
      从接口复制的说明: UriBuilder
      Append to the path using path segments. For example: 
      
 builder.pathSegment("first-value", "second-value", "{id}").build("123")

 // Results is "/first-value/second-value/123"

      If slashes are present in a path segment, they are encoded: 

      
 builder.pathSegment("ba/z", "{id}").build("a/b")

 // Results is "/ba%2Fz/a%2Fb"
      To insert a trailing slash, use the UriBuilder.path(java.lang.String) builder method: 
      
 builder.pathSegment("first-value", "second-value").path("/")

 // Results is "/first-value/second-value/"

      Empty path segments are ignored and therefore duplicate slashes do not appear in the resulting full path.

      指定者:
      pathSegment 在接口中 UriBuilder
      参数:
      pathSegments - the URI path segments
      抛出:
      IllegalArgumentException

    • replacePath

      public UriComponentsBuilder replacePath(@Nullable String path)
      从接口复制的说明: UriBuilder
      Override the current path.
      指定者:
      replacePath 在接口中 UriBuilder
      参数:
      path - the URI path, or null for an empty path

    • query

      public UriComponentsBuilder query(@Nullable String query)
      从接口复制的说明: UriBuilder
      Parse the given query string into query parameters where parameters are separated with '&' and their values, if any, with '='. The query may contain URI template variables.

      Note: please, review the Javadoc of UriBuilder.queryParam(String, Object...) for further notes on the treatment and encoding of individual query parameters.

      指定者:
      query 在接口中 UriBuilder
      参数:
      query - the query string

    • replaceQuery

      public UriComponentsBuilder replaceQuery(@Nullable String query)
      从接口复制的说明: UriBuilder
      Clear existing query parameters and then delegate to UriBuilder.query(String).

      Note: please, review the Javadoc of UriBuilder.queryParam(String, Object...) for further notes on the treatment and encoding of individual query parameters.

      指定者:
      replaceQuery 在接口中 UriBuilder
      参数:
      query - the query string; a null value removes all query parameters.

    • queryParam

      public UriComponentsBuilder queryParam(String name, Object... values)
      从接口复制的说明: UriBuilder
      Append the given query parameter. Both the parameter name and values may contain URI template variables to be expanded later from values. If no values are given, the resulting URI will contain the query parameter name only, e.g. "?foo" instead of "?foo=bar".

      Note: encoding, if applied, will only encode characters that are illegal in a query parameter name or value such as "=" or "&". All others that are legal as per syntax rules in RFC 3986 are not encoded. This includes "+" which sometimes needs to be encoded to avoid its interpretation as an encoded space. Stricter encoding may be applied by using a URI template variable along with stricter encoding on variable values. For more details please read the "URI Encoding" section of the Framework reference.

      指定者:
      queryParam 在接口中 UriBuilder
      参数:
      name - the query parameter name
      values - the query parameter values
      另请参阅:

    • getQueryParamValue

      @Nullable private String getQueryParamValue(@Nullable Object value)

    • queryParam

      public UriComponentsBuilder queryParam(String name, @Nullable Collection<?> values)
      从接口复制的说明: UriBuilder
      Variant of UriBuilder.queryParam(String, Object...) with a Collection.

      Note: please, review the Javadoc of UriBuilder.queryParam(String, Object...) for further notes on the treatment and encoding of individual query parameters.

      指定者:
      queryParam 在接口中 UriBuilder
      参数:
      name - the query parameter name
      values - the query parameter values
      另请参阅:

    • queryParamIfPresent

      public UriComponentsBuilder queryParamIfPresent(String name, Optional<?> value)
      从接口复制的说明: UriBuilder
      Delegates to either UriBuilder.queryParam(String, Object...) or UriBuilder.queryParam(String, Collection) if the given Optional has a value, or else if it is empty, no query parameter is added at all.
      指定者:
      queryParamIfPresent 在接口中 UriBuilder
      参数:
      name - the query parameter name
      value - an Optional, either empty or holding the query parameter value.

    • queryParams

      public UriComponentsBuilder queryParams(@Nullable cn.taketoday.util.MultiValueMap<String,String> params)
      Add multiple query parameters and values.

      Note: please, review the Javadoc of UriBuilder.queryParam(String, Object...) for further notes on the treatment and encoding of individual query parameters.

      指定者:
      queryParams 在接口中 UriBuilder
      参数:
      params - the params

    • replaceQueryParam

      public UriComponentsBuilder replaceQueryParam(String name, Object... values)
      从接口复制的说明: UriBuilder
      Set the query parameter values replacing existing values, or if no values are given, the query parameter is removed.

      Note: please, review the Javadoc of UriBuilder.queryParam(String, Object...) for further notes on the treatment and encoding of individual query parameters.

      指定者:
      replaceQueryParam 在接口中 UriBuilder
      参数:
      name - the query parameter name
      values - the query parameter values
      另请参阅:

    • replaceQueryParam

      public UriComponentsBuilder replaceQueryParam(String name, @Nullable Collection<?> values)
      从接口复制的说明: UriBuilder
      Variant of UriBuilder.replaceQueryParam(String, Object...) with a Collection.

      Note: please, review the Javadoc of UriBuilder.queryParam(String, Object...) for further notes on the treatment and encoding of individual query parameters.

      指定者:
      replaceQueryParam 在接口中 UriBuilder
      参数:
      name - the query parameter name
      values - the query parameter values
      另请参阅:

    • replaceQueryParams

      public UriComponentsBuilder replaceQueryParams(@Nullable cn.taketoday.util.MultiValueMap<String,String> params)
      Set the query parameter values after removing all existing ones.

      Note: please, review the Javadoc of UriBuilder.queryParam(String, Object...) for further notes on the treatment and encoding of individual query parameters.

      指定者:
      replaceQueryParams 在接口中 UriBuilder
      参数:
      params - the query parameter name

    • fragment

      public UriComponentsBuilder fragment(@Nullable String fragment)
      从接口复制的说明: UriBuilder
      Set the URI fragment. The given fragment may contain URI template variables, and may also be null to clear the fragment of this builder.
      指定者:
      fragment 在接口中 UriBuilder
      参数:
      fragment - the URI fragment

    • uriVariables

      public UriComponentsBuilder uriVariables(Map<String,Object> uriVariables)
      Configure URI variables to be expanded at build time.

      The provided variables may be a subset of all required ones. At build time, the available ones are expanded, while unresolved URI placeholders are left in place and can still be expanded later.

      In contrast to UriComponents.expand(Map) or buildAndExpand(Map), this method is useful when you need to supply URI variables without building the UriComponents instance just yet, or perhaps pre-expand some shared default values such as host and port.

      参数:
      uriVariables - the URI variables to use
      返回:
      this UriComponentsBuilder

    • resetHierarchicalComponents

      private void resetHierarchicalComponents()

    • resetSchemeSpecificPart

      private void resetSchemeSpecificPart()

    • resetPortIfDefaultForScheme

      void resetPortIfDefaultForScheme()

    • clone

      public Object clone()
      Public declaration of Object's clone() method. Delegates to cloneBuilder().
      覆盖:
      clone 在类中 Object

    • cloneBuilder

      public UriComponentsBuilder cloneBuilder()
      Clone this UriComponentsBuilder.
      返回:
      the cloned UriComponentsBuilder object