org.codehaus.janino
Class IClassLoader

java.lang.Object
  org.codehaus.janino.IClassLoader

Direct Known Subclasses:

ClassLoaderIClassLoader, ResourceFinderIClassLoader

public abstract class IClassLoader

extends Object

Loads an IClass by type name.

Field Summary

IClass	CLASS
IClass	CLONEABLE
IClass	ERROR
IClass	OBJECT
IClass	RUNTIME_EXCEPTION
IClass	SERIALIZABLE
IClass	STRING
IClass	THROWABLE

Constructor Summary

IClassLoader(IClassLoader optionalParentIClassLoader)

Method Summary

protected void	defineIClass(IClass iClass) Define an IClass in the context of this IClassLoader.
protected abstract IClass	findIClass(String descriptor) Find a new IClass by descriptor; return null if a class for that descriptor could not be found.
IClass	loadArrayIClass(IClass componentType) Returns the type of an array of the class, interface, array or primitive. Returns "null" for "void".
IClass	loadIClass(String fieldDescriptor) Get an IClass by field descriptor.
protected void	postConstruct() This method must be called by the constructor of the directly derived class.

Methods inherited from class java.lang.Object

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

Field Detail

OBJECT

public IClass OBJECT

STRING

public IClass STRING

CLASS

public IClass CLASS

THROWABLE

public IClass THROWABLE

RUNTIME_EXCEPTION

public IClass RUNTIME_EXCEPTION

ERROR

public IClass ERROR

CLONEABLE

public IClass CLONEABLE

SERIALIZABLE

public IClass SERIALIZABLE

Constructor Detail

IClassLoader

public IClassLoader(IClassLoader optionalParentIClassLoader)

Method Detail

postConstruct

protected final void postConstruct()

This method must be called by the constructor of the directly derived class. (The reason being is that this method invokes abstract loadIClass(String) which will not work until the implementing class is constructed.)

loadIClass

public final IClass loadIClass(String fieldDescriptor)

Get an IClass by field descriptor.

Returns:

null if an IClass could not be loaded

loadArrayIClass

public final IClass loadArrayIClass(IClass componentType)

Returns the type of an array of the class, interface, array or primitive.
Returns "null" for "void".

findIClass

protected abstract IClass findIClass(String descriptor)

Find a new IClass by descriptor; return null if a class for that descriptor could not be found.

Like ClassLoader.findClass(String), this method must

• Get an IClass object from somewhere for the given type
• Call defineIClass(IClass) with that IClass object as the argument
• Return the IClass object

The format of a descriptor is defined in JVMS 4.3.2. Typical descriptors are:

• I (Integer)
• Lpkg1/pkg2/Cls; (Class declared in package)
• Lpkg1/pkg2/Outer$Inner; Member class

Notice that this method is never called for array types.

Notice that this method is never called from more than one thread at a time. In other words, implementations of this method need not be synchronized.

defineIClass

protected final void defineIClass(IClass iClass)

Define an IClass in the context of this IClassLoader. If an IClass with that descriptor already exists, a RuntimeException is thrown.

This method should only be called from an implementation of findIClass(String).

Throws:

RuntimeException - A different IClass object is already defined for this type