Package org.exolab.castor.net.util

Class URIUtils

  • public class URIUtils
extends java.lang.Object
    A utility class for URI handling
    Author:
    Keith Visco

    • Constructor Summary

      Constructors 
      Constructor Description
      URIUtils()  

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      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)