co.codewizards.cloudstore.core.util

Class UrlUtil

java.lang.Object

co.codewizards.cloudstore.core.util.UrlUtil

public final class UrlUtil
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static String	PROTOCOL_FILE
static String	PROTOCOL_JAR

Method Summary

Modifier and Type	Method and Description
static URL	appendEncodedPath(URL url, String path) Appends the URL-encoded path to the given base url.
static URL	appendNonEncodedPath(URL url, String path) Appends the plain path to the given base url.
static URL	canonicalizeURL(URL url) Turns the given url into a canonical form.
static File	getFile(URL url)
static File	getFileFromJarUrl(URL url) Gets the File referencing the JAR.
static URL	getFileUrlFromJarUrl(URL url) Removes the 'jar:'-prefix and the '!...'-suffix in order to unwrap the 'file:'-URL pointing to the JAR.
static URI	urlToUri(URL url) Convert an URL to an URI.

Methods inherited from class java.lang.Object

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

Field Detail

PROTOCOL_FILE

public static final String PROTOCOL_FILE

See Also:

Constant Field Values

PROTOCOL_JAR

public static final String PROTOCOL_JAR

See Also:

Constant Field Values

Method Detail

canonicalizeURL

public static URL canonicalizeURL(URL url)

Turns the given url into a canonical form.

Parameters:

url - the URL to be canonicalized. May be null.

Returns:

the canonicalized URL. Never null, unless the given url is null.

getFile

public static File getFile(URL url)

appendEncodedPath

public static URL appendEncodedPath(URL url,
                                    String path)

Appends the URL-encoded path to the given base url.

This method does not use URLEncoder, because of JERSEY-417.

Parameters:

url - the URL to be appended. Must not be null.

path - the path to append. May be null. It is assumed that this path is already encoded. It is therefore not modified at all and appended as-is.

Returns:

the URL composed of the prefix url and the suffix path.

See Also:

appendNonEncodedPath(URL, String)

appendNonEncodedPath

public static URL appendNonEncodedPath(URL url,
                                       String path)

Appends the plain path to the given base url.

Each path segment (the text between '/') is separately URL-encoded. A '/' itself is therefore conserved and not encoded.

Parameters:

url - the URL to be appended. Must not be null.

path - the path to append. May be null.

Returns:

the URL composed of the prefix url and the suffix path.

See Also:

appendEncodedPath(URL, String)

urlToUri

public static final URI urlToUri(URL url)

Convert an URL to an URI.

Parameters:

url - The URL to cenvert

Returns:

The URI

getFileFromJarUrl

public static File getFileFromJarUrl(URL url)

Gets the File referencing the JAR.

Parameters:

url - the url to be unwrapped. Must not be null. Must be a JAR-URL (i.e. protocol must be PROTOCOL_JAR)!

Returns:

the unwrapped URL, i.e. usually the 'file:'-URL pointing to the JAR-URL.

getFileUrlFromJarUrl

public static URL getFileUrlFromJarUrl(URL url)

Removes the 'jar:'-prefix and the '!...'-suffix in order to unwrap the 'file:'-URL pointing to the JAR.

Parameters:

url - the url to be unwrapped. Must not be null. Must be a JAR-URL (i.e. protocol must be PROTOCOL_JAR)!

Returns:

the unwrapped URL, i.e. usually the 'file:'-URL pointing to the JAR-URL.