org.tinygroup.commons.tools

Class Resources

java.lang.Object

org.tinygroup.commons.tools.Resources

public final class Resources
extends Object

A class to simplify access to resources through the classloader.

Method Summary

Modifier and Type	Method and Description
static Class<?>	classForName(String className) Loads a class
static Charset	getCharset()
static ClassLoader	getDefaultClassLoader() Returns the default classloader (may be null).
static File	getResourceAsFile(ClassLoader loader, String resource) Returns a resource on the classpath as a File object
static File	getResourceAsFile(String resource) Returns a resource on the classpath as a File object
static Properties	getResourceAsProperties(ClassLoader loader, String resource) Returns a resource on the classpath as a Properties object
static Properties	getResourceAsProperties(String resource) Returns a resource on the classpath as a Properties object
static Reader	getResourceAsReader(ClassLoader loader, String resource) Returns a resource on the classpath as a Reader object
static Reader	getResourceAsReader(String resource) Returns a resource on the classpath as a Reader object
static InputStream	getResourceAsStream(ClassLoader loader, String resource) Returns a resource on the classpath as a Stream object
static InputStream	getResourceAsStream(String resource) Returns a resource on the classpath as a Stream object
static URL	getResourceURL(ClassLoader loader, String resource) Returns the URL of the resource on the classpath
static URL	getResourceURL(String resource) Returns the URL of the resource on the classpath
static Properties	getUrlAsProperties(String urlString) Gets a URL as a Properties object
static Reader	getUrlAsReader(String urlString) Gets a URL as a Reader
static InputStream	getUrlAsStream(String urlString) Gets a URL as an input stream
static Object	instantiate(Class<?> clazz) Creates an instance of a class
static Object	instantiate(String className) Creates an instance of a class
static void	setCharset(Charset charset) Use this method to set the Charset to be used when calling the getResourceAsReader methods.
static void	setDefaultClassLoader(ClassLoader defaultClassLoader) Sets the default classloader

Methods inherited from class java.lang.Object

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

Method Detail

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()

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 -