info.aduna.net
Class UrlUtil

java.lang.Object
  info.aduna.net.UrlUtil

public class UrlUtil
extends Object

Utility methods related to URLs, network connections, etc.

Constructor Summary

UrlUtil()

Method Summary

static String	buildQueryString(Map<String,String> keyValuePairs) Builds a query string from the provided key-value-pairs.
static URL	normalizeURL(URL url) Normalizes a URL.
static URL	trimToDirectory(URL url) Trims a URL to the directory it refers.
static boolean	urlsEqual(URL url1, URL url2) Checks whether two URLs are equal.

Methods inherited from class java.lang.Object

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

Constructor Detail

UrlUtil

public UrlUtil()

Method Detail

normalizeURL

public static URL normalizeURL(URL url)

Normalizes a URL. The following steps are taken to normalize a URL:

• The protocol is made lower-case.
• The host is made lower-case.
• A specified port is removed if it matches the default port.
• Any query parameters are sorted alphabetically.
• Any anchor information is removed.

urlsEqual

public static boolean urlsEqual(URL url1,
                                URL url2)

Checks whether two URLs are equal. This is an alternative implementation for URL.equals(Object) which compares hosts by resolving their IP-addresses, which doesn't work when virtual hosts are involved. Also, this method does not take into account that the order of query parameters is irrelevant. This method fixes these issues by checking that:

• The protocols, if any, are equal (case-insensitive).
• The hosts, if any, are equal (case-insensitive).
• The port numbers are equal, using the default port number for comparison when not specified.
• The paths are equal (case-sensitive).
• The URLs have identical query parameters, ignoring their order, e.g. ?arg1=abc&arg2=def is equal to ?arg2=def&arg1=abc.
• The URLs references, if any, are equal.

buildQueryString

public static String buildQueryString(Map<String,String> keyValuePairs)

Builds a query string from the provided key-value-pairs. All spaces are substituted by '+' characters, and all non US-ASCII characters are escaped to hexadecimal notation (%xx).

trimToDirectory

public static URL trimToDirectory(URL url)

Trims a URL to the directory it refers. This means that everything after the refered directory is removed from the URL. For example, the URL http://foo.com/a/b/c/index.jsp?a=b#c will be trimmed to http://foo.com/a/b/c/, and the URL http://foo.com/a/b will be trimmed to http://foo.com/a/.

Throws:

MalformedURLException - If trimming the URL resulted in a malformed URL.