cz.ues.platform.apt.compiler

Class JavaCompilerHelper

java.lang.Object

cz.ues.platform.apt.compiler.JavaCompilerHelper

public class JavaCompilerHelper
extends java.lang.Object

This class simplifies the execution of Java Compiler from java code. It may be used in situations like testing and debugging APT processors, or from application code.

Since:

UES6-00

Field Summary

Fields

Modifier and Type	Field and Description
private static SimpleLogger	LOG
private static java.lang.String	MSG_NO_SOURCE_FOUND Error message (Found no source to compile.)
static java.lang.String	SOURCE_CHARSET

Constructor Summary

Constructors

Constructor and Description
JavaCompilerHelper()

Method Summary

Methods

Modifier and Type	Method and Description
static java.lang.Iterable<java.lang.Class<? extends javax.annotation.processing.Processor>>	asAPTList(java.lang.Class<? extends javax.annotation.processing.Processor>... proc)
static JavaCompilerResult	compile(java.lang.Iterable<java.lang.String> classes, java.lang.Iterable<javax.tools.JavaFileObject> sources, java.lang.Iterable<java.lang.Class<? extends javax.annotation.processing.Processor>> aptProcessors, java.lang.Iterable<java.lang.String> options)
static JavaCompilerResult	compile(java.lang.String packageName, java.lang.Iterable<java.lang.Class<? extends javax.annotation.processing.Processor>> aptProcessors, java.lang.Iterable<java.lang.String> options)
private static JavaCompilerResult	compile(java.lang.String packageName, java.lang.Iterable<java.lang.String> classes, java.lang.Iterable<javax.tools.JavaFileObject> sources, java.lang.Iterable<java.lang.Class<? extends javax.annotation.processing.Processor>> aptProcessors, java.lang.Iterable<java.lang.String> options, JavaCompilerResult result)
private static java.lang.Iterable<java.lang.String>	getClassesToBeCompiled(java.lang.String packageName, javax.tools.DiagnosticListener<? super javax.tools.JavaFileObject> diagnosticListener, java.lang.Iterable<java.lang.String> options)
private static java.lang.Iterable<javax.tools.JavaFileObject>	getSourcesToBeCompiled(java.lang.String packageName, javax.tools.DiagnosticListener<? super javax.tools.JavaFileObject> diagnosticListener, java.lang.Iterable<java.lang.String> options)
protected static void	initDirs(java.util.Map<java.lang.String,java.lang.String> options) Initializes directories for generated resources.
private static void	printJavacOptions(java.lang.Iterable<java.lang.String> options, java.lang.Iterable<java.lang.Class<? extends javax.annotation.processing.Processor>> aptProcessors, java.lang.String packagePrefix, java.lang.Iterable<java.lang.String> classes, java.lang.Iterable<javax.tools.JavaFileObject> sources) TODO Javadoc for method printJavacOptions.
private static void	setAPTProcessors(javax.tools.JavaCompiler.CompilationTask task, java.lang.Iterable<java.lang.Class<? extends javax.annotation.processing.Processor>> aptProcessors) Associates the APT processors with compilation task.

Methods inherited from class java.lang.Object

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

Field Detail

MSG_NO_SOURCE_FOUND

private static final MSG_NO_SOURCE_FOUND

Error message (Found no source to compile.)

See Also:

Constant Field Values

LOG

private static final LOG

SOURCE_CHARSET

public static final SOURCE_CHARSET

See Also:

Constant Field Values

Constructor Detail

JavaCompilerHelper

public JavaCompilerHelper()

Method Detail

compile

public static JavaCompilerResult compile(java.lang.String packageName,
java.lang.Iterable<java.lang.Class<? extends javax.annotation.processing.Processor>> aptProcessors,
java.lang.Iterable<java.lang.String> options)

compile

public static JavaCompilerResult compile(java.lang.Iterable<java.lang.String> classes,
java.lang.Iterable<javax.tools.JavaFileObject> sources,
java.lang.Iterable<java.lang.Class<? extends javax.annotation.processing.Processor>> aptProcessors,
java.lang.Iterable<java.lang.String> options)

compile

private static JavaCompilerResult compile(java.lang.String packageName,
java.lang.Iterable<java.lang.String> classes,
java.lang.Iterable<javax.tools.JavaFileObject> sources,
java.lang.Iterable<java.lang.Class<? extends javax.annotation.processing.Processor>> aptProcessors,
java.lang.Iterable<java.lang.String> options,
JavaCompilerResult result)

initDirs

protected static void initDirs(java.util.Map<java.lang.String,java.lang.String> options)

Initializes directories for generated resources. This method was implemented because by default the APT processors throws errors, when configured directories does not exist.

Parameters:

options - Options passed to processing. This method for example process the "-s" option to check existence of output directory for source files.

Since:

UES6-00

printJavacOptions

private static void printJavacOptions(java.lang.Iterable<java.lang.String> options,
java.lang.Iterable<java.lang.Class<? extends javax.annotation.processing.Processor>> aptProcessors,
java.lang.String packagePrefix,
java.lang.Iterable<java.lang.String> classes,
java.lang.Iterable<javax.tools.JavaFileObject> sources)

TODO Javadoc for method printJavacOptions.

Parameters:

sources -

classes -

aptProcessors -

aOptions -

Since:

UES6-00

getSourcesToBeCompiled

private static java.lang.Iterable<javax.tools.JavaFileObject> getSourcesToBeCompiled(java.lang.String packageName,
javax.tools.DiagnosticListener<? super javax.tools.JavaFileObject> diagnosticListener,
java.lang.Iterable<java.lang.String> options)

Parameters:

packageName -

fileManager -

Returns:

Throws:

java.io.IOException

Since:

UES6-00

getClassesToBeCompiled

private static java.lang.Iterable<java.lang.String> getClassesToBeCompiled(java.lang.String packageName,
javax.tools.DiagnosticListener<? super javax.tools.JavaFileObject> diagnosticListener,
java.lang.Iterable<java.lang.String> options)

setAPTProcessors

private static void setAPTProcessors(javax.tools.JavaCompiler.CompilationTask task,
java.lang.Iterable<java.lang.Class<? extends javax.annotation.processing.Processor>> aptProcessors)

Associates the APT processors with compilation task.

Parameters:

aTask - Task to be initialized by APT processers.

aAptProcessors - The set of processors to be associated with compilation task.

Since:

UES6-00

asAPTList

public static java.lang.Iterable<java.lang.Class<? extends javax.annotation.processing.Processor>> asAPTList(java.lang.Class<? extends javax.annotation.processing.Processor>... proc)