Eclipse JDT
2.1

org.eclipse.jdt.ui.refactoring
Class RenameSupport

java.lang.Object
  |
  +--org.eclipse.jdt.ui.refactoring.RenameSupport

public class RenameSupport
extends Object

Central access point to execute rename refactorings.

Since:
2.1

Field Summary
static int NONE
          Flag indication that no additional update is to be performed.
static int UPDATE_GETTER_METHOD
          Flag indicating that the getter method is to be updated as well.
static int UPDATE_JAVADOC_COMMENTS
          Flag indicating that Java doc comments are to be updated as well.
static int UPDATE_REFERENCES
          Flag indicating that references are to be updated as well.
static int UPDATE_REGULAR_COMMENTS
          Flag indicating that regular comments are to be updated as well.
static int UPDATE_SETTER_METHOD
          Flag indicating that the setter method is to be updated as well.
static int UPDATE_STRING_LITERALS
          Flag indicating that string literals are to be updated as well.
 
Method Summary
static RenameSupport create(ICompilationUnit unit, String newName, int flags)
          Creates a new rename support for the given ICompilationUnit.
static RenameSupport create(IField field, String newName, int flags)
          Creates a new rename support for the given IField.
static RenameSupport create(IJavaProject project, String newName, int flags)
          Creates a new rename support for the given IJavaProject.
static RenameSupport create(IMethod method, String newName, int flags)
          Creates a new rename support for the given IMethod.
static RenameSupport create(IPackageFragmentRoot root, String newName)
          Creates a new rename support for the given IPackageFragmentRoot.
static RenameSupport create(IPackageFragment fragment, String newName, int flags)
          Creates a new rename support for the given IPackageFragment.
static RenameSupport create(IType type, String newName, int flags)
          Creates a new rename support for the given IType.
 void openDialog(Shell parent)
          Opens the refactoring dialog for this rename support.
 void perform(Shell parent, IRunnableContext context)
          Executes the rename refactoring without showing a dialog to gather additional user input (for example the new name of the IJavaElement).
 IStatus preCheck()
          Executes some light weight precondition checking.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

NONE

public static final int NONE
Flag indication that no additional update is to be performed.

UPDATE_REFERENCES

public static final int UPDATE_REFERENCES
Flag indicating that references are to be updated as well.

UPDATE_JAVADOC_COMMENTS

public static final int UPDATE_JAVADOC_COMMENTS
Flag indicating that Java doc comments are to be updated as well.

UPDATE_REGULAR_COMMENTS

public static final int UPDATE_REGULAR_COMMENTS
Flag indicating that regular comments are to be updated as well.

UPDATE_STRING_LITERALS

public static final int UPDATE_STRING_LITERALS
Flag indicating that string literals are to be updated as well.

UPDATE_GETTER_METHOD

public static final int UPDATE_GETTER_METHOD
Flag indicating that the getter method is to be updated as well.

UPDATE_SETTER_METHOD

public static final int UPDATE_SETTER_METHOD
Flag indicating that the setter method is to be updated as well.
Method Detail

preCheck

public IStatus preCheck()
                 throws CoreException
Executes some light weight precondition checking. If the returned status is an error then the refactoring can't be executed at all. However, returning an OK status doesn't guarantee that the refactoring can be executed. It may still fail while performing the exhaustive precondition checking done inside the methods openDialog or perform. The method is mainly used to determine enable/disablement of actions.
Returns:
the result of the light weight precondition checking.
Throws:
if - an unexpected exception occurs while performing the checking.
See Also:
openDialog(Shell), perform(Shell, IRunnableContext)

openDialog

public void openDialog(Shell parent)
                throws CoreException
Opens the refactoring dialog for this rename support.
Parameters:
parent - a shell used as a parent for the refactoring dialog.
Throws:
CoreException - if an unexpected exception occurs while opening the dialog.

perform

public void perform(Shell parent,
                    IRunnableContext context)
             throws InterruptedException,
                    InvocationTargetException
Executes the rename refactoring without showing a dialog to gather additional user input (for example the new name of the IJavaElement). Only an error dialog is shown (if necessary) to present the result of the refactoring's full precondition checking.
Parameters:
parent - a shell used as a parent for the error dialog.
context - a IRunnableContext to execute the operation.
Throws:
InterruptedException - if the operation has been canceled by the user.
InvocationTargetException - if an error occured while executing the operation.
See Also:
openDialog(Shell), IRunnableContext.run(boolean, boolean, org.eclipse.jface.operation.IRunnableWithProgress)

