Package org.springframework.hateoas

Class UriTemplate

java.lang.Object

org.springframework.hateoas.UriTemplate

All Implemented Interfaces:

Serializable, Iterable<TemplateVariable>

public class UriTemplate
extends Object
implements Iterable<TemplateVariable>, Serializable

Custom URI template to support qualified URI template variables.

Since:

0.9

Author:

Oliver Gierke, JamesE Richardson

See Also:

• Serialized Form

Method Summary

Modifier and Type	Method	Description
URI	expand(Object... parameters)	Expands the UriTemplate using the given parameters.
URI	expand(Map<String,?> parameters)	Expands the UriTemplate using the given parameters.
List<String>	getVariableNames()	Returns the names of the variables discovered.
List<TemplateVariable>	getVariables()	Returns the TemplateVariables discovered.
static boolean	isTemplate(String candidate)	Returns whether the given candidate is a URI template.
Iterator<TemplateVariable>	iterator()
static UriTemplate	of(String template)	Returns a UriTemplate for the given String template.
static UriTemplate	of(String template, TemplateVariables variables)	Returns a UriTemplate for the given String template.
String	toString()
UriTemplate	with(String variableName, TemplateVariable.VariableType type)	Creates a new UriTemplate with a TemplateVariable with the given name and type added.
UriTemplate	with(TemplateVariable variable)	Creates a new UriTemplate with the given TemplateVariable added.
UriTemplate	with(TemplateVariables variables)	Creates a new UriTemplate with the current TemplateVariables augmented with the given ones.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Method Details

of

public static UriTemplate of(String template)

Returns a UriTemplate for the given String template.

Parameters:

template - must not be null or empty.

Returns:

of

public static UriTemplate of(String template,
 TemplateVariables variables)

Returns a UriTemplate for the given String template.

Parameters:

template - must not be null or empty.

Returns:

with

public UriTemplate with(TemplateVariables variables)

Creates a new UriTemplate with the current TemplateVariables augmented with the given ones.

Parameters:

variables - must not be null.

Returns:

will never be null.

with

public UriTemplate with(TemplateVariable variable)

Creates a new UriTemplate with the given TemplateVariable added.

Parameters:

variable - must not be null.

Returns:

will never be null.

with

public UriTemplate with(String variableName,
 TemplateVariable.VariableType type)

Creates a new UriTemplate with a TemplateVariable with the given name and type added.

Parameters:

variableName - must not be null or empty.

type - must not be null.

Returns:

will never be null.

isTemplate

public static boolean isTemplate(String candidate)

Returns whether the given candidate is a URI template.

Parameters:

candidate -

Returns:

getVariables

public List<TemplateVariable> getVariables()

Returns the TemplateVariables discovered.

Returns:

getVariableNames

public List<String> getVariableNames()

Returns the names of the variables discovered.

Returns:

expand

public URI expand(Object... parameters)

Expands the UriTemplate using the given parameters. The values will be applied in the order of the variables discovered.

Parameters:

parameters -

Returns:

See Also:

• expand(Map)

expand

public URI expand(Map<String,?> parameters)

Expands the UriTemplate using the given parameters.

Parameters:

parameters - must not be null.

Returns:

iterator

public Iterator<TemplateVariable> iterator()

Specified by:

iterator in interface Iterable<TemplateVariable>

toString

public String toString()

Overrides:

toString in class Object