public class ClassBodyEvaluator extends SimpleCompiler implements IClassBodyEvaluator
optionalClassLoader serves two purposes:
ByteArrayClassLoader, or by creation of a temporary
ByteArrayClassLoader if not.
| Modifier and Type | Field and Description |
|---|---|
protected java.lang.String |
className |
protected static java.lang.Class[] |
ZERO_CLASSES |
debugLines, debugSource, debugVarsDEFAULT_CLASS_NAMEBOOT_CLASS_LOADER, SYSTEM_PROPERTY_SOURCE_DEBUGGING_DIR, SYSTEM_PROPERTY_SOURCE_DEBUGGING_ENABLE| Constructor and Description |
|---|
ClassBodyEvaluator() |
ClassBodyEvaluator(Scanner scanner,
java.lang.Class optionalExtendedType,
java.lang.Class[] implementedTypes,
java.lang.ClassLoader optionalParentClassLoader)
Equivalent to
|
ClassBodyEvaluator(Scanner scanner,
java.lang.ClassLoader optionalParentClassLoader)
Equivalent to
|
ClassBodyEvaluator(Scanner scanner,
java.lang.String className,
java.lang.Class optionalExtendedType,
java.lang.Class[] implementedTypes,
java.lang.ClassLoader optionalParentClassLoader)
Equivalent to
|
ClassBodyEvaluator(java.lang.String classBody)
Equivalent to
|
ClassBodyEvaluator(java.lang.String optionalFileName,
java.io.InputStream is)
Equivalent to
|
ClassBodyEvaluator(java.lang.String optionalFileName,
java.io.Reader reader)
Equivalent to
|
| Modifier and Type | Method and Description |
|---|---|
protected Java.PackageMemberClassDeclaration |
addPackageMemberClassDeclaration(Location location,
Java.CompilationUnit compilationUnit)
To the given
Java.CompilationUnit, add
A class declaration with the configured name, superclass and interfaces
A method declaration with the given return type, name, parameter names and values and thrown exceptions
|
protected java.lang.Class |
compileToClass(Java.CompilationUnit compilationUnit,
java.lang.String newClassName)
Compile the given compilation unit, load all generated classes, and return the class with the given name.
|
void |
cook(Scanner scanner)
Scans, parses and ompiles a given compilation unit from the given scanner.
|
static java.lang.Object |
createFastClassBodyEvaluator(Scanner scanner,
java.lang.Class optionalBaseType,
java.lang.ClassLoader optionalParentClassLoader)
Use
createInstance(Reader) instead: |
static java.lang.Object |
createFastClassBodyEvaluator(Scanner scanner,
java.lang.String className,
java.lang.Class optionalExtendedClass,
java.lang.Class[] implementedInterfaces,
java.lang.ClassLoader optionalParentClassLoader)
Deprecated.
|
java.lang.Object |
createInstance(java.io.Reader reader)
Scans, parses and compiles a class body from the tokens delivered by the the given
Reader, then creates
and returns an instance of that class. |
java.lang.Class |
getClazz()
Returns the loaded
Class. |
protected Java.CompilationUnit |
makeCompilationUnit(Parser optionalParser)
Create a
Java.CompilationUnit, set the default imports, and parse the import declarations. |
void |
setClassName(java.lang.String className)
Set the name of the generated class.
|
void |
setDefaultImports(java.lang.String[] optionalDefaultImports)
"Default imports" add to the system import "java.lang", i.e.
|
void |
setExtendedClass(java.lang.Class optionalExtendedType)
Set a particular superclass that the generated class will extend.
|
void |
setExtendedType(java.lang.Class optionalExtendedClass)
Deprecated.
|
void |
setImplementedInterfaces(java.lang.Class[] implementedTypes)
Set a particular set of interfaces that the generated class will implement.
|
void |
setImplementedTypes(java.lang.Class[] implementedInterfaces)
Deprecated.
|
assertNotCooked, classesToTypes, classToType, compileToClassLoader, cook, cook, equals, getClassLoader, hashCode, main, setDebuggingInformation, setParentClassLoadercook, cook, cook, cook, cook, cook, cook, cookFile, cookFile, cookFile, cookFile, readStringprotected static final java.lang.Class[] ZERO_CLASSES
protected java.lang.String className
public ClassBodyEvaluator(java.lang.String classBody)
throws CompileException
ClassBodyEvaluator cbe = new ClassBodyEvaluator(); cbe.cook(classBody);
CompileExceptionClassBodyEvaluator(),
Cookable.cook(String)public ClassBodyEvaluator(java.lang.String optionalFileName,
java.io.InputStream is)
throws CompileException,
java.io.IOException
ClassBodyEvaluator cbe = new ClassBodyEvaluator(); cbe.cook(optionalFileName, is);
CompileExceptionjava.io.IOExceptionClassBodyEvaluator(),
Cookable.cook(String, InputStream)public ClassBodyEvaluator(java.lang.String optionalFileName,
java.io.Reader reader)
throws CompileException,
java.io.IOException
ClassBodyEvaluator cbe = new ClassBodyEvaluator(); cbe.cook(optionalFileName, reader);
CompileExceptionjava.io.IOExceptionClassBodyEvaluator(),
Cookable.cook(String, Reader)public ClassBodyEvaluator(Scanner scanner, java.lang.ClassLoader optionalParentClassLoader) throws CompileException, java.io.IOException
ClassBodyEvaluator cbe = new ClassBodyEvaluator(); cbe.setParentClassLoader(optionalParentClassLoader); cbe.cook(scanner);
CompileExceptionjava.io.IOExceptionClassBodyEvaluator(),
SimpleCompiler.setParentClassLoader(ClassLoader),
Cookable.cook(Reader)public ClassBodyEvaluator(Scanner scanner, java.lang.Class optionalExtendedType, java.lang.Class[] implementedTypes, java.lang.ClassLoader optionalParentClassLoader) throws CompileException, java.io.IOException
ClassBodyEvaluator cbe = new ClassBodyEvaluator(); cbe.setExtendedType(optionalExtendedType); cbe.setImplementedTypes(implementedTypes); cbe.setParentClassLoader(optionalParentClassLoader); cbe.cook(scanner);
CompileExceptionjava.io.IOExceptionClassBodyEvaluator(),
setExtendedClass(Class),
setImplementedInterfaces(Class[]),
SimpleCompiler.setParentClassLoader(ClassLoader),
Cookable.cook(Reader)public ClassBodyEvaluator(Scanner scanner, java.lang.String className, java.lang.Class optionalExtendedType, java.lang.Class[] implementedTypes, java.lang.ClassLoader optionalParentClassLoader) throws CompileException, java.io.IOException
ClassBodyEvaluator cbe = new ClassBodyEvaluator(); cbe.setClassName(className); cbe.setExtendedType(optionalExtendedType); cbe.setImplementedTypes(implementedTypes); cbe.setParentClassLoader(optionalParentClassLoader); cbe.cook(scanner);
CompileExceptionjava.io.IOExceptionClassBodyEvaluator(),
setClassName(String),
setExtendedClass(Class),
setImplementedInterfaces(Class[]),
SimpleCompiler.setParentClassLoader(ClassLoader),
Cookable.cook(Reader)public ClassBodyEvaluator()
public void setDefaultImports(java.lang.String[] optionalDefaultImports)
IClassBodyEvaluatorNotice that JDK 5 "static imports" are also supported, as shown in the following example.
Example:
sc.setDefaultImports(new String[] {
"java.util.Map", // Single type import
"java.io.*", // Type-import-on-demand
"static java.util.Collections.EMPTY_MAP", // Single static import
"static java.util.Collections.*", // Static-import-on-demand
});setDefaultImports in interface IClassBodyEvaluatorpublic void setClassName(java.lang.String className)
IClassBodyEvaluatorIClassBodyEvaluator.DEFAULT_CLASS_NAME. In most cases,
there is no need to set this name, because the generated class is loaded into its own
ClassLoader where its name cannot collide with classes generated by
other evaluators.
One reason to use this function is to have a class name in a non-default package, which can be relevant when types and members with DEFAULT accessibility are accessed.
setClassName in interface IClassBodyEvaluatorpublic void setExtendedClass(java.lang.Class optionalExtendedType)
IClassBodyEvaluatornull is
passed, the generated class will extend Object.
The common reason to set a base class for an evaluator is that the generated class can directly access the base superclass's (non-private) members.
setExtendedClass in interface IClassBodyEvaluator@Deprecated public void setExtendedType(java.lang.Class optionalExtendedClass)
setExtendedType in interface IClassBodyEvaluatorpublic void setImplementedInterfaces(java.lang.Class[] implementedTypes)
IClassBodyEvaluatorsetImplementedInterfaces in interface IClassBodyEvaluator@Deprecated public void setImplementedTypes(java.lang.Class[] implementedInterfaces)
setImplementedTypes in interface IClassBodyEvaluatorpublic void cook(Scanner scanner) throws CompileException, java.io.IOException
SimpleCompilerSimpleCompiler.getClassLoader() returns a ClassLoader that allows for access to the compiled classes.cook in class SimpleCompilerCompileExceptionjava.io.IOExceptionprotected final Java.CompilationUnit makeCompilationUnit(Parser optionalParser) throws CompileException, java.io.IOException
Java.CompilationUnit, set the default imports, and parse the import declarations.
If the optionalParser is given, a sequence of IMPORT directives is parsed from it and added to the
compilation unit.
CompileExceptionjava.io.IOExceptionprotected Java.PackageMemberClassDeclaration addPackageMemberClassDeclaration(Location location, Java.CompilationUnit compilationUnit) throws CompileException
Java.CompilationUnit, add
Java.ClassDeclaration objectCompileExceptionprotected final java.lang.Class compileToClass(Java.CompilationUnit compilationUnit, java.lang.String newClassName) throws CompileException
compilationUnit - newClassName - The fully qualified class nameCompileExceptionpublic java.lang.Class getClazz()
IClassBodyEvaluatorClass.
This method must only be called after exactly one of the ICookable.cook(String,
java.io.Reader) methods was called.
getClazz in interface IClassBodyEvaluatorpublic java.lang.Object createInstance(java.io.Reader reader)
throws CompileException,
java.io.IOException
IClassBodyEvaluatorReader, then creates
and returns an instance of that class.createInstance in interface IClassBodyEvaluatorreader - Source of class body tokensoptionalExtendedType and implements the given
implementedTypesCompileExceptionjava.io.IOExceptionpublic static java.lang.Object createFastClassBodyEvaluator(Scanner scanner, java.lang.Class optionalBaseType, java.lang.ClassLoader optionalParentClassLoader) throws CompileException, java.io.IOException
createInstance(Reader) instead:
IClassBodyEvaluator cbe =CompilerFactoryFactory.getDefaultCompilerFactory().newClassBodyEvaluator(); if (optionalBaseType != null) { if (optionalBaseType.isInterface()) { cbe.setImplementedInterfaces(new Class[] { optionalBaseType }); } else { cbe.setExtendedClass(optionalBaseType); } } cbe.setParentClassLoader(optionalParentClassLoader); cbe.createInstance(reader);
CompileExceptionjava.io.IOExceptioncreateInstance(Reader)@Deprecated public static java.lang.Object createFastClassBodyEvaluator(Scanner scanner, java.lang.String className, java.lang.Class optionalExtendedClass, java.lang.Class[] implementedInterfaces, java.lang.ClassLoader optionalParentClassLoader) throws CompileException, java.io.IOException
createInstance(Reader) instead:
IClassBodyEvaluator cbe =CompilerFactoryFactory.getDefaultCompilerFactory().newClassBodyEvaluator(); cbe.setExtendedClass(optionalExtendedClass); cbe.setImplementedInterfaces(implementedInterfaces); cbe.setParentClassLoader(optionalParentClassLoader); cbe.createInstance(reader);
CompileExceptionjava.io.IOExceptioncreateInstance(Reader)