org.opengis.cite.kml2.util

Class URIUtils

java.lang.Object

org.opengis.cite.kml2.util.URIUtils

public class URIUtils
extends Object

Provides a collection of utility methods for manipulating or resolving URI references.

Constructor Summary

Constructors

Constructor and Description
URIUtils()

Method Summary

Modifier and Type	Method and Description
static File	dereferenceURI(URI uriRef) Dereferences the given URI and stores the resulting resource representation in a local file.
static Node	parseURI(URI uriRef) Parses the content of the given URI as an XML document and returns a new DOM Node object representing the referent.
static URI	resolveRelativeURI(String baseURI, String uriRef) Constructs an absolute URI from the given URI reference and a base URI.

Methods inherited from class java.lang.Object

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

Constructor Detail

URIUtils

public URIUtils()

Method Detail

parseURI

public static Node parseURI(URI uriRef)
                     throws SAXException,
                            IOException

Parses the content of the given URI as an XML document and returns a new DOM Node object representing the referent. Entity reference nodes will not be expanded. XML inclusions (xi:include elements) will be processed if present.

If the URI reference contains a fragment identifier, the subresource will be returned if the fragment is a valid XPointer; otherwise the primary resource is returned (as a Document node). Only the shorthand pointer syntax--commonly used to identify an element by identifier--is supported.

Parameters:

uriRef - An absolute URI specifying the location of an XML (sub)resource; it may contain a fragment identifier (XPointer).

Returns:

A DOM node representing an XML (sub)resource.

Throws:

SAXException - If the resource cannot be parsed.

IOException - If the resource is not accessible.

See Also:

Uniform Resource Identifier (URI): Generic Syntax, XPointer Framework

dereferenceURI

public static File dereferenceURI(URI uriRef)
                           throws IOException

Dereferences the given URI and stores the resulting resource representation in a local file. The file will be located in the default temporary file directory.

Parameters:

uriRef - An absolute URI specifying the location of some resource.

Returns:

A File containing the content of the resource; it may be empty if resolution failed for any reason.

Throws:

IOException - If an IO error occurred.

resolveRelativeURI

public static URI resolveRelativeURI(String baseURI,
                                     String uriRef)

Constructs an absolute URI from the given URI reference and a base URI.

Parameters:

baseURI - The base URI; if present, it must be an absolute URI.

uriRef - A URI reference that may be relative to the given base URI.

Returns:

The resulting URI.

See Also:

RFC 3986, 5.2