Class UrlUtils

java.lang.Object

org.codehaus.mojo.javacc.UrlUtils

class UrlUtils
extends Object

Assists in handling of URLs.

Version:

$Id$

Field Summary

Fields

Modifier and Type	Field	Description
private static final String	FILE	The protocol prefix for "file:" URLs.
private static final String	JAR	The protocol prefix for "jar:" URLs.
private static final String	JAR_FILE	The protocol prefix for "jar:file:" URLs.

Constructor Summary

Constructors

Constructor	Description
UrlUtils()

Method Summary

Modifier and Type	Method	Description
static String	decodeUrl(String url)	Decodes the specified URL as per RFC 3986, i.e.
static File	getResourceRoot(URL url, String resource)	Gets the absolute filesystem path to the class path root for the specified resource.

Methods inherited from class Object

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

Field Details

JAR

private static final String JAR

The protocol prefix for "jar:" URLs.

See Also:

• Constant Field Values

FILE

private static final String FILE

The protocol prefix for "file:" URLs.

See Also:

• Constant Field Values

JAR_FILE

private static final String JAR_FILE

The protocol prefix for "jar:file:" URLs.

See Also:

• Constant Field Values

Constructor Details

UrlUtils

UrlUtils()

Method Details

getResourceRoot

public static File getResourceRoot(URL url,
 String resource)

Gets the absolute filesystem path to the class path root for the specified resource. The root is either a JAR file or a directory with loose class files. If the URL does not use a supported protocol, an exception will be thrown.

Parameters:

url - The URL to the resource, may be null.

resource - The name of the resource, must not be null.

Returns:

The absolute filesystem path to the class path root of the resource or null if the input URL was null.

decodeUrl

public static String decodeUrl(String url)

Decodes the specified URL as per RFC 3986, i.e. transforms percent-encoded octets to characters by decoding with the UTF-8 character set. This function is primarily intended for usage with URL which unfortunately does not enforce proper URLs. As such, this method will leniently accept invalid characters or malformed percent-encoded octets and simply pass them literally through to the result string. Except for rare edge cases, this will make unencoded URLs pass through unaltered.

Parameters:

url - The URL to decode, may be null.

Returns:

The decoded URL or null if the input was null.