Package de.ufinke.cubaja.cafebabe

Class Loader

java.lang.Object

java.lang.ClassLoader

de.ufinke.cubaja.cafebabe.Loader

public class Loader
extends ClassLoader

ClassLoader which loads generated bytecode. A Generator must be set by setGenerator(de.ufinke.cubaja.cafebabe.Generator) before findClass(java.lang.String) is called indirectly by ClassLoader.loadClass(java.lang.String).

There may be a system property de.ufinke.cubaja.cafebabe.dump with a path name as its value. If the property exists, the 'loaded' bytecode will be dumped into the given directory.

Because of the dependencies between setGenerator and findClass, this class is not threadsafe.

Author:

Uwe Finke

Constructor Summary

Constructors

Constructor	Description
Loader()	Default constructor.
Loader(ClassLoader parentLoader)	Constructor with explicit parent class loader.

Method Summary

Modifier and Type	Method	Description
static Class<?>	createClass(Generator generator, Object... nameSuffix)	Same as createClass(Class, Generator, Object...), with the generators ClassLoader as parent loader.
static Class<?>	createClass(Class<?> contextClass, Generator generator, Object... nameSuffix)	Convenience method to generate and load a class.
protected Class<?>	findClass(String className)	Calls the generator and defines the Class.
void	setGenerator(Generator generator)	Sets the generator.

Methods inherited from class java.lang.ClassLoader

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

Methods inherited from class java.lang.Object

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

Constructor Detail

Loader

public Loader()

Default constructor. Parent class loader is the system class loader.

Loader

public Loader(ClassLoader parentLoader)

Constructor with explicit parent class loader.

Parameters:

parentLoader - parent class loader

Method Detail

createClass

public static Class<?> createClass(Class<?> contextClass,
                                   Generator generator,
                                   Object... nameSuffix)
                            throws ClassNotFoundException

Convenience method to generate and load a class.

Creates a Loader with the ClassLoader of a context class as parent loader and passes the Generator to it. The name of the generated class is 'Generated' plus the given nameSuffixes, each separated by an underline character. If a nameSuffix is of type Class, the class name is used as nameSuffix. Dots in a nameSuffix are replaced by underlines.

Parameters:

contextClass - context class

generator - generator

nameSuffix - optional name suffixes to build the name of the generated class

Returns:

generated class

Throws:

ClassNotFoundException - when the context class could not be found

createClass

public static Class<?> createClass(Generator generator,
                                   Object... nameSuffix)
                            throws ClassNotFoundException

Same as createClass(Class, Generator, Object...), with the generators ClassLoader as parent loader.

Parameters:

generator - generator

nameSuffix - optional name suffixes to build the name of the generated class

Returns:

generated class

Throws:

ClassNotFoundException - when the context class could not be found

setGenerator

public void setGenerator(Generator generator)

Sets the generator.

Parameters:

generator - the generator

findClass

protected Class<?> findClass(String className)
                      throws ClassNotFoundException

Calls the generator and defines the Class.

Overrides:

findClass in class ClassLoader

Parameters:

className - name of class to find

Throws:

ClassNotFoundException