public class ClassBodyEvaluator extends SimpleCompiler implements IClassBodyEvaluator
optionalClassLoader
serves two purposes:
ByteArrayClassLoader
, or by creation of a temporary
ByteArrayClassLoader
if not.
DEFAULT_CLASS_NAME
BOOT_CLASS_LOADER, SYSTEM_PROPERTY_SOURCE_DEBUGGING_DIR, SYSTEM_PROPERTY_SOURCE_DEBUGGING_ENABLE
Constructor and Description |
---|
ClassBodyEvaluator() |
ClassBodyEvaluator(Scanner scanner,
Class optionalExtendedType,
Class[] implementedTypes,
ClassLoader optionalParentClassLoader)
Equivalent to
|
ClassBodyEvaluator(Scanner scanner,
ClassLoader optionalParentClassLoader)
Equivalent to
|
ClassBodyEvaluator(Scanner scanner,
String className,
Class optionalExtendedType,
Class[] implementedTypes,
ClassLoader optionalParentClassLoader)
Equivalent to
|
ClassBodyEvaluator(String classBody)
Equivalent to
|
ClassBodyEvaluator(String optionalFileName,
InputStream is)
Equivalent to
|
ClassBodyEvaluator(String optionalFileName,
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 Class |
compileToClass(Java.CompilationUnit compilationUnit)
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 Object |
createFastClassBodyEvaluator(Scanner scanner,
Class optionalBaseType,
ClassLoader optionalParentClassLoader)
Use
createInstance(Reader) instead: |
static Object |
createFastClassBodyEvaluator(Scanner scanner,
String className,
Class optionalExtendedClass,
Class[] implementedInterfaces,
ClassLoader optionalParentClassLoader)
Deprecated.
Use
createInstance(Reader) instead. |
Object |
createInstance(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. |
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(String className)
Set the name of the generated class.
|
void |
setDefaultImports(String[] optionalDefaultImports)
"Default imports" add to the system import "java.lang", i.e.
|
void |
setExtendedClass(Class optionalExtendedType)
Set a particular superclass that the generated class will extend.
|
void |
setExtendedType(Class optionalExtendedClass)
Deprecated.
|
void |
setImplementedInterfaces(Class[] implementedTypes)
Set a particular set of interfaces that the generated class will implement.
|
void |
setImplementedTypes(Class[] implementedInterfaces)
Deprecated.
|
assertNotCooked, classesToTypes, classToType, compileToClassLoader, cook, cook, equals, getClassLoader, hashCode, main, setCompileErrorHandler, setDebuggingInformation, setParentClassLoader, setWarningHandler
cook, cook, cook, cook, cook, cook, cook, cookFile, cookFile, cookFile, cookFile, readString
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
cook, cook, cook, cook, cook, cook, cook, cook, cookFile, cookFile, cookFile, cookFile, setCompileErrorHandler, setDebuggingInformation, setParentClassLoader, setWarningHandler
public ClassBodyEvaluator(String classBody) throws CompileException
ClassBodyEvaluator cbe = new ClassBodyEvaluator(); cbe.cook(classBody);
CompileException
ClassBodyEvaluator()
,
Cookable.cook(String)
public ClassBodyEvaluator(String optionalFileName, InputStream is) throws CompileException, IOException
ClassBodyEvaluator cbe = new ClassBodyEvaluator(); cbe.cook(optionalFileName, is);
CompileException
IOException
ClassBodyEvaluator()
,
Cookable.cook(String, InputStream)
public ClassBodyEvaluator(String optionalFileName, Reader reader) throws CompileException, IOException
ClassBodyEvaluator cbe = new ClassBodyEvaluator(); cbe.cook(optionalFileName, reader);
CompileException
IOException
ClassBodyEvaluator()
,
Cookable.cook(String, Reader)
public ClassBodyEvaluator(Scanner scanner, ClassLoader optionalParentClassLoader) throws CompileException, IOException
ClassBodyEvaluator cbe = new ClassBodyEvaluator(); cbe.setParentClassLoader(optionalParentClassLoader); cbe.cook(scanner);
public ClassBodyEvaluator(Scanner scanner, Class optionalExtendedType, Class[] implementedTypes, ClassLoader optionalParentClassLoader) throws CompileException, IOException
ClassBodyEvaluator cbe = new ClassBodyEvaluator(); cbe.setExtendedType(optionalExtendedType); cbe.setImplementedTypes(implementedTypes); cbe.setParentClassLoader(optionalParentClassLoader); cbe.cook(scanner);
public ClassBodyEvaluator(Scanner scanner, String className, Class optionalExtendedType, Class[] implementedTypes, ClassLoader optionalParentClassLoader) throws CompileException, IOException
ClassBodyEvaluator cbe = new ClassBodyEvaluator(); cbe.setClassName(className); cbe.setExtendedType(optionalExtendedType); cbe.setImplementedTypes(implementedTypes); cbe.setParentClassLoader(optionalParentClassLoader); cbe.cook(scanner);
public ClassBodyEvaluator()
public void setDefaultImports(String[] optionalDefaultImports)
IClassBodyEvaluator
Notice 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 IClassBodyEvaluator
public void setClassName(String className)
IClassBodyEvaluator
IClassBodyEvaluator.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 IClassBodyEvaluator
public void setExtendedClass(Class optionalExtendedType)
IClassBodyEvaluator
null
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(Class optionalExtendedClass)
setExtendedType
in interface IClassBodyEvaluator
public void setImplementedInterfaces(Class[] implementedTypes)
IClassBodyEvaluator
setImplementedInterfaces
in interface IClassBodyEvaluator
@Deprecated public void setImplementedTypes(Class[] implementedInterfaces)
setImplementedTypes
in interface IClassBodyEvaluator
public void cook(Scanner scanner) throws CompileException, IOException
SimpleCompiler
SimpleCompiler.getClassLoader()
returns a ClassLoader
that allows for access to the compiled classes.cook
in class SimpleCompiler
CompileException
IOException
protected final Java.CompilationUnit makeCompilationUnit(Parser optionalParser) throws CompileException, 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.
CompileException
IOException
protected Java.PackageMemberClassDeclaration addPackageMemberClassDeclaration(Location location, Java.CompilationUnit compilationUnit) throws CompileException
Java.CompilationUnit
, add
Java.ClassDeclaration
objectCompileException
protected final Class compileToClass(Java.CompilationUnit compilationUnit) throws CompileException
compilationUnit
- CompileException
public Class getClazz()
IClassBodyEvaluator
Class
.
This method must only be called after exactly one of the ICookable.cook(String,
java.io.Reader)
methods was called.
getClazz
in interface IClassBodyEvaluator
public Object createInstance(Reader reader) throws CompileException, IOException
IClassBodyEvaluator
Reader
, then creates
and returns an instance of that class.createInstance
in interface IClassBodyEvaluator
reader
- Source of class body tokensoptionalExtendedType
and implements the given
implementedTypes
CompileException
IOException
public static Object createFastClassBodyEvaluator(Scanner scanner, Class optionalBaseType, ClassLoader optionalParentClassLoader) throws CompileException, 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);
CompileException
IOException
createInstance(Reader)
@Deprecated public static Object createFastClassBodyEvaluator(Scanner scanner, String className, Class optionalExtendedClass, Class[] implementedInterfaces, ClassLoader optionalParentClassLoader) throws CompileException, IOException
createInstance(Reader)
instead.createInstance(Reader)
instead:
IClassBodyEvaluator cbe =CompilerFactoryFactory
.getDefaultCompilerFactory
().newClassBodyEvaluator
(); cbe.setExtendedClass
(optionalExtendedClass); cbe.setImplementedInterfaces
(implementedInterfaces); cbe.setParentClassLoader
(optionalParentClassLoader); cbe.createInstance
(reader);
CompileException
IOException
createInstance(Reader)
Copyright © 2001–2016. All rights reserved.