Class UriTemplate


  • public class UriTemplate
    extends Object
    Expands URI Templates. This Class supports Level 1 templates and all Level 4 composite templates as described in: RFC 6570. Specifically, for the variables: var := "value" list := ["red", "green", "blue"] keys := [("semi", ";"),("dot", "."),("comma", ",")] The following templates results in the following expansions: {var} -> value {list} -> red,green,blue {list*} -> red,green,blue {keys} -> semi,%3B,dot,.,comma,%2C {keys*} -> semi=%3B,dot=.,comma=%2C {+list} -> red,green,blue {+list*} -> red,green,blue {+keys} -> semi,;,dot,.,comma,, {+keys*} -> semi=;,dot=.,comma=, {#list} -> #red,green,blue {#list*} -> #red,green,blue {#keys} -> #semi,;,dot,.,comma,, {#keys*} -> #semi=;,dot=.,comma=, X{.list} -> X.red,green,blue X{.list*} -> X.red.green.blue X{.keys} -> X.semi,%3B,dot,.,comma,%2C X{.keys*} -> X.semi=%3B.dot=..comma=%2C {/list} -> /red,green,blue {/list*} -> /red/green/blue {/keys} -> /semi,%3B,dot,.,comma,%2C {/keys*} -> /semi=%3B/dot=./comma=%2C {;list} -> ;list=red,green,blue {;list*} -> ;list=red;list=green;list=blue {;keys} -> ;keys=semi,%3B,dot,.,comma,%2C {;keys*} -> ;semi=%3B;dot=.;comma=%2C {?list} -> ?list=red,green,blue {?list*} -> ?list=red&list=green&list=blue {?keys} -> ?keys=semi,%3B,dot,.,comma,%2C {?keys*} -> ?semi=%3B&dot=.&comma=%2C {&list} -> &list=red,green,blue {&list*} -> &list=red&list=green&list=blue {&keys} -> &keys=semi,%3B,dot,.,comma,%2C {&keys*} -> &semi=%3B&dot=.&comma=%2C {?var,list} -> ?var=value&list=red,green,blue
    Since:
    1.6
    Author:
    Ravi Mistry
    • Constructor Detail

      • UriTemplate

        public UriTemplate()
    • Method Detail

      • expand

        public static String expand​(String baseUrl,
                                    String uriTemplate,
                                    Object parameters,
                                    boolean addUnusedParamsAsQueryParams)
        Expands templates in a URI template that is relative to a base URL.

        If the URI template starts with a "/" the raw path from the base URL is stripped out. If the URI template is a full URL then it is used instead of the base URL.

        Supports Level 1 templates and all Level 4 composite templates as described in: RFC 6570.

        Parameters:
        baseUrl - The base URL which the URI component is relative to.
        uriTemplate - URI component. It may contain one or more sequences of the form "{name}", where "name" must be a key in variableMap.
        parameters - an object with parameters designated by Key annotations. If the template has no variable references, parameters may be null.
        addUnusedParamsAsQueryParams - If true then parameters that do not match the template are appended to the expanded template as query parameters.
        Returns:
        The expanded template
        Since:
        1.7
      • expand

        public static String expand​(String pathUri,
                                    Object parameters,
                                    boolean addUnusedParamsAsQueryParams)
        Expands templates in a URI.

        Supports Level 1 templates and all Level 4 composite templates as described in: RFC 6570.

        Parameters:
        pathUri - URI component. It may contain one or more sequences of the form "{name}", where "name" must be a key in variableMap
        parameters - an object with parameters designated by Key annotations. If the template has no variable references, parameters may be null.
        addUnusedParamsAsQueryParams - If true then parameters that do not match the template are appended to the expanded template as query parameters.
        Returns:
        The expanded template
        Since:
        1.6