org.agrona.generation

Class CompilerUtil

java.lang.Object

org.agrona.generation.CompilerUtil

public final class CompilerUtil
extends Object

Utilities for compiling Java source files at runtime.

Method Summary

Modifier and Type	Method and Description
static boolean	compile(DiagnosticCollector<JavaFileObject> diagnostics, JavaCompiler.CompilationTask task) Execute compilation task and report errors if it fails.
static Class<?>	compileAndLoad(String className, DiagnosticCollector<JavaFileObject> diagnostics, JavaFileManager fileManager, JavaCompiler.CompilationTask task) Compile and load a class.
static Class<?>	compileInMemory(String className, Map<String,CharSequence> sources) Compile a Map of source files in-memory resulting in a Class which is named.
static Class<?>	compileOnDisk(String className, Map<String,CharSequence> sources) Compile a Map of source files on disk resulting in a Class which is named.
static Collection<File>	persist(Map<String,CharSequence> sources) Persist source files to disc.

Methods inherited from class java.lang.Object

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

Method Detail

compileInMemory

public static Class<?> compileInMemory(String className,
                                       Map<String,CharSequence> sources)
                                throws ClassNotFoundException

Compile a Map of source files in-memory resulting in a Class which is named.

Parameters:

className - to return after compilation.

sources - to be compiled.

Returns:

the named class that is the result of the compilation.

Throws:

ClassNotFoundException - of the named class cannot be found.

compileOnDisk

public static Class<?> compileOnDisk(String className,
                                     Map<String,CharSequence> sources)
                              throws ClassNotFoundException,
                                     IOException

Compile a Map of source files on disk resulting in a Class which is named.

Parameters:

className - to return after compilation.

sources - to be compiled.

Returns:

the named class that is the result of the compilation.

Throws:

ClassNotFoundException - of the named class cannot be found.

IOException - if an error occurs when writing to disk.

compileAndLoad

public static Class<?> compileAndLoad(String className,
                                      DiagnosticCollector<JavaFileObject> diagnostics,
                                      JavaFileManager fileManager,
                                      JavaCompiler.CompilationTask task)
                               throws ClassNotFoundException

Compile and load a class.

Parameters:

className - name of the class to compile.

diagnostics - attached to the compilation task.

fileManager - to load compiled class from disk.

task - compilation task.

Returns:

Class for the compiled class or null if compilation fails.

Throws:

ClassNotFoundException - if compiled class was not loaded.

compile

public static boolean compile(DiagnosticCollector<JavaFileObject> diagnostics,
                              JavaCompiler.CompilationTask task)

Execute compilation task and report errors if it fails.

Parameters:

diagnostics - attached to the compilation task.

task - compilation to be executed.

Returns:

true if compilation succeeds.

persist

public static Collection<File> persist(Map<String,CharSequence> sources)
                                throws IOException

Persist source files to disc.

Parameters:

sources - to persist.

Returns:

a collection of File objects pointing to the persisted sources.

Throws:

IOException - in case of I/O errors.