org.codehaus.commons.compiler.jdk

Class JavaSourceClassLoader

java.lang.Object

java.lang.ClassLoader

org.codehaus.commons.compiler.AbstractJavaSourceClassLoader

org.codehaus.commons.compiler.jdk.JavaSourceClassLoader

public class JavaSourceClassLoader
extends AbstractJavaSourceClassLoader

A ClassLoader that loads classes by looking for their source files through a 'source path' and compiling them on-the-fly.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	JavaSourceClassLoader.DiagnosticException

Nested classes/interfaces inherited from class org.codehaus.commons.compiler.AbstractJavaSourceClassLoader

AbstractJavaSourceClassLoader.ProtectionDomainFactory

Field Summary

Fields

Modifier and Type	Field and Description
private javax.tools.JavaCompiler	compiler
private java.util.Collection<java.lang.String>	compilerOptions
private boolean	debuggingInfoLines
private boolean	debuggingInfoSource
private boolean	debuggingInfoVars
private javax.tools.JavaFileManager	fileManager
private java.lang.String	optionalCharacterEncoding
private java.io.File[]	sourcePath

Fields inherited from class org.codehaus.commons.compiler.AbstractJavaSourceClassLoader

optionalProtectionDomainFactory

Constructor Summary

Constructors

Constructor and Description
JavaSourceClassLoader()
JavaSourceClassLoader(java.lang.ClassLoader parentClassLoader)

Method Summary

Modifier and Type	Method and Description
protected java.lang.Class<?>	findClass(java.lang.String className) Implementation of ClassLoader.findClass(String).
(package private) javax.tools.JavaFileManager	getJavaFileManager() Creates the underlying JavaFileManager lazily, because setSourcePath(File[]) and consorts are called after initialization.
private static java.lang.String	getSourceResourceName(java.lang.String className) Construct the name of a resource that could contain the source code of the class with the given name.
private void	init()
void	setCompilerOptions(java.lang.String[] compilerOptions) Notice: Don't use the '-g' options - these are controlled through setDebuggingInfo(boolean, boolean, boolean).
void	setDebuggingInfo(boolean lines, boolean vars, boolean source)
void	setSourceFileCharacterEncoding(java.lang.String optionalCharacterEncoding)
void	setSourcePath(java.io.File[] sourcePath)

Methods inherited from class org.codehaus.commons.compiler.AbstractJavaSourceClassLoader

main, setProtectionDomainFactory

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findLibrary, findLoadedClass, findResource, findResources, findSystemClass, getClassLoadingLock, getPackage, getPackages, getParent, getProtectionDomainInternal, 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

sourcePath

private java.io.File[] sourcePath

optionalCharacterEncoding

private java.lang.String optionalCharacterEncoding

debuggingInfoLines

private boolean debuggingInfoLines

debuggingInfoVars

private boolean debuggingInfoVars

debuggingInfoSource

private boolean debuggingInfoSource

compilerOptions

private java.util.Collection<java.lang.String> compilerOptions

compiler

private javax.tools.JavaCompiler compiler

fileManager

private javax.tools.JavaFileManager fileManager

Constructor Detail

JavaSourceClassLoader

public JavaSourceClassLoader()

See Also:

ICompilerFactory.newJavaSourceClassLoader()

JavaSourceClassLoader

public JavaSourceClassLoader(java.lang.ClassLoader parentClassLoader)

See Also:

ICompilerFactory.newJavaSourceClassLoader(ClassLoader)

Method Detail

init

private void init()

getJavaFileManager

javax.tools.JavaFileManager getJavaFileManager()

Creates the underlying JavaFileManager lazily, because setSourcePath(File[]) and consorts are called after initialization.

setSourcePath

public void setSourcePath(java.io.File[] sourcePath)

Specified by:

setSourcePath in class AbstractJavaSourceClassLoader

Parameters:

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

setSourceFileCharacterEncoding

public void setSourceFileCharacterEncoding(java.lang.String optionalCharacterEncoding)

Specified by:

setSourceFileCharacterEncoding in class AbstractJavaSourceClassLoader

Parameters:

optionalCharacterEncoding - if null, use platform default encoding

setDebuggingInfo

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

Specified by:

setDebuggingInfo in class AbstractJavaSourceClassLoader

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

setCompilerOptions

public void setCompilerOptions(java.lang.String[] compilerOptions)

Notice: Don't use the '-g' options - these are controlled through setDebuggingInfo(boolean, boolean, boolean).

Parameters:

compilerOptions - All command line options supported by the JDK JAVAC tool

findClass

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

Implementation of ClassLoader.findClass(String).

Overrides:

findClass in class java.lang.ClassLoader

Throws:

java.lang.ClassNotFoundException

getSourceResourceName

private static java.lang.String getSourceResourceName(java.lang.String className)

Construct the name of a resource that could contain the source code of the class with the given name.

Notice that member types are declared inside a different type, so the relevant source file is that of the outermost declaring class.

Parameters:

className - Fully qualified class name, e.g. "pkg1.pkg2.Outer$Inner"

Returns:

the name of the resource, e.g. "pkg1/pkg2/Outer.java"