org.jclouds.http

Class Uris.UriBuilder

java.lang.Object

org.jclouds.http.Uris.UriBuilder

Enclosing class:

Uris

public static final class Uris.UriBuilder
extends Object

Mutable URI builder that can be in level 1 RFC6570 template form. ex.

  https://api.github.com/repos/{user}
 

Method Summary

Methods

Modifier and Type	Method and Description
Uris.UriBuilder	addQuery(Map<String,?> parameters)
Uris.UriBuilder	addQuery(com.google.common.collect.Multimap<String,?> parameters)
Uris.UriBuilder	addQuery(String name, Iterable<?> values)
Uris.UriBuilder	addQuery(String name, String... values)
Uris.UriBuilder	appendPath(String path)
URI	build()
URI	build(Map<String,?> variables)
Uris.UriBuilder	clearPath()
Uris.UriBuilder	clearQuery()
String	expand(Map<String,?> variables)
Uris.UriBuilder	host(String host)
Uris.UriBuilder	path(String path)
Uris.UriBuilder	query(Map<String,?> parameters)
Uris.UriBuilder	query(com.google.common.collect.Multimap<String,?> parameters)
Uris.UriBuilder	query(String queryLine)
Uris.UriBuilder	replaceQuery(Map<String,?> parameters)
Uris.UriBuilder	replaceQuery(com.google.common.collect.Multimap<String,?> parameters)
Uris.UriBuilder	replaceQuery(String name, Iterable<?> values)
Uris.UriBuilder	replaceQuery(String name, String... values)
Uris.UriBuilder	scheme(String scheme)
Uris.UriBuilder	skipPathEncoding(Iterable<Character> skipPathEncoding) override default of / : ; =
String	toString() returns template expression without url encoding

Methods inherited from class java.lang.Object

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

Method Detail

skipPathEncoding

public Uris.UriBuilder skipPathEncoding(Iterable<Character> skipPathEncoding)

override default of / : ; =

Parameters:

scheme - scheme to set or replace

scheme

public Uris.UriBuilder scheme(String scheme)

Parameters:

scheme - scheme to set or replace

host

public Uris.UriBuilder host(String host)

Parameters:

host - host to set or replace

Returns:

replaced value

clearPath

public Uris.UriBuilder clearPath()

path

public Uris.UriBuilder path(@Nullable
                   String path)

appendPath

public Uris.UriBuilder appendPath(String path)

query

public Uris.UriBuilder query(Map<String,?> parameters)

query

public Uris.UriBuilder query(@Nullable
                    String queryLine)

clearQuery

public Uris.UriBuilder clearQuery()

query

public Uris.UriBuilder query(com.google.common.collect.Multimap<String,?> parameters)

addQuery

public Uris.UriBuilder addQuery(String name,
                       Iterable<?> values)

addQuery

public Uris.UriBuilder addQuery(String name,
                       String... values)

addQuery

public Uris.UriBuilder addQuery(Map<String,?> parameters)

addQuery

public Uris.UriBuilder addQuery(com.google.common.collect.Multimap<String,?> parameters)

replaceQuery

public Uris.UriBuilder replaceQuery(String name,
                           Iterable<?> values)

replaceQuery

public Uris.UriBuilder replaceQuery(String name,
                           String... values)

replaceQuery

public Uris.UriBuilder replaceQuery(Map<String,?> parameters)

replaceQuery

public Uris.UriBuilder replaceQuery(com.google.common.collect.Multimap<String,?> parameters)

build

public URI build()

build

public URI build(Map<String,?> variables)

Throws:

IllegalArgumentException - if there's a problem parsing the URI

expand

public String expand(Map<String,?> variables)

toString

public String toString()

returns template expression without url encoding

Overrides:

toString in class Object