org.netbeans.api.java.source
Class WorkingCopy

java.lang.Object
  org.netbeans.api.java.source.CompilationInfo
      org.netbeans.api.java.source.CompilationController
          org.netbeans.api.java.source.WorkingCopy

public class WorkingCopy
extends CompilationController

XXX: extends CompilationController now, finish method delegation

Method Summary

TreeMaker	getTreeMaker()
void	rewrite(Tree oldTree, Tree newTree) Replaces the original tree oldTree with the new one - newTree.
void	rewriteInComment(int start, int length, String newText) Replace a part of a comment token with the given text.
void	tag(Tree t, Object tag) Tags a tree.
JavaSource.Phase	toPhase(JavaSource.Phase phase) Moves the state to required phase.

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

getChangedTree, getClasspathInfo, getCompilationUnit, getDiagnostics, getDocument, getElements, getElementUtilities, getFileObject, getJavaSource, getPhase, getPositionConverter, getText, getTokenHierarchy, getTopLevelElements, getTrees, getTreeUtilities, getTypes, getTypeUtilities

Methods inherited from class java.lang.Object

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

Method Detail

toPhase

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

Description copied from class: CompilationController

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

Overrides:

toPhase in class CompilationController

Parameters:

phase - The required phase

Returns:

the reached state

Throws:

IOException - when the file cannot be red

getTreeMaker

public TreeMaker getTreeMaker()

rewrite

public void rewrite(Tree oldTree,
                    Tree newTree)

Replaces the original tree oldTree with the new one - newTree. null values are not allowed. Use methods in TreeMaker for tree element removal.

Parameters:

oldTree - tree to be replaced, use tree already represented in source code.

newTree - new tree, either created by TreeMaker or obtained from different place.

Throws:

IllegalStateException - if toPhase() method was not called before.

IllegalArgumentException - when null was passed to the method.

See Also:

TreeMaker

rewriteInComment

public void rewriteInComment(int start,
                             int length,
                             String newText)
                      throws IllegalArgumentException

Replace a part of a comment token with the given text. Please note that this is a special purpose method to handle eg. "Apply Rename in Comments" option in the Rename refactoring. It is caller's responsibility to ensure that replacements done by this method will not clash with replacements done by the general-purpose method rewrite(Tree,Tree).

Parameters:

start - absolute offset in the original text to start the replacement

length - how many characters should be deleted from the original text

newText - new text to be inserted at the specified offset

Throws:

IllegalArgumentException - when an attempt is made to replace non-comment text

Since:

0.23

tag

public void tag(Tree t,
                Object tag)

Tags a tree. Used in ModificationResult to determine position of tree inside document.

Parameters:

t - the tree to be tagged

tag - an Object used as tag

Since:

0.37