org.codehaus.janino

Class SimpleCompiler

java.lang.Object

org.codehaus.commons.compiler.Cookable

org.codehaus.janino.SimpleCompiler

All Implemented Interfaces:

ICookable, ISimpleCompiler

public class SimpleCompiler
extends Cookable
implements ISimpleCompiler

To set up a SimpleCompiler object, proceed as described for ISimpleCompiler. Alternatively, a number of "convenience constructors" exist that execute the described steps instantly.

Constructor Summary

Constructors

Constructor and Description
SimpleCompiler()
SimpleCompiler(Scanner scanner, ClassLoader parentClassLoader) Equivalent to SimpleCompiler sc = new SimpleCompiler(); sc.setParentClassLoader(parentClassLoader); sc.cook(scanner);
SimpleCompiler(String fileName) Equivalent to SimpleCompiler sc = new SimpleCompiler(); sc.cook(fileName);
SimpleCompiler(String fileName, InputStream is) Equivalent to SimpleCompiler sc = new SimpleCompiler(); sc.cook(fileName, is);
SimpleCompiler(String fileName, Reader in) Equivalent to SimpleCompiler sc = new SimpleCompiler(); sc.cook(fileName, in);

Method Summary

Modifier and Type	Method and Description
protected Java.Type[]	classesToTypes(Location location, Class<?>[] classes) Converts an array of Classes into an array ofJava.Types.
protected Java.Type	classToType(Location location, Class<?> clazz) Wraps a reflection Class in a Java.Type object.
protected ClassLoader	compileToClassLoader(Java.AbstractCompilationUnit abstractCompilationUnit) Compiles the given compilation unit.
void	cook(Java.AbstractCompilationUnit abstractCompilationUnit) Cooks this compilation unit directly.
void	cook(Scanner scanner) Scans, parses and compiles a given compilation unit from the given scanner.
void	cook(String fileName, Reader r) Scans, parses and compiles a given compilation unit from the given Reader.
boolean	equals(Object o) Two SimpleCompilers are regarded equal iff Both are objects of the same class (e.g. both are ScriptEvaluators) Both generated functionally equal classes as seen by Object.equals(Object)
Map<String,byte[]>	getBytecodes()
ClassFile[]	getClassFiles()
ClassLoader	getClassLoader()
int	hashCode()
static void	main(String[] args)
protected Java.Type	optionalClassToType(Location location, Class<?> clazz) Wraps a reflection Class in a Java.Type object.
EnumSet<JaninoOption>	options()
SimpleCompiler	options(EnumSet<JaninoOption> options) Sets the options for all future compilations.
void	setCompileErrorHandler(ErrorHandler compileErrorHandler)
void	setDebuggingInformation(boolean debugSource, boolean debugLines, boolean debugVars)
void	setParentClassLoader(ClassLoader parentClassLoader)
void	setSourceVersion(int version) Controls the language elements that are accepted by the Parser.
void	setTargetVersion(int version) Controls the .class files that are generated by the UnitCompiler.
void	setWarningHandler(WarningHandler warningHandler)

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

cook, cook, cook, cook, cook, cook, cook, cookFile, cookFile, cookFile, cookFile

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.codehaus.commons.compiler.ICookable

cook, cook, cook, cook, cook, cook, cook, cookFile, cookFile, cookFile, cookFile

Constructor Detail

SimpleCompiler

public SimpleCompiler(@Nullable
                      String fileName,
                      Reader in)
               throws IOException,
                      CompileException

Equivalent to

     SimpleCompiler sc = new SimpleCompiler();
     sc.cook(fileName, in);
 

Throws:

IOException

CompileException

See Also:

SimpleCompiler(), Cookable.cook(String, Reader)

SimpleCompiler

public SimpleCompiler(@Nullable
                      String fileName,
                      InputStream is)
               throws IOException,
                      CompileException

Equivalent to

     SimpleCompiler sc = new SimpleCompiler();
     sc.cook(fileName, is);
 

Throws:

IOException

CompileException

See Also:

SimpleCompiler(), Cookable.cook(String, InputStream)

SimpleCompiler

public SimpleCompiler(String fileName)
               throws IOException,
                      CompileException

Equivalent to

     SimpleCompiler sc = new SimpleCompiler();
     sc.cook(fileName);
 

Throws:

IOException

CompileException

See Also:

SimpleCompiler(), Cookable.cookFile(String)

