com.helger.quartz.simpl

Class CascadingClassLoadHelper

java.lang.Object

com.helger.quartz.simpl.CascadingClassLoadHelper

All Implemented Interfaces:

IClassLoadHelper

public class CascadingClassLoadHelper
extends Object
implements IClassLoadHelper

A ClassLoadHelper uses all of the ClassLoadHelper types that are found in this package in its attempts to load a class, when one scheme is found to work, it is promoted to the scheme that will be used first the next time a class is loaded (in order to improve performance).

This approach is used because of the wide variance in class loader behavior between the various environments in which Quartz runs (e.g. disparate application servers, stand-alone, mobile devices, etc.). Because of this disparity, Quartz ran into difficulty with a one class-load style fits-all design. Thus, this class loader finds the approach that works, then 'remembers' it.

Author:

jhouse, pl47ypus

See Also:

IClassLoadHelper, LoadingLoaderClassLoadHelper, SimpleClassLoadHelper, ThreadContextClassLoadHelper, InitThreadContextClassLoadHelper

Constructor Summary

Constructors

Constructor and Description
CascadingClassLoadHelper()

Method Summary

Modifier and Type	Method and Description
ClassLoader	getClassLoader() Enable sharing of the "best" class-loader with 3rd party.
URL	getResource(String name) Finds a resource with a given name.
InputStream	getResourceAsStream(String name) Finds a resource with a given name.
void	initialize() Called to give the ClassLoadHelper a chance to initialize itself, including the opportunity to "steal" the class loader off of the calling thread, which is the thread that is initializing Quartz.
Class<?>	loadClass(String sClassName) Return the class with the given name.
<T> Class<? extends T>	loadClass(String sClassName, Class<T> dummy) Return the class of the given type with the given name.

Methods inherited from class java.lang.Object

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

Constructor Detail

CascadingClassLoadHelper

public CascadingClassLoadHelper()

Method Detail

initialize

public void initialize()

Called to give the ClassLoadHelper a chance to initialize itself, including the opportunity to "steal" the class loader off of the calling thread, which is the thread that is initializing Quartz.

Specified by:

initialize in interface IClassLoadHelper

loadClass

@Nonnull
public Class<?> loadClass(String sClassName)
                             throws ClassNotFoundException

Return the class with the given name.

Specified by:

loadClass in interface IClassLoadHelper

Parameters:

sClassName - the fqcn of the class to load.

Returns:

the requested class.

Throws:

ClassNotFoundException - if the class can be found in the classpath.

loadClass

@Nonnull
public <T> Class<? extends T> loadClass(String sClassName,
                                                  Class<T> dummy)
                                           throws ClassNotFoundException

Description copied from interface: IClassLoadHelper

Return the class of the given type with the given name.

Specified by:

loadClass in interface IClassLoadHelper

Parameters:

sClassName - the fqcn of the class to load.

dummy - For casting.

Returns:

the requested class.

Throws:

ClassNotFoundException - if the class can be found in the classpath.

getResource

@Nullable
public URL getResource(String name)

Finds a resource with a given name. This method returns null if no resource with this name is found.

Specified by:

getResource in interface IClassLoadHelper

Parameters:

name - name of the desired resource

Returns:

a java.net.URL object

getResourceAsStream

@Nullable
public InputStream getResourceAsStream(String name)

Finds a resource with a given name. This method returns null if no resource with this name is found.

Specified by:

getResourceAsStream in interface IClassLoadHelper

Parameters:

name - name of the desired resource

Returns:

a java.io.InputStream object

getClassLoader

@Nonnull
public ClassLoader getClassLoader()

Enable sharing of the "best" class-loader with 3rd party.

Specified by:

getClassLoader in interface IClassLoadHelper

Returns:

the class-loader user be the helper.