org.exolab.castor.net.util
Class URIUtils

java.lang.Object
  org.exolab.castor.net.util.URIUtils

public class URIUtils

extends java.lang.Object

A utility class for URI handling

Author:

Keith Visco

Constructor Summary

URIUtils()

Method Summary

static java.lang.String	getDocumentBase(java.lang.String href) Returns the document base of the href argument
static java.io.InputStream	getInputStream(java.lang.String href, java.lang.String documentBase) Returns an InputStream for the file represented by the href argument
static java.io.Reader	getReader(java.lang.String href, java.lang.String documentBase) Returns a Reader for the file represented by the href argument
static java.lang.String	getRelativeURI(java.lang.String href) Returns the relative URI of the href argument
static java.lang.String	normalize(java.lang.String absoluteURL) This method removes "." or ".." from absolute URL.
static java.lang.String	resolveAsString(java.lang.String href, java.lang.String documentBase)

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

getInputStream

public static java.io.InputStream getInputStream(java.lang.String href,
                                                 java.lang.String documentBase)
                                          throws java.io.FileNotFoundException,
                                                 java.io.IOException

Returns an InputStream for the file represented by the href argument

Parameters:

href - the href of the file to get the input stream for.

documentBase - the document base of the href argument, if it is a relative href set documentBase to null if there is none.

Returns:

an InputStream to the desired resource

Throws:

java.io.FileNotFoundException - when the file could not be found

java.io.IOException

getReader

public static java.io.Reader getReader(java.lang.String href,
                                       java.lang.String documentBase)
                                throws java.io.FileNotFoundException,
                                       java.io.IOException

Returns a Reader for the file represented by the href argument

Parameters:

href - the href of the file to get the input stream for.

documentBase - the document base of the href argument, if it is a relative href set documentBase to null if there is none.

Returns:

an InputStream to the desired resource

Throws:

java.io.FileNotFoundException - when the file could not be found

java.io.IOException

getDocumentBase

public static java.lang.String getDocumentBase(java.lang.String href)

Returns the document base of the href argument

Returns:

the document base of the given href

getRelativeURI

public static java.lang.String getRelativeURI(java.lang.String href)

Returns the relative URI of the href argument

Returns:

the relative URI the given href

normalize

public static java.lang.String normalize(java.lang.String absoluteURL)
                                  throws java.net.MalformedURLException

This method removes "." or ".." from absolute URL. I needed this method because the JDK doesn't do this automatically when creating URLs.

Parameters:

absoluteURL - the absolute URI to normalize

Throws:

java.net.MalformedURLException

resolveAsString

public static java.lang.String resolveAsString(java.lang.String href,
                                               java.lang.String documentBase)