public class SimpleCompiler extends Cookable implements ISimpleCompiler
SimpleCompiler
object, proceed as described for ISimpleCompiler
.
Alternatively, a number of "convenience constructors" exist that execute the described steps
instantly.BOOT_CLASS_LOADER, SYSTEM_PROPERTY_SOURCE_DEBUGGING_DIR, SYSTEM_PROPERTY_SOURCE_DEBUGGING_ENABLE
Constructor and Description |
---|
SimpleCompiler() |
SimpleCompiler(Scanner scanner,
ClassLoader optionalParentClassLoader)
Equivalent to
|
SimpleCompiler(String fileName)
Equivalent to
|
SimpleCompiler(String optionalFileName,
InputStream is)
Equivalent to
|
SimpleCompiler(String optionalFileName,
Reader in)
Equivalent to
|
Modifier and Type | Method and Description |
---|---|
protected void |
assertNotCooked() |
protected Java.Type[] |
classesToTypes(Location location,
Class[] classes)
|
protected Java.Type |
classToType(Location location,
Class clazz)
|
protected ClassLoader |
compileToClassLoader(Java.CompilationUnit compilationUnit)
Compile the given compilation unit.
|
void |
cook(Java.CompilationUnit compilationUnit)
Cooks this compilation unit directly.
|
void |
cook(Scanner scanner)
Scans, parses and ompiles a given compilation unit from the given scanner.
|
void |
cook(String optionalFileName,
Reader r)
Scans, parses and compiles a given compilation unit from the given
Reader . |
boolean |
equals(Object o)
Two
SimpleCompiler s are regarded equal iff
Both are objects of the same class (e.g. |
ClassLoader |
getClassLoader()
Returns a
ClassLoader object through which the previously compiled classes can be accessed. |
int |
hashCode() |
static void |
main(String[] args) |
void |
setCompileErrorHandler(ErrorHandler optionalCompileErrorHandler)
By default,
CompileException s are thrown on compile errors, but an application my install its own
ErrorHandler . |
void |
setDebuggingInformation(boolean debugSource,
boolean debugLines,
boolean debugVars)
Determines what kind of debugging information is included in the generates classes.
|
void |
setParentClassLoader(ClassLoader optionalParentClassLoader)
The "parent class loader" is used to load referenced classes.
|
void |
setWarningHandler(WarningHandler optionalWarningHandler)
By default, warnings are discarded, but an application my install a custom
WarningHandler . |
cook, cook, cook, cook, cook, cook, cook, cookFile, cookFile, cookFile, cookFile, readString
public SimpleCompiler(String optionalFileName, Reader in) throws IOException, CompileException
SimpleCompiler sc = new SimpleCompiler(); sc.cook(optionalFileName, in);
IOException
CompileException
SimpleCompiler()
,
Cookable.cook(String, Reader)
public SimpleCompiler(String optionalFileName, InputStream is) throws IOException, CompileException
SimpleCompiler sc = new SimpleCompiler(); sc.cook(optionalFileName, is);
IOException
CompileException
SimpleCompiler()
,
Cookable.cook(String, InputStream)
public SimpleCompiler(String fileName) throws IOException, CompileException
SimpleCompiler sc = new SimpleCompiler(); sc.cook(fileName);
IOException
CompileException
SimpleCompiler()
,
Cookable.cookFile(String)
public SimpleCompiler(Scanner scanner, ClassLoader optionalParentClassLoader) throws IOException, CompileException
SimpleCompiler sc = new SimpleCompiler(); sc.setParentClassLoader(optionalParentClassLoader); sc.cook(scanner);
public SimpleCompiler()
public void setParentClassLoader(ClassLoader optionalParentClassLoader)
ICookable
System.getSystemClassLoader() |
The running JVM's class path |
Thread.currentThread().getContextClassLoader() or null |
The class loader effective for the invoking thread |
ICookable.BOOT_CLASS_LOADER |
The running JVM's boot class path |
setParentClassLoader
in interface ICookable
public void setDebuggingInformation(boolean debugSource, boolean debugLines, boolean debugVars)
ICookable
setDebuggingInformation
in interface ICookable
public final void cook(String optionalFileName, Reader r) throws CompileException, IOException
Reader
. After completion, getClassLoader()
returns a ClassLoader
that allows for access to the compiled classes.cook
in interface ICookable
cook
in class Cookable
optionalFileName
- Used when reporting errors and warnings.CompileException
IOException
ICookable.cook(String, Reader)
public void cook(Scanner scanner) throws CompileException, IOException
getClassLoader()
returns a ClassLoader
that allows for access to the compiled classes.CompileException
IOException
public void cook(Java.CompilationUnit compilationUnit) throws CompileException
CompileException
Cookable.cook(Reader)
public ClassLoader getClassLoader()
ISimpleCompiler
ClassLoader
object through which the previously compiled classes can be accessed. This ClassLoader
can be used for subsequent ISimpleCompiler
s in order to compile compilation units that use
types (e.g. declare derived types) declared in the previous one.
This method must only be called after exactly on of the ICookable.cook(String, java.io.Reader)
methods was called.
getClassLoader
in interface ISimpleCompiler
public boolean equals(Object o)
SimpleCompiler
s are regarded equal iff
ScriptEvaluator
s)
Object.equals(Object)
public void setCompileErrorHandler(ErrorHandler optionalCompileErrorHandler)
ICookable
CompileException
s are thrown on compile errors, but an application my install its own
ErrorHandler
.
Be aware that a single problem during compilation often causes a bunch of compile errors, so a good ErrorHandler
counts errors and throws a CompileException
when a limit is reached.
If the given ErrorHandler
throws CompileException
s, then the compilation is terminated and
the exception is propagated.
If the given ErrorHandler
does not throw CompileException
s, then the compiler may or may not
continue compilation, but must eventually throw a CompileException
.
In other words: The ErrorHandler
may throw a CompileException
or not, but the compiler must
definitely throw a CompileException
if one or more compile errors have occurred.
setCompileErrorHandler
in interface ICookable
optionalCompileErrorHandler
- null
to restore the default behavior (throwing a CompileException
public void setWarningHandler(WarningHandler optionalWarningHandler)
ICookable
WarningHandler
.setWarningHandler
in interface ICookable
optionalWarningHandler
- null
to indicate that no warnings be issuedprotected final ClassLoader compileToClassLoader(Java.CompilationUnit compilationUnit) throws CompileException
compilationUnit
- The parsed compilation unitClassLoader
into which the compiled classes were definedCompileException
protected void assertNotCooked()
IllegalStateException
- This Cookable
is already cookedCopyright © 2001–2016. All rights reserved.