org.jupnp.util

Class URIUtil

java.lang.Object

org.jupnp.util.URIUtil

public class URIUtil
extends Object

Author:

Christian Bauer

Field Summary

Fields

Modifier and Type	Field and Description
static BitSet	ALLOWED Implementation of path/query/fragment encoding as explained here: http://www.lunatech-research.com/archives/2009/02/03/what-every-web-developer-must-know-about-url-encoding
static BitSet	FRAGMENT
static BitSet	PATH_PARAM_NAME
static BitSet	PATH_PARAM_VALUE
static BitSet	PATH_SEGMENT
static BitSet	QUERY

Constructor Summary

Constructors

Constructor and Description
URIUtil()

Method Summary

Modifier and Type	Method and Description
static void	assertRelativeURI(String what, URI uri)
static URI	createAbsoluteURI(URI base, String uri) Guarantees that the returned URI is absolute, no matter what the argument is.
static URI	createAbsoluteURI(URI base, URI relativeOrNot)
static URL	createAbsoluteURL(InetAddress address, int localStreamPort, URI relativeOrNot)
static URL	createAbsoluteURL(URI base, URI relativeOrNot)
static URL	createAbsoluteURL(URL base, String uri)
static URL	createAbsoluteURL(URL base, URI relativeOrNot)
static URI	createRelativePathURI(URI uri)
static URI	createRelativeURI(URI base, URI full)
static URI	createRelativeURI(URI base, URL full)
static URI	createRelativeURI(URL base, URI full)
static URI	createRelativeURI(URL base, URL full)
static String	encode(BitSet allowedCharacters, String s, String charset)
static String	encodeFragment(String fragment)
static String	encodePathParamName(String pathParamName)
static String	encodePathParamValue(String pathParamValue)
static String	encodePathSegment(String pathSegment)
static String	encodeQueryNameOrValue(String queryNameOrValue)
static boolean	isAbsoluteURI(String s)
static String	percentDecode(String s)
static String	percentEncode(String s)
static URI	toURI(URL url)
static URL	toURL(URI uri)

Methods inherited from class java.lang.Object

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

Field Detail

ALLOWED

public static final BitSet ALLOWED

Implementation of path/query/fragment encoding as explained here: http://www.lunatech-research.com/archives/2009/02/03/what-every-web-developer-must-know-about-url-encoding

PATH_SEGMENT

public static final BitSet PATH_SEGMENT

PATH_PARAM_NAME

public static final BitSet PATH_PARAM_NAME

PATH_PARAM_VALUE

public static final BitSet PATH_PARAM_VALUE

QUERY

public static final BitSet QUERY

FRAGMENT

public static final BitSet FRAGMENT

Constructor Detail

URIUtil

public URIUtil()

Method Detail

createAbsoluteURI

public static URI createAbsoluteURI(URI base,
                                    String uri)
                             throws IllegalArgumentException

Guarantees that the returned URI is absolute, no matter what the argument is.

Parameters:

base - An absolute base URI, can be null!

uri - A string that either represents a relative or an already absolute URI

Returns:

An absolute URI

Throws:

IllegalArgumentException - If the base URI is null and the given URI string is not absolute

createAbsoluteURI

public static URI createAbsoluteURI(URI base,
                                    URI relativeOrNot)
                             throws IllegalArgumentException

Throws:

IllegalArgumentException

createAbsoluteURL

public static URL createAbsoluteURL(URL base,
                                    String uri)
                             throws IllegalArgumentException

Throws:

IllegalArgumentException

createAbsoluteURL

public static URL createAbsoluteURL(URL base,
                                    URI relativeOrNot)
                             throws IllegalArgumentException

Throws:

IllegalArgumentException

createAbsoluteURL

public static URL createAbsoluteURL(URI base,
                                    URI relativeOrNot)
                             throws IllegalArgumentException

Throws:

IllegalArgumentException

createAbsoluteURL

public static URL createAbsoluteURL(InetAddress address,
                                    int localStreamPort,
                                    URI relativeOrNot)
                             throws IllegalArgumentException

Throws:

IllegalArgumentException

createRelativePathURI

public static URI createRelativePathURI(URI uri)

createRelativeURI

public static URI createRelativeURI(URI base,
                                    URI full)

createRelativeURI

public static URI createRelativeURI(URL base,
                                    URL full)
                             throws IllegalArgumentException

Throws:

IllegalArgumentException

createRelativeURI

public static URI createRelativeURI(URI base,
                                    URL full)
                             throws IllegalArgumentException

Throws:

IllegalArgumentException

createRelativeURI

public static URI createRelativeURI(URL base,
                                    URI full)
                             throws IllegalArgumentException

Throws:

IllegalArgumentException

isAbsoluteURI

public static boolean isAbsoluteURI(String s)

assertRelativeURI

public static void assertRelativeURI(String what,
                                     URI uri)

toURL

public static URL toURL(URI uri)

toURI

public static URI toURI(URL url)

percentEncode

public static String percentEncode(String s)

percentDecode

public static String percentDecode(String s)

encodePathSegment

public static String encodePathSegment(String pathSegment)

encodePathParamName

public static String encodePathParamName(String pathParamName)

encodePathParamValue

public static String encodePathParamValue(String pathParamValue)

encodeQueryNameOrValue

public static String encodeQueryNameOrValue(String queryNameOrValue)

encodeFragment

public static String encodeFragment(String fragment)

encode

public static String encode(BitSet allowedCharacters,
                            String s,
                            String charset)