SimpleCompiler

public SimpleCompiler(Scanner scanner,
                      @Nullable
                      ClassLoader parentClassLoader)
               throws IOException,
                      CompileException

Equivalent to

     SimpleCompiler sc = new SimpleCompiler();
     sc.setParentClassLoader(parentClassLoader);
     sc.cook(scanner);
 

Throws:

IOException

CompileException

See Also:

SimpleCompiler(), setParentClassLoader(ClassLoader), Cookable.cook(Reader)

SimpleCompiler

public SimpleCompiler()

Method Detail

main

public static void main(String[] args)
                 throws Exception

Throws:

Exception

setParentClassLoader

public void setParentClassLoader(@Nullable
                                 ClassLoader parentClassLoader)

Specified by:

setParentClassLoader in interface ISimpleCompiler

setDebuggingInformation

public void setDebuggingInformation(boolean debugSource,
                                    boolean debugLines,
                                    boolean debugVars)

Specified by:

setDebuggingInformation in interface ISimpleCompiler

cook

public final void cook(@Nullable
                       String fileName,
                       Reader r)
                throws CompileException,
                       IOException

Scans, parses and compiles a given compilation unit from the given Reader. After completion, getClassLoader() returns a ClassLoader that allows for access to the compiled classes.

Specified by:

cook in interface ICookable

Specified by:

cook in class Cookable

Throws:

CompileException

IOException

cook

public void cook(Scanner scanner)
          throws CompileException,
                 IOException

Scans, parses and compiles a given compilation unit from the given scanner. After completion, getClassLoader() returns a ClassLoader that allows for access to the compiled classes.

Throws:

CompileException

IOException

cook

public void cook(Java.AbstractCompilationUnit abstractCompilationUnit)
          throws CompileException

Cooks this compilation unit directly.

Throws:

CompileException

getClassFiles

public ClassFile[] getClassFiles()

Returns:

The ClassFiles that were generated during cooking

setSourceVersion

public void setSourceVersion(int version)

Controls the language elements that are accepted by the Parser.

Specified by:

setSourceVersion in interface ICookable

See Also:

Parser.setSourceVersion(int)

setTargetVersion

public void setTargetVersion(int version)

Controls the .class files that are generated by the UnitCompiler.

Specified by:

setTargetVersion in interface ICookable

See Also:

UnitCompiler.setTargetVersion(int)

getBytecodes

public Map<String,byte[]> getBytecodes()

Specified by:

getBytecodes in interface ICookable

getClassLoader

public ClassLoader getClassLoader()

Specified by:

getClassLoader in interface ISimpleCompiler

equals

public boolean equals(@Nullable
                      Object o)

Two SimpleCompilers are regarded equal iff

• Both are objects of the same class (e.g. both are ScriptEvaluators)
• Both generated functionally equal classes as seen by Object.equals(Object)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

setCompileErrorHandler

public void setCompileErrorHandler(@Nullable
                                   ErrorHandler compileErrorHandler)

Specified by:

setCompileErrorHandler in interface ISimpleCompiler

setWarningHandler

public void setWarningHandler(@Nullable
                              WarningHandler warningHandler)

Specified by:

setWarningHandler in interface ISimpleCompiler

options

public EnumSet<JaninoOption> options()

Returns:

A reference to the currently effective compilation options; changes to it take effect immediately

options

public SimpleCompiler options(EnumSet<JaninoOption> options)

Sets the options for all future compilations.

optionalClassToType

@Nullable
protected Java.Type optionalClassToType(Location location,
                                                   @Nullable
                                                   Class<?> clazz)

Wraps a reflection Class in a Java.Type object.

classToType

protected Java.Type classToType(Location location,
                                Class<?> clazz)

Wraps a reflection Class in a Java.Type object.

classesToTypes

protected Java.Type[] classesToTypes(Location location,
                                     @Nullable
                                     Class<?>[] classes)

Converts an array of Classes into an array ofJava.Types.

compileToClassLoader

protected final ClassLoader compileToClassLoader(Java.AbstractCompilationUnit abstractCompilationUnit)
                                          throws CompileException

Compiles the given compilation unit. (A "compilation unit" is typically the contents of a Java source file.)

Parameters:

abstractCompilationUnit - The parsed compilation unit

Returns:

The ClassLoader into which the compiled classes were defined

Throws:

CompileException