Module org.evrete.core

Package org.evrete.api

Interface JavaSourceCompiler

public interface JavaSourceCompiler

A plain source Java compiler for current RuntimeContext. Compiled classes are automatically added to the current context's classloader.

See Also:

• RuntimeContext.getSourceCompiler()

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	JavaSourceCompiler.ClassSource	The ClassSource interface represents a source code file that can be compiled by a Java compiler.
static interface	JavaSourceCompiler.Result<S extends JavaSourceCompiler.ClassSource>	The Result interface represents the result of compiling a source code file using a Java compiler.

Method Summary

Modifier and Type	Method	Description
default Class<?>	compile(String source)
<S extends JavaSourceCompiler.ClassSource> Collection<JavaSourceCompiler.Result<S>>	compile(Collection<S> sources)
default Map<String,Class<?>>	compile(Set<String> sources)	This method tries to resolve every source's package and class names and calls the compile(Collection) afterwards
void	defineClass(String binaryName, byte[] classBytes)	Defines a class by loading its binary representation into the current runtime context's classloader.
JavaSourceCompiler.ClassSource	resolve(String classSource)	Resolves plain String java class source into a JavaSourceCompiler.ClassSource instance by deriving the class's binary name

Method Details

compile

<S extends JavaSourceCompiler.ClassSource>
Collection<JavaSourceCompiler.Result<S>> compile(Collection<S> sources)
                                          throws CompilationException

Type Parameters:

S - the type of class sources

Parameters:

sources - Java sources to compile

Returns:

compiled classes.

Throws:

CompilationException - if compilation failed

resolve

JavaSourceCompiler.ClassSource resolve(String classSource)

Resolves plain String java class source into a JavaSourceCompiler.ClassSource instance by deriving the class's binary name

Parameters:

classSource - plain Java class source

Returns:

resolved JavaSourceCompiler.ClassSource instance

compile

default Map<String,Class<?>> compile(Set<String> sources)
                              throws CompilationException

This method tries to resolve every source's package and class names and calls the compile(Collection) afterwards

Parameters:

sources - Java sources to compile

Returns:

map that associates sources and their respective compilation results

Throws:

CompilationException - if compilation failed

compile

default Class<?> compile(String source)
                  throws CompilationException

Parameters:

source - plain Java source code

Returns:

compiled class

Throws:

CompilationException - if compilation failed

defineClass

void defineClass(String binaryName,
 byte[] classBytes)

Defines a class by loading its binary representation into the current runtime context's classloader. This method is used when dynamically generating classes at runtime.

Parameters:

binaryName - the fully qualified binary name of the class

classBytes - the byte array of the class's binary representation