com.google.testing.compile

Class Compiler

java.lang.Object

com.google.testing.compile.Compiler

public abstract class Compiler
extends 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
abstract Optional<com.google.common.collect.ImmutableList<File>>	classPath() The compilation class path.
Compilation	compile(Iterable<? extends JavaFileObject> files) Compiles Java source files.
Compilation	compile(JavaFileObject... files) Compiles Java source files.
static Compiler	compiler(JavaCompiler javaCompiler) Returns a Compiler that uses a given JavaCompiler instance.
static Compiler	javac() Returns the javac compiler.
abstract com.google.common.collect.ImmutableList<String>	options() The options passed to the compiler.
abstract com.google.common.collect.ImmutableList<Processor>	processors() The annotation processors applied during compilation.
Compiler	withClasspath(Iterable<File> classPath) Uses the given classpath for the compilation instead of the system classpath.
Compiler	withClasspathFrom(ClassLoader classloader) Deprecated. prefer withClasspath(Iterable). This method only supports URLClassLoader and the default system classloader, and Files are usually a more natural way to expression compilation classpaths than class loaders.
Compiler	withOptions(Iterable<?> options) Passes command-line options to the compiler.
Compiler	withOptions(Object... options) Passes command-line options to the compiler.
Compiler	withProcessors(Iterable<? extends Processor> processors) Uses annotation processors during compilation.
Compiler	withProcessors(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(JavaCompiler javaCompiler)

Returns a Compiler that uses a given JavaCompiler instance.

processors

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

The annotation processors applied during compilation.

options

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

The options passed to the compiler.

classPath

public abstract Optional<com.google.common.collect.ImmutableList<File>> classPath()

The compilation class path. If not present, the system class path is used.

withProcessors

public final Compiler withProcessors(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(Iterable<? extends 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(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(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

@Deprecated
public final Compiler withClasspathFrom(ClassLoader classloader)

Deprecated. prefer withClasspath(Iterable). This method only supports URLClassLoader and the default system classloader, and Files are usually a more natural way to expression compilation classpaths than class loaders.

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

Throws:

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

withClasspath

public final Compiler withClasspath(Iterable<File> classPath)

Uses the given classpath for the compilation instead of the system classpath.

compile

public final Compilation compile(JavaFileObject... files)

Compiles Java source files.

Returns:

the results of the compilation

compile

public final Compilation compile(Iterable<? extends JavaFileObject> files)

Compiles Java source files.

Returns:

the results of the compilation