org.tiogasolutions.notify.server.grizzly

Class JarClassLoader

java.lang.Object

java.lang.ClassLoader

org.tiogasolutions.notify.server.grizzly.JarClassLoader

public class JarClassLoader
extends java.lang.ClassLoader

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JarClassLoader.LogArea
static class	JarClassLoader.LogLevel

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	KEY_LOGGER VM parameter key to turn on logging to file or console.
static java.lang.String	KEY_LOGGER_AREA VM parameter key to define log area.
static java.lang.String	KEY_LOGGER_LEVEL
static java.lang.String	TMP_SUB_DIRECTORY Sub directory name for temporary files.

Constructor Summary

Constructors

Constructor and Description
JarClassLoader() Default constructor.
JarClassLoader(java.lang.ClassLoader parent) Constructor.

Method Summary

Modifier and Type	Method and Description
void	destroyApplet() Call this method to destroy the applet from your launcher class MyAppletLauncher.destroy() method.
protected java.lang.String	findLibrary(java.lang.String sLib)
protected java.net.URL	findResource(java.lang.String sName)
java.util.Enumeration<java.net.URL>	findResources(java.lang.String sName)
java.lang.String	getManifestMainClass() Returns the name of the jar file main class, or null if no "Main-Class" manifest attributes was defined.
void	initApplet(java.lang.String sClass, javax.swing.JApplet appletParent) Call this method to initialize an applet from your launcher class MyAppletLauncher.init() method.
void	invokeStart(java.lang.String sClass, java.lang.String[] args)
boolean	isLaunchedFromJar() Checks how the application was loaded: from JAR or file system.
protected java.lang.Class<?>	loadClass(java.lang.String sClassName, boolean bResolve) Class loader JavaDoc encourages overriding findClass(String) in derived class rather than overriding this method.
void	startApplet() Call this method to start the applet from your launcher class MyAppletLauncher.start() method.
void	stopApplet() Call this method to stop the applet from your launcher class MyAppletLauncher.stop() method.

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findLoadedClass, findSystemClass, getClassLoadingLock, getPackage, getPackages, getParent, getResource, getResourceAsStream, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, registerAsParallelCapable, resolveClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

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

Field Detail

KEY_LOGGER

public static final java.lang.String KEY_LOGGER

VM parameter key to turn on logging to file or console.

See Also:

Constant Field Values

KEY_LOGGER_LEVEL

public static final java.lang.String KEY_LOGGER_LEVEL

See Also:

Constant Field Values

KEY_LOGGER_AREA

public static final java.lang.String KEY_LOGGER_AREA

VM parameter key to define log area. Valid areas are defined in JarClassLoader.LogArea. Default value is JarClassLoader.LogArea.ALL. Multiple areas could be specified with ',' delimiter (no spaces!).

See Also:

Constant Field Values

TMP_SUB_DIRECTORY

public static final java.lang.String TMP_SUB_DIRECTORY

Sub directory name for temporary files.

JarClassLoader extracts all JARs and native libraries into temporary files and makes the best attempt to clean these files on exit.

The sub directory is created in the directory defined in a system property "java.io.tmpdir". Verify the content of this directory periodically and empty it if required. Temporary files could accumulate there if application was killed.

See Also:

Constant Field Values

Constructor Detail

JarClassLoader

public JarClassLoader()

Default constructor. Defines system class loader as a parent class loader.

JarClassLoader

public JarClassLoader(java.lang.ClassLoader parent)

Constructor.

Parameters:

parent - class loader parent.

Method Detail

isLaunchedFromJar

public boolean isLaunchedFromJar()

Checks how the application was loaded: from JAR or file system.

Returns:

true if application was started from JAR.

getManifestMainClass

public java.lang.String getManifestMainClass()

Returns the name of the jar file main class, or null if no "Main-Class" manifest attributes was defined.

Returns:

Main class declared in JAR's manifest.

invokeStart

public void invokeStart(java.lang.String sClass,
                        java.lang.String[] args)
                 throws java.lang.Throwable

Throws:

java.lang.Throwable

initApplet

public void initApplet(java.lang.String sClass,
                       javax.swing.JApplet appletParent)
                throws java.lang.Throwable

Call this method to initialize an applet from your launcher class MyAppletLauncher.init() method.

Parameters:

sClass - class name in form "MyClass" for default package or "com.abc.MyClass" for class in some package

appletParent - parent applet from a launcher.

Throws:

java.lang.Throwable - wrapper for many exceptions thrown while applet instantiation and calling init() method.

startApplet

public void startApplet()

Call this method to start the applet from your launcher class MyAppletLauncher.start() method.

stopApplet

public void stopApplet()

Call this method to stop the applet from your launcher class MyAppletLauncher.stop() method.

destroyApplet

public void destroyApplet()

Call this method to destroy the applet from your launcher class MyAppletLauncher.destroy() method.

loadClass

protected java.lang.Class<?> loadClass(java.lang.String sClassName,
                                       boolean bResolve)
                                throws java.lang.ClassNotFoundException

Class loader JavaDoc encourages overriding findClass(String) in derived class rather than overriding this method. This does not work for loading classes from a JAR. Default implementation of loadClass() is able to load a class from a JAR without calling findClass().

Overrides:

loadClass in class java.lang.ClassLoader

Throws:

java.lang.ClassNotFoundException

findResource

protected java.net.URL findResource(java.lang.String sName)

Overrides:

findResource in class java.lang.ClassLoader

Returns:

A URL object for reading the resource, or null if the resource could not be found. Example URL: jar:file:C:\...\some.jar!/resources/InnerText.txt

See Also:

ClassLoader.findResource(String)

findResources

public java.util.Enumeration<java.net.URL> findResources(java.lang.String sName)
                                                  throws java.io.IOException

Overrides:

findResources in class java.lang.ClassLoader

Returns:

An enumeration of URL objects for the resources

Throws:

java.io.IOException

See Also:

ClassLoader.findResources(String)

findLibrary

protected java.lang.String findLibrary(java.lang.String sLib)

Overrides:

findLibrary in class java.lang.ClassLoader

Returns:

The absolute path of the native library.

See Also:

ClassLoader.findLibrary(String)