IResource.delete(int,IProgressMonitor) where the receiver is a folder. Returns true to accept responsibility for implementing this operation as per the API contract. In broad terms, a full re-implementation should delete the directory tree in the local file system and then call tree.deletedFolder to complete the updating of the workspace resource tree to reflect this fact. If unsuccessful in deleting the directory or any of its descendents from the local file system, it should instead call tree.failed to report each reason for failure. In either case it should return true to indicate that the operation was attempted. The FORCE update flag needs to be honored: unless FORCE is specified, the implementation must use tree.isSynchronized to determine whether the folder subtree is in sync before attempting to delete it. The KEEP_HISTORY update flag needs to be honored as well; use tree.addToLocalHistory to capture the contents of any files being deleted.
A partial re-implementation should perform whatever pre-processing it needs to do and then call tree.standardDeleteFolder to explicitly invoke the standard folder deletion behavior, which deletes both the folder and its descendents from the local file system and updates the workspace resource tree. It should return true to indicate that the operation was attempted.
Returning false is the easy way for the implementation to say "pass". It is equivalent to calling tree.standardDeleteFolder and returning true.
The implementation of this method runs "below" the resources API and is therefore very restricted in what resource API method it can call. The list of useable methods includes most resource operations that read but do not update the resource tree; resource operations that modify resources and trigger deltas must not be called from within the dynamic scope of the invocation of this method.
@param tree the workspace resource tree; this object is only valid for the duration of the invocation of this method, and must not be used after this method has completed @param folder the handle of the folder to delete; the receiver ofIResource.delete(int,IProgressMonitor)
@param updateFlags bit-wise or of update flag constants as per IResource.delete(int,IProgressMonitor)
@param monitor the progress monitor, or null as per IResource.delete(int,IProgressMonitor)
@return false if this method declined to assume responsibility for this operation, and true if this method attempted to carry out the operation
@exception OperationCanceledException if the operation is canceled. Cancelation can occur even if no progress monitor is provided.
@see IResource#delete(int,IProgressMonitor)
| |