Package org.drasyl.util

Class UriUtil

java.lang.Object

org.drasyl.util.UriUtil

public class UriUtil
extends Object

Utility class for operations on URIs.

Method Summary

Modifier and Type	Method	Description
static URI	createUri(String scheme, String host, int port)	Creates a URI by parsing the given components.
static URI	createUri(String scheme, String userInfo, String host, int port, String path, String query)	Creates a URI by parsing the given components.
static Map<String,String>	getQueryMap(URI uri)	Returns the query parameters of the given uri or an empty map if the query is null.
static URI	overrideFragment(URI uri, String fragment)	This method sets the fragment in uri to fragment and returns the resulting URI.
static URI	overridePort(URI uri, int port)	This method sets the port in uri to port and returns the resulting URI.
static URI	removeFragment(URI uri)	This method removes the fragment in uri and returns the resulting URI.

Methods inherited from class java.lang.Object

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

Method Details

createUri

public static URI createUri(String scheme,
 String host,
 int port)

Creates a URI by parsing the given components.

This convenience factory method works as if by invoking the URI(String, String, String, int, String, String, String) constructor; any URISyntaxException thrown by the constructor is caught and wrapped in a new IllegalArgumentException object, which is then thrown.

This method is provided for use in situations where it is known that the given components results in a legal URI, for example for URI constants declared within a program, and so it would be considered a programming error for the given components not to parse as such. The constructors, which throw URISyntaxException directly, should be used in situations where a URI is being constructed from user input or from some other source that may be prone to errors.

Parameters:

scheme - Scheme name The scheme to be parsed into a URL

host - Host name The host to be parsed into a URL

port - Port number The port to be parsed into a URL

Returns:

The new URI

Throws:

IllegalArgumentException - If the URI constructed from the given components violates RFC 2396

createUri

public static URI createUri(String scheme,
 String userInfo,
 String host,
 int port,
 String path,
 String query)

Creates a URI by parsing the given components.

This convenience factory method works as if by invoking the URI(String, String, String, int, String, String, String) constructor; any URISyntaxException thrown by the constructor is caught and wrapped in a new IllegalArgumentException object, which is then thrown.

This method is provided for use in situations where it is known that the given components results in a legal URI, for example for URI constants declared within a program, and so it would be considered a programming error for the given components not to parse as such. The constructors, which throw URISyntaxException directly, should be used in situations where a URI is being constructed from user input or from some other source that may be prone to errors.

Parameters:

scheme - Scheme name The scheme to be parsed into a URL

userInfo - User name and authorization information

host - Host name The host to be parsed into a URL

port - Port number The port to be parsed into a URL

path - Path

query - Query

Returns:

The new URI

Throws:

IllegalArgumentException - If the URI constructed from the given components violates RFC 2396

overridePort

public static URI overridePort(URI uri,
 int port)

This method sets the port in uri to port and returns the resulting URI.

Parameters:

uri - the base URI

port - the port

Returns:

a combined URI and port URI

Throws:

IllegalArgumentException - if resulting URI violates RFC 2396

overrideFragment

public static URI overrideFragment(URI uri,
 String fragment)

This method sets the fragment in uri to fragment and returns the resulting URI.

Parameters:

uri - the base URI

fragment - the fragment

Returns:

a combined URI and fragment URI

Throws:

IllegalArgumentException - if resulting URI violates RFC 2396

removeFragment

public static URI removeFragment(URI uri)

This method removes the fragment in uri and returns the resulting URI.

Parameters:

uri - the base URI

Returns:

URI without fragment

Throws:

IllegalArgumentException - if resulting URI violates RFC 2396

getQueryMap

public static Map<String,String> getQueryMap(URI uri)

Returns the query parameters of the given uri or an empty map if the query is null.

Parameters:

uri - the URI

Returns:

query parameters as map

See Also:

• https://stackoverflow.com/a/11733697