Class Resources

java.lang.Object
com.ibatis.common.resources.Resources

public class Resources extends Object
A class to simplify access to resources through the classloader.
  • Method Details

    • getDefaultClassLoader

      public static ClassLoader getDefaultClassLoader()
      Returns the default classloader (may be null).
      Returns:
      The default classloader
    • setDefaultClassLoader

      public static void setDefaultClassLoader(ClassLoader defaultClassLoader)
      Sets the default classloader.
      Parameters:
      defaultClassLoader - - the new default ClassLoader
    • getResourceURL

      public static URL getResourceURL(String resource) throws IOException
      Returns the URL of the resource on the classpath.
      Parameters:
      resource - The resource to find
      Returns:
      The resource
      Throws:
      IOException - If the resource cannot be found or read
    • getResourceURL

      public static URL getResourceURL(ClassLoader loader, String resource) throws IOException
      Returns the URL of the resource on the classpath.
      Parameters:
      loader - The classloader used to load the resource
      resource - The resource to find
      Returns:
      The resource
      Throws:
      IOException - If the resource cannot be found or read
    • getResourceAsStream

      public static InputStream getResourceAsStream(String resource) throws IOException
      Returns a resource on the classpath as a Stream object.
      Parameters:
      resource - The resource to find
      Returns:
      The resource
      Throws:
      IOException - If the resource cannot be found or read
    • getResourceAsStream

      public static InputStream getResourceAsStream(ClassLoader loader, String resource) throws IOException
      Returns a resource on the classpath as a Stream object.
      Parameters:
      loader - The classloader used to load the resource
      resource - The resource to find
      Returns:
      The resource
      Throws:
      IOException - If the resource cannot be found or read
    • getResourceAsProperties

      public static Properties getResourceAsProperties(String resource) throws IOException
      Returns a resource on the classpath as a Properties object.
      Parameters:
      resource - The resource to find
      Returns:
      The resource
      Throws:
      IOException - If the resource cannot be found or read
    • getResourceAsProperties

      public static Properties getResourceAsProperties(ClassLoader loader, String resource) throws IOException
      Returns a resource on the classpath as a Properties object.
      Parameters:
      loader - The classloader used to load the resource
      resource - The resource to find
      Returns:
      The resource
      Throws:
      IOException - If the resource cannot be found or read
    • getResourceAsReader

      public static Reader getResourceAsReader(String resource) throws IOException
      Returns a resource on the classpath as a Reader object.
      Parameters:
      resource - The resource to find
      Returns:
      The resource
      Throws:
      IOException - If the resource cannot be found or read
    • getResourceAsReader

      public static Reader getResourceAsReader(ClassLoader loader, String resource) throws IOException
      Returns a resource on the classpath as a Reader object.
      Parameters:
      loader - The classloader used to load the resource
      resource - The resource to find
      Returns:
      The resource
      Throws:
      IOException - If the resource cannot be found or read
    • getResourceAsFile

      public static File getResourceAsFile(String resource) throws IOException
      Returns a resource on the classpath as a File object.
      Parameters:
      resource - The resource to find
      Returns:
      The resource
      Throws:
      IOException - If the resource cannot be found or read
    • getResourceAsFile

      public static File getResourceAsFile(ClassLoader loader, String resource) throws IOException
      Returns a resource on the classpath as a File object.
      Parameters:
      loader - - the classloader used to load the resource
      resource - - the resource to find
      Returns:
      The resource
      Throws:
      IOException - If the resource cannot be found or read
    • getUrlAsStream

      public static InputStream getUrlAsStream(String urlString) throws IOException
      Gets a URL as an input stream.
      Parameters:
      urlString - - the URL to get
      Returns:
      An input stream with the data from the URL
      Throws:
      IOException - If the resource cannot be found or read
    • getUrlAsReader

      public static Reader getUrlAsReader(String urlString) throws IOException
      Gets a URL as a Reader.
      Parameters:
      urlString - - the URL to get
      Returns:
      A Reader with the data from the URL
      Throws:
      IOException - If the resource cannot be found or read
    • getUrlAsProperties

      public static Properties getUrlAsProperties(String urlString) throws IOException
      Gets a URL as a Properties object.
      Parameters:
      urlString - - the URL to get
      Returns:
      A Properties object with the data from the URL
      Throws:
      IOException - If the resource cannot be found or read
    • classForName

      public static Class classForName(String className) throws ClassNotFoundException
      Loads a class.
      Parameters:
      className - - the class to load
      Returns:
      The loaded class
      Throws:
      ClassNotFoundException - If the class cannot be found (duh!)
    • instantiate

      public static Object instantiate(String className) throws ClassNotFoundException, InstantiationException, IllegalAccessException
      Creates an instance of a class.
      Parameters:
      className - - the class to create
      Returns:
      An instance of the class
      Throws:
      ClassNotFoundException - If the class cannot be found (duh!)
      InstantiationException - If the class cannot be instantiaed
      IllegalAccessException - If the class is not public, or other access problems arise
    • instantiate

      public static Object instantiate(Class clazz) throws InstantiationException, IllegalAccessException
      Creates an instance of a class.
      Parameters:
      clazz - - the class to create
      Returns:
      An instance of the class
      Throws:
      InstantiationException - If the class cannot be instantiaed
      IllegalAccessException - If the class is not public, or other access problems arise
    • getCharset

      public static Charset getCharset()
      Gets the charset.
      Returns:
      the charset
    • setCharset

      public static void setCharset(Charset charset)
      Use this method to set the Charset to be used when calling the getResourceAsReader methods. This will allow iBATIS to function properly when the system default encoding doesn't deal well with unicode (IBATIS-340, IBATIS-349)
      Parameters:
      charset - the new charset