org.kocakosm.pitaya.net

Class URLs

java.lang.Object

org.kocakosm.pitaya.net.URLs

public final class URLs
extends Object

URLs utilities.

Author:

Osman KOCAK

Method Summary

Methods

Modifier and Type	Method and Description
static URL	create(String url) Creates a new URL by parsing the given String.
static String	relativize(URL base, URL full) Relativizes the specified full URL against the given base.
static URL	resolve(URL base, String path) Resolves the specified path against the given base URL.

Methods inherited from class java.lang.Object

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

Method Detail

create

public static URL create(String url)

Creates a new URL by parsing the given String. This function invokes the URL.URL(java.lang.String) constructor; any MalformedURLException thrown by the constructor is caught and wrapped in a new IllegalArgumentException, which is then thrown. This method is provided for use in situations where it is known that the given String is a legal URL.

Parameters:

url - the String to be parsed into a URL.

Returns:

the created URL.

Throws:

NullPointerException - if url is null.

IllegalArgumentException - if url is not a valid URL.

relativize

public static String relativize(URL base,
                URL full)

Relativizes the specified full URL against the given base. Behaves as URI.relativize(java.net.URI).

Parameters:

base - the base URL.

full - the full URL.

Returns:

the relativized path.

Throws:

NullPointerException - if one of the arguments is null.

IllegalArgumentException - if the relativization fails.

resolve

public static URL resolve(URL base,
          String path)

Resolves the specified path against the given base URL. Behaves as URI.resolve(java.lang.String).

Parameters:

base - the base URL.

path - the path to resolve.

Returns:

the resolved URL.

Throws:

NullPointerException - if one of the arguments is null.

IllegalArgumentException - if the path can't be resolved.