create

public static RenameSupport create(IJavaProject project,
                                   String newName,
                                   int flags)
                            throws CoreException
Creates a new rename support for the given IJavaProject.
Parameters:
project - the IJavaProject to be renamed.
newName - the project's new name. null is a valid value indicating that no new name is provided.
flags - flags controlling additional parameters. Valid flags are UPDATE_REFERENCES or NONE.
Returns:
the RenameSupport.
Throws:
CoreException - if an unexpected error occured while creating the RenameSupport.

create

public static RenameSupport create(IPackageFragmentRoot root,
                                   String newName)
                            throws CoreException
Creates a new rename support for the given IPackageFragmentRoot.
Parameters:
root - the IPackageFragmentRoot to be renamed.
newName - the package fragment roor's new name. null is a valid value indicating that no new name is provided.
Returns:
the RenameSupport.
Throws:
CoreException - if an unexpected error occured while creating the RenameSupport.

create

public static RenameSupport create(IPackageFragment fragment,
                                   String newName,
                                   int flags)
                            throws CoreException
Creates a new rename support for the given IPackageFragment.
Parameters:
fragment - the IPackageFragment to be renamed.
newName - the package fragement's new name. null is a valid value indicating that no new name is provided.
flags - flags controlling additional parameters. Valid flags are UPDATE_REFERENCES, UPDATE_JAVADOC_COMMENTS, UPDATE_REGULAR_COMMENTS and UPDATE_STRING_LITERALS, or their bitwise OR, or NONE.
Returns:
the RenameSupport.
Throws:
CoreException - if an unexpected error occured while creating the RenameSupport.

create

public static RenameSupport create(ICompilationUnit unit,
                                   String newName,
                                   int flags)
                            throws CoreException
Creates a new rename support for the given ICompilationUnit.
Parameters:
unit - the ICompilationUnit to be renamed.
newName - the compilation unit's new name. null is a valid value indicating that no new name is provided.
flags - flags controlling additional parameters. Valid flags are UPDATE_REFERENCES, UPDATE_JAVADOC_COMMENTS, UPDATE_REGULAR_COMMENTS and UPDATE_STRING_LITERALS, or their bitwise OR, or NONE.
Returns:
the RenameSupport.
Throws:
CoreException - if an unexpected error occured while creating the RenameSupport.

create

public static RenameSupport create(IType type,
                                   String newName,
                                   int flags)
                            throws CoreException
Creates a new rename support for the given IType.
Parameters:
type - the IType to be renamed.
newName - the type's new name. null is a valid value indicating that no new name is provided.
flags - flags controlling additional parameters. Valid flags are UPDATE_REFERENCES, UPDATE_JAVADOC_COMMENTS, UPDATE_REGULAR_COMMENTS and UPDATE_STRING_LITERALS, or their bitwise OR, or NONE.
Returns:
the RenameSupport.
Throws:
CoreException - if an unexpected error occured while creating the RenameSupport.

create

public static RenameSupport create(IMethod method,
                                   String newName,
                                   int flags)
                            throws CoreException
Creates a new rename support for the given IMethod.
Parameters:
method - the IMethod to be renamed.
newName - the method's new name. null is a valid value indicating that no new name is provided.
flags - flags controlling additional parameters. Valid flags are UPDATE_REFERENCES or NONE.
Returns:
the RenameSupport.
Throws:
CoreException - if an unexpected error occured while creating the RenameSupport.

create

public static RenameSupport create(IField field,
                                   String newName,
                                   int flags)
                            throws CoreException
Creates a new rename support for the given IField.
Parameters:
method - the IField to be renamed.
newName - the field's new name. null is a valid value indicating that no new name is provided.
flags - flags controlling additional parameters. Valid flags are UPDATE_REFERENCES, UPDATE_JAVADOC_COMMENTS, UPDATE_REGULAR_COMMENTS, UPDATE_STRING_LITERALS, UPDATE_GETTER_METHOD and UPDATE_SETTER_METHOD, or their bitwise OR, or NONE.
Returns:
the RenameSupport.
Throws:
CoreException - if an unexpected error occured while creating the RenameSupport.

Eclipse JDT
2.1

Copyright (c) IBM Corp. and others 2000, 2003. All Rights Reserved.