public class JavaSourceClassLoader extends AbstractJavaSourceClassLoader
ClassLoader
that, unlike usual ClassLoader
s,
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 JavaSourceClassLoader
and create
a new one.
AbstractJavaSourceClassLoader.ProtectionDomainFactory
Modifier and Type | Field and Description |
---|---|
private boolean |
debugLines |
private boolean |
debugSource |
private boolean |
debugVars |
private JavaSourceIClassLoader |
iClassLoader |
private java.util.Map<java.lang.String,byte[]> |
precompiledClasses
This
Map keeps those classes which were already compiled, but not
yet defined i.e. |
optionalProtectionDomainFactory
Constructor and Description |
---|
JavaSourceClassLoader() |
JavaSourceClassLoader(java.lang.ClassLoader parentClassLoader) |
JavaSourceClassLoader(java.lang.ClassLoader parentClassLoader,
java.io.File[] optionalSourcePath,
java.lang.String optionalCharacterEncoding)
Set up a
JavaSourceClassLoader that finds Java™ source code in a file that resides in either of
the directories specified by the given source path. |
JavaSourceClassLoader(java.lang.ClassLoader parentClassLoader,
JavaSourceIClassLoader iClassLoader)
Constructs a
JavaSourceClassLoader that finds classes through an JavaSourceIClassLoader . |
JavaSourceClassLoader(java.lang.ClassLoader parentClassLoader,
ResourceFinder sourceFinder,
java.lang.String optionalCharacterEncoding)
Constructs a
JavaSourceClassLoader that finds Java™ source code through a given ResourceFinder . |
Modifier and Type | Method and Description |
---|---|
private java.lang.Class |
defineBytecode(java.lang.String className,
byte[] ba) |
protected java.lang.Class |
findClass(java.lang.String name)
Implementation of
ClassLoader.findClass(String) . |
protected java.util.Map<java.lang.String,byte[]> |
generateBytecodes(java.lang.String name)
Find, scan, parse the right compilation unit.
|
void |
setCompileErrorHandler(ErrorHandler optionalCompileErrorHandler) |
void |
setDebuggingInfo(boolean debugSource,
boolean debugLines,
boolean debugVars) |
void |
setSourceFileCharacterEncoding(java.lang.String optionalCharacterEncoding) |
void |
setSourcePath(java.io.File[] sourcePath) |
void |
setWarningHandler(WarningHandler optionalWarningHandler) |
main, setProtectionDomainFactory
clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findLibrary, findLoadedClass, findResource, findResources, findSystemClass, getClassLoadingLock, getPackage, getPackages, getParent, getResource, getResourceAsStream, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, loadClass, registerAsParallelCapable, resolveClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners
private final java.util.Map<java.lang.String,byte[]> precompiledClasses
Map
keeps those classes which were already compiled, but not
yet defined i.e. which were not yet passed to
ClassLoader.defineClass(java.lang.String, byte[], int, int)
.private final JavaSourceIClassLoader iClassLoader
private boolean debugSource
private boolean debugLines
private boolean debugVars
public JavaSourceClassLoader()
public JavaSourceClassLoader(java.lang.ClassLoader parentClassLoader)
public JavaSourceClassLoader(java.lang.ClassLoader parentClassLoader, java.io.File[] optionalSourcePath, java.lang.String optionalCharacterEncoding)
JavaSourceClassLoader
that finds Java™ source code in a file that resides in either of
the directories specified by the given source path.parentClassLoader
- See ClassLoader
optionalSourcePath
- A collection of directories that are searched for Java™ source files in
the given orderoptionalCharacterEncoding
- The encoding of the Java™ source files (null
for platform
default encoding)public JavaSourceClassLoader(java.lang.ClassLoader parentClassLoader, ResourceFinder sourceFinder, java.lang.String optionalCharacterEncoding)
JavaSourceClassLoader
that finds Java™ source code through a given ResourceFinder
.
You can specify to include certain debugging information in the generated class files, which
is useful if you want to debug through the generated classes (see
Scanner.Scanner(String, Reader)
).
parentClassLoader
- See ClassLoader
sourceFinder
- Used to locate additional source filesoptionalCharacterEncoding
- The encoding of the Java™ source files (null
for platform
default encoding)public JavaSourceClassLoader(java.lang.ClassLoader parentClassLoader, JavaSourceIClassLoader iClassLoader)
JavaSourceClassLoader
that finds classes through an JavaSourceIClassLoader
.public void setSourcePath(java.io.File[] sourcePath)
setSourcePath
in class AbstractJavaSourceClassLoader
sourcePath
- The sequence of directories to search for Java™ source filespublic void setSourceFileCharacterEncoding(java.lang.String optionalCharacterEncoding)
setSourceFileCharacterEncoding
in class AbstractJavaSourceClassLoader
optionalCharacterEncoding
- if null
, use platform default encodingpublic void setDebuggingInfo(boolean debugSource, boolean debugLines, boolean debugVars)
setDebuggingInfo
in class AbstractJavaSourceClassLoader
debugSource
- Whether line number debugging information should be generateddebugLines
- Whether variables debugging information should be generateddebugVars
- Whether source file debugging information should be generatedpublic void setCompileErrorHandler(ErrorHandler optionalCompileErrorHandler)
public void setWarningHandler(WarningHandler optionalWarningHandler)
protected java.lang.Class findClass(java.lang.String name) throws java.lang.ClassNotFoundException
ClassLoader.findClass(String)
.findClass
in class java.lang.ClassLoader
java.lang.ClassNotFoundException
protected java.util.Map<java.lang.String,byte[]> generateBytecodes(java.lang.String name) throws java.lang.ClassNotFoundException
null
if no source code could be foundjava.lang.ClassNotFoundException
- on compilation problemsprivate java.lang.Class defineBytecode(java.lang.String className, byte[] ba)
java.lang.ClassFormatError
AbstractJavaSourceClassLoader.setProtectionDomainFactory(org.codehaus.commons.compiler.AbstractJavaSourceClassLoader.ProtectionDomainFactory)