org.netbeans.api.java.source

Class CompilationController

java.lang.Object

org.netbeans.api.java.source.CompilationInfo

org.netbeans.api.java.source.CompilationController

Direct Known Subclasses:

WorkingCopy

public class CompilationController
extends CompilationInfo

Class for explicit invocation of compilation phases on a java source. The implementation delegates to the CompilationInfo to get the data, the access to CompilationInfo is not synchronized, so the class isn't reentrant. XXX: make toPhase automatic in getTrees(), Trees.getElement, etc....

Nested Class Summary

Nested classes/interfaces inherited from class org.netbeans.api.java.source.CompilationInfo

CompilationInfo.CacheClearPolicy

Method Summary

Modifier and Type	Method and Description
protected void	doInvalidate() Marks this CompilationInfo as invalid, may be used to verify confinement.
static CompilationController	get(Parser.Result result) Returns an instance of the CompilationController for given Parser.Result if it is a result of a java parser.
JavaSource.Phase	toPhase(JavaSource.Phase phase) Moves the state to required phase.

Methods inherited from class org.netbeans.api.java.source.CompilationInfo

getCachedValue, getChangedTree, getClasspathInfo, getCompilationUnit, getDiagnostics, getDocTrees, getDocument, getElements, getElementUtilities, getFileObject, getJavaSource, getPhase, getPositionConverter, getSnapshot, getSourceVersion, getText, getTokenHierarchy, getTopLevelElements, getTrees, getTreeUtilities, getTypes, getTypeUtilities, putCachedValue

Methods inherited from class java.lang.Object

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

Method Detail

get

@NullUnknown
public static CompilationController get(@NonNull
                                                     Parser.Result result)

Returns an instance of the CompilationController for given Parser.Result if it is a result of a java parser.

Parameters:

result - for which the CompilationController should be returned.

Returns:

a CompilationController or null when the given result is not a result of java parsing.

Since:

0.42

toPhase

@NonNull
public JavaSource.Phase toPhase(@NonNull
                                         JavaSource.Phase phase)
                                  throws IOException

Moves the state to required phase. If given state was already reached the state is not changed. The method will throw exception if a state is illegal required. Acceptable parameters for thid method are

org.netbeans.api.java.source.JavaSource.Phase.PARSED org.netbeans.api.java.source.JavaSource.Phase.ELEMENTS_RESOLVED org.netbeans.api.java.source.JavaSource.Phase.RESOLVED org.netbeans.api.java.source.JavaSource.Phase.UP_TO_DATE

Parameters:

phase - The required phase

Returns:

the reached state

Throws:

IllegalArgumentException - in case that given state can not be reached using this method

IOException - when the file cannot be red

doInvalidate

protected void doInvalidate()

Marks this CompilationInfo as invalid, may be used to verify confinement.

Overrides:

doInvalidate in class CompilationInfo