Class QClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

org.jpos.q2.QClassLoader

All Implemented Interfaces:

Closeable, FileFilter, AutoCloseable, QClassLoaderMBean

public class QClassLoader
extends URLClassLoader
implements QClassLoaderMBean, FileFilter

Q2 Class Loader (scans deploy/lib directory for new jars)

Constructor Summary

Constructors

Constructor	Description
QClassLoader(MBeanServer server, File libDir, ObjectName loaderName, ClassLoader mainClassLoader)	Constructs a Q2 classloader and registers it with the given MBean server.

Method Summary

Modifier and Type	Method	Description
boolean	accept(File f)
void	addURL(String url)	Adds a URL to the class loader's search path.
void	forceNewClassLoaderOnNextScan()	Forces scan(boolean) to instantiate a fresh classloader on its next call.
boolean	isModified()	Indicates whether the watched lib directory has changed since the last scan.
QClassLoader	scan(boolean forceNewClassLoader)	Re-scans the lib directory, replacing the live class loader if needed, and returns the up-to-date loader.

Methods inherited from class URLClassLoader

addURL, close, definePackage, findClass, findResource, findResources, getPermissions, getResourceAsStream, getURLs, newInstance, newInstance

Methods inherited from class SecureClassLoader

defineClass, defineClass

Methods inherited from class ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findLibrary, findLoadedClass, findResource, findSystemClass, getClassLoadingLock, getDefinedPackage, getDefinedPackages, getName, getPackage, getPackages, getParent, getPlatformClassLoader, getResource, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, getUnnamedModule, isRegisteredAsParallelCapable, loadClass, loadClass, registerAsParallelCapable, resolveClass, resources, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class Object

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

Constructor Details

QClassLoader

public QClassLoader(MBeanServer server,
 File libDir,
 ObjectName loaderName,
 ClassLoader mainClassLoader)

Constructs a Q2 classloader and registers it with the given MBean server.

Parameters:

server - MBean server hosting this classloader

libDir - directory scanned for .jar files

loaderName - JMX name under which this loader is registered

mainClassLoader - parent class loader

Method Details

addURL

public void addURL(String url)
            throws MalformedURLException

Description copied from interface: QClassLoaderMBean

Adds a URL to the class loader's search path.

Specified by:

addURL in interface QClassLoaderMBean

Parameters:

url - URL string (any form parsable by URL)

Throws:

MalformedURLException - if url is not a valid URL

accept

public boolean accept(File f)

Specified by:

accept in interface FileFilter

isModified

public boolean isModified()

Indicates whether the watched lib directory has changed since the last scan.

Returns:

true if libDir is readable and its mtime has advanced

scan

public QClassLoader scan(boolean forceNewClassLoader)
                  throws InstanceAlreadyExistsException,
InstanceNotFoundException,
NotCompliantMBeanException,
MBeanRegistrationException

Re-scans the lib directory, replacing the live class loader if needed, and returns the up-to-date loader.

Parameters:

forceNewClassLoader - force a fresh loader even when the directory is unchanged

Returns:

the (possibly new) classloader

Throws:

InstanceAlreadyExistsException - if the loader can't be re-registered

InstanceNotFoundException - if the previous loader can't be unregistered

NotCompliantMBeanException - if the loader fails MBean compliance checks

MBeanRegistrationException - if MBean (un)registration fails

forceNewClassLoaderOnNextScan

public void forceNewClassLoaderOnNextScan()

Forces scan(boolean) to instantiate a fresh classloader on its next call.