com.sun.tools.javac.main

Enum JavaCompiler.CompilePolicy

java.lang.Object

java.lang.Enum<JavaCompiler.CompilePolicy>

com.sun.tools.javac.main.JavaCompiler.CompilePolicy

All Implemented Interfaces:

Serializable, Comparable<JavaCompiler.CompilePolicy>

Enclosing class:

JavaCompiler

protected static enum JavaCompiler.CompilePolicy
extends Enum<JavaCompiler.CompilePolicy>

Control how the compiler's latter phases (attr, flow, desugar, generate) are connected. Each individual file is processed by each phase in turn, but with different compile policies, you can control the order in which each class is processed through its next phase.

Generally speaking, the compiler will "fail fast" in the face of errors, although not aggressively so. flow, desugar, etc become no-ops once any errors have occurred. No attempt is currently made to determine if it might be safe to process a class through its next phase because it does not depend on any unrelated errors that might have occurred.

Enum Constant Summary

Enum Constants

Enum Constant and Description
ATTR_ONLY Just attribute the parse trees.
BY_FILE Groups the classes for each source file together, then process each group in a manner equivalent to the SIMPLE policy.
BY_TODO Completely process each entry on the todo list in turn.
CHECK_ONLY Just attribute and do flow analysis on the parse trees.
SIMPLE Attribute everything, then do flow analysis for everything, then desugar everything, and only then generate output.

Method Summary

Modifier and Type	Method and Description
static JavaCompiler.CompilePolicy	valueOf(String name) Returns the enum constant of this type with the specified name.
static JavaCompiler.CompilePolicy[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

ATTR_ONLY

public static final JavaCompiler.CompilePolicy ATTR_ONLY

Just attribute the parse trees.

CHECK_ONLY

public static final JavaCompiler.CompilePolicy CHECK_ONLY

Just attribute and do flow analysis on the parse trees. This should catch most user errors.

SIMPLE

public static final JavaCompiler.CompilePolicy SIMPLE

Attribute everything, then do flow analysis for everything, then desugar everything, and only then generate output. This means no output will be generated if there are any errors in any classes.

BY_FILE

public static final JavaCompiler.CompilePolicy BY_FILE

Groups the classes for each source file together, then process each group in a manner equivalent to the SIMPLE policy. This means no output will be generated if there are any errors in any of the classes in a source file.

BY_TODO

public static final JavaCompiler.CompilePolicy BY_TODO

Completely process each entry on the todo list in turn. -- this is the same for 1.5. Means output might be generated for some classes in a compilation unit and not others.

Method Detail

values

public static JavaCompiler.CompilePolicy[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (JavaCompiler.CompilePolicy c : JavaCompiler.CompilePolicy.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static JavaCompiler.CompilePolicy valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null