org.springframework.web.util

Class DefaultUriBuilderFactory

java.lang.Object

org.springframework.web.util.DefaultUriBuilderFactory

All Implemented Interfaces:

UriBuilderFactory, UriTemplateHandler

public class DefaultUriBuilderFactory
extends java.lang.Object
implements UriBuilderFactory

UriBuilderFactory that relies on UriComponentsBuilder for the actual building of the URI.

Provides options to create UriBuilder instances with a common base URI, alternative encoding mode strategies, among others.

Since:

5.0

Author:

Rossen Stoyanchev

See Also:

UriComponentsBuilder

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DefaultUriBuilderFactory.EncodingMode Constants that represent different URI encoding strategies.

Constructor Summary

Constructors

Constructor and Description
DefaultUriBuilderFactory() Default constructor without a base URI.
DefaultUriBuilderFactory(java.lang.String baseUriTemplate) Constructor with a base URI.
DefaultUriBuilderFactory(UriComponentsBuilder baseUri) Variant of DefaultUriBuilderFactory(String) with a UriComponentsBuilder.

Method Summary

Modifier and Type	Method and Description
UriBuilder	builder() Create a URI builder with default settings.
java.net.URI	expand(java.lang.String uriTemplate, java.util.Map<java.lang.String,?> uriVars) Expand the given URI template with a map of URI variables.
java.net.URI	expand(java.lang.String uriTemplate, java.lang.Object... uriVars) Expand the given URI template with an array of URI variables.
java.util.Map<java.lang.String,?>	getDefaultUriVariables() Return the configured default URI variable values.
DefaultUriBuilderFactory.EncodingMode	getEncodingMode() Return the configured encoding mode.
void	setDefaultUriVariables(java.util.Map<java.lang.String,?> defaultUriVariables) Provide default URI variable values to use when expanding URI templates with a Map of variables.
void	setEncodingMode(DefaultUriBuilderFactory.EncodingMode encodingMode) Specify the EncodingMode to use when building URIs.
void	setParsePath(boolean parsePath) Whether to parse the path into path segments for the URI string passed into uriString(String) or one of the expand methods.
boolean	shouldParsePath() Whether the handler is configured to parse the path into path segments.
UriBuilder	uriString(java.lang.String uriTemplate) Initialize a builder with the given URI template.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultUriBuilderFactory

public DefaultUriBuilderFactory()

Default constructor without a base URI.

The target address must be specified on each UriBuilder.

DefaultUriBuilderFactory

public DefaultUriBuilderFactory(java.lang.String baseUriTemplate)

Constructor with a base URI.

The given URI template is parsed via UriComponentsBuilder.fromUriString(java.lang.String) and then applied as a base URI to every UriBuilder via UriComponentsBuilder.uriComponents(org.springframework.web.util.UriComponents) unless the UriBuilder itself was created with a URI template that already has a target address.

Parameters:

baseUriTemplate - the URI template to use a base URL

DefaultUriBuilderFactory

public DefaultUriBuilderFactory(UriComponentsBuilder baseUri)

Variant of DefaultUriBuilderFactory(String) with a UriComponentsBuilder.

Method Detail

setDefaultUriVariables

public void setDefaultUriVariables(@Nullable
                                   java.util.Map<java.lang.String,?> defaultUriVariables)

Provide default URI variable values to use when expanding URI templates with a Map of variables.

Parameters:

defaultUriVariables - default URI variable values

getDefaultUriVariables

public java.util.Map<java.lang.String,?> getDefaultUriVariables()

Return the configured default URI variable values.

setEncodingMode

public void setEncodingMode(DefaultUriBuilderFactory.EncodingMode encodingMode)

Specify the EncodingMode to use when building URIs.

By default set to EncodingMode.URI_COMPONENT.

Parameters:

encodingMode - the encoding mode to use

getEncodingMode

public DefaultUriBuilderFactory.EncodingMode getEncodingMode()

Return the configured encoding mode.

setParsePath

public void setParsePath(boolean parsePath)

Whether to parse the path into path segments for the URI string passed into uriString(String) or one of the expand methods.

Setting this property to true ensures that URI variables expanded into the path are subject to path segment encoding rules and "/" characters are percent-encoded. If set to false the path is kept as a full path and expanded URI variables will have "/" characters preserved.

By default this is set to true.

Parameters:

parsePath - whether to parse the path into path segments

shouldParsePath

public boolean shouldParsePath()

Whether the handler is configured to parse the path into path segments.

expand

public java.net.URI expand(java.lang.String uriTemplate,
                           java.util.Map<java.lang.String,?> uriVars)

Description copied from interface: UriTemplateHandler

Expand the given URI template with a map of URI variables.

Specified by:

expand in interface UriTemplateHandler

Parameters:

uriTemplate - the URI template

uriVars - variable values

Returns:

the created URI instance

expand

public java.net.URI expand(java.lang.String uriTemplate,
                           java.lang.Object... uriVars)

Description copied from interface: UriTemplateHandler

Expand the given URI template with an array of URI variables.

Specified by:

expand in interface UriTemplateHandler

Parameters:

uriTemplate - the URI template

uriVars - variable values

Returns:

the created URI instance

uriString

public UriBuilder uriString(java.lang.String uriTemplate)

Description copied from interface: UriBuilderFactory

Initialize a builder with the given URI template.

Specified by:

uriString in interface UriBuilderFactory

Parameters:

uriTemplate - the URI template to use

Returns:

the URI builder instance

builder

public UriBuilder builder()

Description copied from interface: UriBuilderFactory

Create a URI builder with default settings.

Specified by:

builder in interface UriBuilderFactory

Returns:

the builder instance