com.google.testing.compile

Class Compiler

java.lang.Object

com.google.testing.compile.Compiler

public abstract class Compiler
extends java.lang.Object

An object that can compile(javax.tools.JavaFileObject...) Java source files.

Constructor Summary

Constructors

Constructor and Description
Compiler()

Method Summary

Modifier and Type	Method and Description
Compilation	compile(java.lang.Iterable<? extends javax.tools.JavaFileObject> files) Compiles Java source files.
Compilation	compile(javax.tools.JavaFileObject... files) Compiles Java source files.
static Compiler	compiler(javax.tools.JavaCompiler javaCompiler) Returns a Compiler that uses a given JavaCompiler instance.
static Compiler	javac() Returns the javac compiler.
abstract com.google.common.collect.ImmutableList<java.lang.String>	options() The options passed to the compiler.
abstract com.google.common.collect.ImmutableList<javax.annotation.processing.Processor>	processors() The annotation processors applied during compilation.
Compiler	withClasspathFrom(java.lang.ClassLoader classloader) Uses the classpath from the passed on classloader (and its parents) for the compilation instead of the system classpath.
Compiler	withOptions(java.lang.Iterable<?> options) Passes command-line options to the compiler.
Compiler	withOptions(java.lang.Object... options) Passes command-line options to the compiler.
Compiler	withProcessors(java.lang.Iterable<? extends javax.annotation.processing.Processor> processors) Uses annotation processors during compilation.
Compiler	withProcessors(javax.annotation.processing.Processor... processors) Uses annotation processors during compilation.

Methods inherited from class java.lang.Object

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

Constructor Detail

Compiler

public Compiler()

Method Detail

javac

public static Compiler javac()

Returns the javac compiler.

compiler

public static Compiler compiler(javax.tools.JavaCompiler javaCompiler)

Returns a Compiler that uses a given JavaCompiler instance.

processors

public abstract com.google.common.collect.ImmutableList<javax.annotation.processing.Processor> processors()

The annotation processors applied during compilation.

options

public abstract com.google.common.collect.ImmutableList<java.lang.String> options()

The options passed to the compiler.

withProcessors

public final Compiler withProcessors(javax.annotation.processing.Processor... processors)

Uses annotation processors during compilation. These replace any previously specified.

Note that most annotation processors cannot be reused for more than one compilation.

Returns:

a new instance with the same options and the given processors

withProcessors

public final Compiler withProcessors(java.lang.Iterable<? extends javax.annotation.processing.Processor> processors)

Uses annotation processors during compilation. These replace any previously specified.

Note that most annotation processors cannot be reused for more than one compilation.

Returns:

a new instance with the same options and the given processors

withOptions

public final Compiler withOptions(java.lang.Object... options)

Passes command-line options to the compiler. These replace any previously specified.

Returns:

a new instance with the same processors and the given options

withOptions

public final Compiler withOptions(java.lang.Iterable<?> options)

Passes command-line options to the compiler. These replace any previously specified.

Returns:

a new instance with the same processors and the given options

withClasspathFrom

public final Compiler withClasspathFrom(java.lang.ClassLoader classloader)

Uses the classpath from the passed on classloader (and its parents) for the compilation instead of the system classpath.

Throws:

java.lang.IllegalArgumentException - if the given classloader had classpaths which we could not determine or use for compilation.

compile

public final Compilation compile(javax.tools.JavaFileObject... files)

Compiles Java source files.

Returns:

the results of the compilation

compile

public final Compilation compile(java.lang.Iterable<? extends javax.tools.JavaFileObject> files)

Compiles Java source files.

Returns:

the results of the compilation