org.codehaus.commons.compiler

Class AbstractJavaSourceClassLoader

java.lang.Object

java.lang.ClassLoader

org.codehaus.commons.compiler.AbstractJavaSourceClassLoader

Direct Known Subclasses:

JavaSourceClassLoader, JavaSourceClassLoader

public abstract class AbstractJavaSourceClassLoader
extends ClassLoader

A ClassLoader that, unlike usual ClassLoaders, does not load byte code, but reads Java source code and then scans, parses, compiles and loads it into the virtual machine.

As with any ClassLoader, it is not possible to "update" classes after they've been loaded. The way to achieve this is to give up on the AbstractJavaSourceClassLoader and create a new one.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	AbstractJavaSourceClassLoader.ProtectionDomainFactory

Field Summary

Fields

Modifier and Type	Field and Description
protected AbstractJavaSourceClassLoader.ProtectionDomainFactory	optionalProtectionDomainFactory

Constructor Summary

Constructors

Constructor and Description
AbstractJavaSourceClassLoader()
AbstractJavaSourceClassLoader(ClassLoader parentClassLoader)

Method Summary

Modifier and Type	Method and Description
static void	main(String[] args) Reads Java source code for a given class name, scan, parse, compile and load it into the virtual machine, and invoke its "main()" method with the given arguments.
abstract void	setDebuggingInfo(boolean lines, boolean vars, boolean source)
void	setProtectionDomainFactory(AbstractJavaSourceClassLoader.ProtectionDomainFactory optionalProtectionDomainFactory)
abstract void	setSourceFileCharacterEncoding(String optionalCharacterEncoding)
abstract void	setSourcePath(File[] sourcePath)

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findLibrary, findLoadedClass, findResource, findResources, findSystemClass, getClassLoadingLock, getPackage, getPackages, getParent, getResource, getResourceAsStream, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, 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

optionalProtectionDomainFactory

@Nullable
protected AbstractJavaSourceClassLoader.ProtectionDomainFactory optionalProtectionDomainFactory

See Also:

ClassLoader.defineClass(String, byte[], int, int, ProtectionDomain)

Constructor Detail

AbstractJavaSourceClassLoader

public AbstractJavaSourceClassLoader()

AbstractJavaSourceClassLoader

public AbstractJavaSourceClassLoader(ClassLoader parentClassLoader)

Method Detail

setSourcePath

public abstract void setSourcePath(File[] sourcePath)

Parameters:

sourcePath - The sequence of directories to search for Java source files

setSourceFileCharacterEncoding

public abstract void setSourceFileCharacterEncoding(@Nullable
                                                    String optionalCharacterEncoding)

Parameters:

optionalCharacterEncoding - if null, use platform default encoding

setDebuggingInfo

public abstract void setDebuggingInfo(boolean lines,
                                      boolean vars,
                                      boolean source)

Parameters:

lines - Whether line number debugging information should be generated

vars - Whether variables debugging information should be generated

source - Whether source file debugging information should be generated

setProtectionDomainFactory

public final void setProtectionDomainFactory(@Nullable
                                             AbstractJavaSourceClassLoader.ProtectionDomainFactory optionalProtectionDomainFactory)

See Also:

ClassLoader.defineClass(String, byte[], int, int, ProtectionDomain)

main

public static void main(String[] args)
                 throws Exception

Reads Java source code for a given class name, scan, parse, compile and load it into the virtual machine, and invoke its "main()" method with the given arguments.

Usage is as follows:

   java AbstractJavaSourceClassLoader [ option ] ... class-name [ argument ] ...

   option:
     -sourcepath colon-separated-list-of-source-directories
     -encoding character-encoding
     -g                           Generate all debugging info
     -g:none                      Generate no debugging info
     -g:{source,lines,vars}       Generate only some debugging info
 

Throws:

Exception