Package org.codehaus.commons.compiler
package org.codehaus.commons.compiler
This package declares interfaces for the implementation of an
IExpressionEvaluator
, an IScriptEvaluator
, an
IClassBodyEvaluator
and an ISimpleCompiler
. All of these adhere to the syntax of the Java programming
language.
There are (at least) two implementations of these interfaces available:
-
org.codehaus.janino
: A lightweight, stand-alone implementation that implements Java 1.4 and most of Java 5. Runs on all JREs starting at version 1.3. -
org.codehaus.commons.compiler.jdk
: Uses thejavax.tools.JavaCompiler
API that is available since Java 1.6. Requires a JDK (not just a JRE).
Notice: Implementations may or may not be prone to "Java injection", i.e. it may or may not be possible to, e.g.,
break out of the "expression" scope of an IExpressionEvaluator
by providing
a "bogus" expression text. The documentation of each implementation should state clearly whether or not it is
prone to Java injection.
-
ClassDescriptionA base class and wrapper for
invalid reference
Compiler
Base class for a simpleICompilerFactory
.AClassLoader
that, unlike usualClassLoader
s, does not load byte code, but reads Java source code and then scans, parses, compiles and loads it into the virtual machine.Representation of an error condition during compilation.Utility class that finds implementations ofICompilerFactory
s.Base class for a simpleICookable
.Processes an error issued by the compiler.Parses a class body and returns it as aClass
object ready for use with java.lang.reflect.A simplified substitute for the javac tool.An entity that produces implementations ofIExpressionEvaluator
,IScriptEvaluator
,IClassBodyEvaluator
,ISimpleCompiler
orAbstractJavaSourceClassLoader
.An entity that processes a sequence of characters (a "document").An engine that evaluates expressions in JVM bytecode.Indicates an event that is probably related to a bug in JANINO.An engine that executes a script in JVM bytecode.A simplified Java compiler that can compile only a single compilation unit.Immutable representation of the location of a character in a document, as defined by an (optional) file name, a line number and a column number.Implements all methods ofIMultiCookable
, except forIMultiCookable.cook(String[], Reader[])
.Executes aPrivilegedAction
orPrivilegedExceptionAction
in a context with restricted permissions.Processes a warning issued by the compiler.