net.sf.ehcache.util
Class ClassLoaderUtil

java.lang.Object
  net.sf.ehcache.util.ClassLoaderUtil

public final class ClassLoaderUtil
extends java.lang.Object

Keeps all classloading in ehcache consistent.

Version:

$Id: ClassLoaderUtil.java 1214 2009-09-25 00:14:13Z gbevin $

Author:

Greg Luck

Method Summary

static java.lang.Object	createNewInstance(java.lang.String className) Creates a new class instance.
static java.lang.Object	createNewInstance(java.lang.String className, java.lang.Class[] argTypes, java.lang.Object[] args) Creates a new class instance and passes args to the constructor call.
static java.lang.ClassLoader	getFallbackClassLoader() Gets a fallback ClassLoader that all classes in ehcache, and extensions, should use for classloading.
static java.lang.ClassLoader	getStandardClassLoader() Gets the ClassLoader that all classes in ehcache, and extensions, should use for classloading.
static java.lang.Class	loadClass(java.lang.String className) Load the given class by name

Methods inherited from class java.lang.Object

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

Method Detail

getStandardClassLoader

public static java.lang.ClassLoader getStandardClassLoader()

Gets the ClassLoader that all classes in ehcache, and extensions, should use for classloading. All ClassLoading in ehcache should use this one. This is the only thing that seems to work for all of the class loading situations found in the wild.

Returns:

the thread context class loader.

getFallbackClassLoader

public static java.lang.ClassLoader getFallbackClassLoader()

Gets a fallback ClassLoader that all classes in ehcache, and extensions, should use for classloading. This is used if the context class loader does not work.

Returns:

the ClassLoaderUtil.class.getClassLoader();

createNewInstance

public static java.lang.Object createNewInstance(java.lang.String className)
                                          throws CacheException

Creates a new class instance. Logs errors along the way. Classes are loaded using the ehcache standard classloader.

Parameters:

className - a fully qualified class name

Returns:

the newly created instance

Throws:

CacheException - if instance cannot be created due to a missing class or exception

createNewInstance

public static java.lang.Object createNewInstance(java.lang.String className,
                                                 java.lang.Class[] argTypes,
                                                 java.lang.Object[] args)
                                          throws CacheException

Creates a new class instance and passes args to the constructor call. Logs errors along the way. Classes are loaded using the ehcache standard classloader.

Parameters:

className - a fully qualified class name

argTypes - Types for constructor argument parameters

args - Values for constructor argument parameters

Returns:

the newly created instance

Throws:

CacheException - if instance cannot be created due to a missing class or exception

loadClass

public static java.lang.Class loadClass(java.lang.String className)
                                 throws java.lang.ClassNotFoundException

Load the given class by name

Parameters:

className - a fully qualified class name

Returns:

Class the loaded class

Throws:

java.lang.ClassNotFoundException - if the class cannot be loaded

Since:

1.7