Eclipse JDT
Release 3.7

org.eclipse.jdt.ui.cleanup
Interface ICleanUp


public interface ICleanUp

A clean up solves problems in a compilation unit.

The clean up is asked for its requirements through a call to getRequirements(). The clean up can request an AST and define how to build this AST. It can base its requirements on the options passed through setOptions(CleanUpOptions).

A context containing the information requested by the requirements are passed to createFix(CleanUpContext). A fix capable of fixing the problems is returned by this function if checkPreConditions(IJavaProject, ICompilationUnit[], IProgressMonitor) has returned a non fatal error status.

At the end checkPostConditions(IProgressMonitor) is called.

Since:
3.5

Method Summary
 RefactoringStatus checkPostConditions(IProgressMonitor monitor)
          Called when done cleaning up.
 RefactoringStatus checkPreConditions(IJavaProject project, ICompilationUnit[] compilationUnits, IProgressMonitor monitor)
          After call to checkPreConditions clients will start creating fixes for compilationUnits in project unless the result of checkPreConditions contains a fatal error
 ICleanUpFix createFix(CleanUpContext context)
          Create an ICleanUpFix which fixes all problems in context or null if nothing to fix.
 CleanUpRequirements getRequirements()
          The requirements of this clean up.
 String[] getStepDescriptions()
          Human readable description for each step this clean up will execute.
 void setOptions(CleanUpOptions options)
          Sets the options that will be used.
 

Method Detail

setOptions

void setOptions(CleanUpOptions options)
Sets the options that will be used.

Parameters:
options - the options to use

getStepDescriptions

String[] getStepDescriptions()
Human readable description for each step this clean up will execute.

Note: This method must only be called after the options have been set.

Returns:
descriptions an array of strings or null

getRequirements

CleanUpRequirements getRequirements()
The requirements of this clean up.

Note: This method must only be called after the options have been set.

Returns:
the requirements used for createFix(CleanUpContext) to work

checkPreConditions

RefactoringStatus checkPreConditions(IJavaProject project,
                                     ICompilationUnit[] compilationUnits,
                                     IProgressMonitor monitor)
                                     throws CoreException
After call to checkPreConditions clients will start creating fixes for compilationUnits in project unless the result of checkPreConditions contains a fatal error

Parameters:
project - the project to clean up
compilationUnits - an array of compilation units to clean up, all member of project
monitor - the monitor to show progress
Returns:
the result of the precondition check
Throws:
CoreException - if an unexpected error occurred

createFix

ICleanUpFix createFix(CleanUpContext context)
                      throws CoreException
Create an ICleanUpFix which fixes all problems in context or null if nothing to fix.

Parameters:
context - a context containing all information requested by getRequirements()
Returns:
the fix for the problems or null if nothing to fix
Throws:
CoreException - if an unexpected error occurred

checkPostConditions

RefactoringStatus checkPostConditions(IProgressMonitor monitor)
                                      throws CoreException
Called when done cleaning up.

Parameters:
monitor - the monitor to show progress
Returns:
the result of the postcondition check, not null
Throws:
CoreException - if an unexpected error occurred

Eclipse JDT
Release 3.7

Guidelines for using Eclipse APIs.

Copyright (c) 2000, 2011 IBM Corporation and others. All rights reserved.