org.eclipse.core.resources.team.IResourceTree Maven / Gradle / Ivy
Show all versions of aspectjtools Show documentation
/*******************************************************************************
* Copyright (c) 2000, 2008 IBM Corporation and others.
*
* This program and the accompanying materials
* are made available under the terms of the Eclipse Public License 2.0
* which accompanies this distribution, and is available at
* https://www.eclipse.org/legal/epl-2.0/
*
* SPDX-License-Identifier: EPL-2.0
*
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/
package org.eclipse.core.resources.team;
import org.eclipse.core.resources.*;
import org.eclipse.core.runtime.IProgressMonitor;
import org.eclipse.core.runtime.IStatus;
/**
* Provides internal access to the workspace resource tree for the purposes of
* implementing the move and delete operations. Implementations of
* IMoveDeleteHook
call these methods.
*
* @since 2.0
* @noimplement This interface is not intended to be implemented by clients.
*/
public interface IResourceTree {
/**
* Constant indicating that no file timestamp was supplied.
*
* @see #movedFile(IFile, IFile)
*/
long NULL_TIMESTAMP = 0L;
/**
* Adds the current state of the given file to the local history.
* Does nothing if the file does not exist in the workspace resource tree,
* or if it exists in the workspace resource tree but not in the local file
* system.
*
* This method is used to capture the state of a file in the workspace
* local history before it is overwritten or deleted.
*
*
* @param file the file to be captured
*/
void addToLocalHistory(IFile file);
/**
* Returns whether the given resource and its descendents to the given depth
* are considered to be in sync with the local file system. Returns
* false
if the given resource does not exist in the workspace
* resource tree, but exists in the local file system; and conversely.
*
* @param resource the resource of interest
* @param depth the depth (one of IResource.DEPTH_ZERO
,
* DEPTH_ONE
, or DEPTH_INFINITE
)
* @return true
if the resource is synchronized, and
* false
in all other cases
*/
boolean isSynchronized(IResource resource, int depth);
/**
* Computes the timestamp for the given file in the local file system.
* Returns NULL_TIMESTAMP
if the timestamp of the file in
* the local file system cannot be determined. The file need not exist in
* the workspace resource tree; however, if the file's project does not
* exist in the workspace resource tree, this method returns
* NULL_TIMESTAMP
because the project's local content area
* is indeterminate.
*
* Note that the timestamps used for workspace resource tree file
* synchronization are not necessarily interchangeable with
* java.io.File
last modification time.The ones computed by
* computeTimestamp
may have a higher resolution in some
* operating environments.
*
*
* @param file the file of interest
* @return the local file system timestamp for the file, or
* NULL_TIMESTAMP
if it could not be computed
*/
long computeTimestamp(IFile file);
/**
* Returns the timestamp for the given file as recorded in the workspace
* resource tree. Returns NULL_TIMESTAMP
if the given file
* does not exist in the workspace resource tree, or if the timestamp is
* not known.
*
* Note that the timestamps used for workspace resource tree file
* synchronization are not necessarily interchangeable with
* java.io.File
last modification time.The ones computed by
* computeTimestamp
may have a higher resolution in some
* operating environments.
*
*
* @param file the file of interest
* @return the workspace resource tree timestamp for the file, or
* NULL_TIMESTAMP
if the file does not exist in the
* workspace resource tree, or if the timestamp is not known
*/
long getTimestamp(IFile file);
/**
* Updates the timestamp for the given file in the workspace resource tree.
* The file is the local file system is not affected. Does nothing if the
* given file does not exist in the workspace resource tree.
*
* The given timestamp should be that of the corresponding file in the local
* file system (as computed by computeTimestamp
). A discrepancy
* between the timestamp of the file in the local file system and the
* timestamp recorded in the workspace resource tree means that the file is
* out of sync (isSynchronized
returns false
).
*
*
* This operation should be used after movedFile/Folder/Project
* to correct the workspace resource tree record when file timestamps change
* in the course of a move operation.
*
*
* Note that the timestamps used for workspace resource tree file
* synchronization are not necessarily interchangeable with
* java.io.File
last modification time.The ones computed by
* computeTimestamp
may have a higher resolution in some
* operating environments.
*
*
* @param file the file of interest
* @param timestamp the local file system timestamp for the file, or
* NULL_TIMESTAMP
if unknown
* @see #computeTimestamp(IFile)
*/
void updateMovedFileTimestamp(IFile file, long timestamp);
/**
* Declares that the operation has failed for the specified reason.
* This method may be called multiple times to report multiple
* failures. All reasons will be accumulated and taken into consideration
* when deciding the outcome of the hooked operation as a whole.
*
* @param reason the reason the operation (or sub-operation) failed
*/
void failed(IStatus reason);
/**
* Declares that the given file has been successfully deleted from the
* local file system, and requests that the corresponding deletion should
* now be made to the workspace resource tree. No action is taken if the
* given file does not exist in the workspace resource tree.
*
* This method clears out any markers, session properties, and persistent
* properties associated with the given file.
*
*
* @param file the file that was just deleted from the local file system
*/
void deletedFile(IFile file);
/**
* Declares that the given folder and all its descendents have been
* successfully deleted from the local file system, and requests that the
* corresponding deletion should now be made to the workspace resource tree.
* No action is taken if the given folder does not exist in the workspace
* resource tree.
*
* This method clears out any markers, session properties, and persistent
* properties associated with the given folder or its descendents.
*
*
* @param folder the folder that was just deleted from the local file system
*/
void deletedFolder(IFolder folder);
/**
* Declares that the given project's content area in the local file system
* has been successfully dealt with in an appropriate manner, and requests
* that the corresponding deletion should now be made to the workspace
* resource tree. No action is taken if the given project does not exist in
* the workspace resource tree.
*
* This method clears out everything associated with this project and any of
* its descendent resources, including: markers; session properties;
* persistent properties; local history; and project-specific plug-ins
* working data areas. The project's content area is not affected.
*
*
* @param project the project being deleted
*/
void deletedProject(IProject project);
/**
* Declares that the given source file has been successfully moved to the
* given destination in the local file system, and requests that the
* corresponding changes should now be made to the workspace resource tree.
* No action is taken if the given source file does not exist in the
* workspace resource tree.
*
* The destination file must not already exist in the workspace resource
* tree.
*
* This operation carries over the file timestamp unchanged. Use
* updateMovedFileTimestamp
to update the timestamp
* of the file if its timestamp changed as a direct consequence of the move.
*
*
* @param source the handle of the source file that was moved
* @param destination the handle of where the file moved to
* @see #computeTimestamp(IFile)
*/
void movedFile(IFile source, IFile destination);
/**
* Declares that the given source folder and its descendents have been
* successfully moved to the given destination in the local file system,
* and requests that the corresponding changes should now be made to the
* workspace resource tree for the folder and all its descendents. No action
* is taken if the given source folder does not exist in the workspace
* resource tree.
*
* This operation carries over file timestamps unchanged. Use
* updateMovedFileTimestamp
to update the timestamp of files
* whose timestamps changed as a direct consequence of the move.
*
* The destination folder must not already exist in the workspace resource
* tree.
*
*
* @param source the handle of the source folder that was moved
* @param destination the handle of where the folder moved to
*/
void movedFolderSubtree(IFolder source, IFolder destination);
/**
* Declares that the given source project and its files and folders have
* been successfully relocated in the local file system if required, and
* requests that the rename and/or relocation should now be made to the
* workspace resource tree for the project and all its descendents. No
* action is taken if the given project does not exist in the workspace
* resource tree.
*
* This operation carries over file timestamps unchanged. Use
* updateMovedFileTimestamp
to update the timestamp of files whose
* timestamps changed as a direct consequence of the move.
*
* If the project is being renamed, the destination project must not
* already exist in the workspace resource tree.
*
* Local history is not preserved if the project is renamed. It is preserved
* when the project's content area is relocated without renaming the
* project.
*
*
* @param source the handle of the source project that was moved
* @param description the new project description
* @return true
if the move succeeded, and false
* otherwise
*/
boolean movedProjectSubtree(IProject source, IProjectDescription description);
/**
* Deletes the given file in the standard manner from both the local file
* system and from the workspace resource tree.
*
* Implementations of IMoveDeleteHook
must invoke this method
* in lieu of file.delete(updateFlags, monitor)
because all
* regular API operations that modify resources are off limits.
*
* If the operation fails, the reason for the failure is automatically
* collected by an internal call to failed
.
*
*
* @param file the file to delete
* @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)
*/
void standardDeleteFile(IFile file, int updateFlags, IProgressMonitor monitor);
/**
* Deletes the given folder and its descendents in the standard manner from
* both the local file system and from the workspace resource tree.
*
* Implementations of IMoveDeleteHook
must invoke this method
* in lieu of folder.delete(updateFlags, monitor)
because all
* regular API operations that modify resources are off limits.
*
* If the operation fails, the reason for the failure is automatically
* collected by an internal call to failed
.
*
*
* @param folder the folder to delete
* @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)
*/
void standardDeleteFolder(IFolder folder, int updateFlags, IProgressMonitor monitor);
/**
* Deletes the given project and its descendents in the standard manner from
* both the local file system and from the workspace resource tree.
*
* Implementations of IMoveDeleteHook
must invoke this method
* in lieu of project.delete(updateFlags, monitor)
because all
* regular API operations that modify resources are off limits.
*
* If the operation fails, the reason for the failure is automatically
* collected by an internal call to failed
.
*
*
* @param project the project to delete
* @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)
*/
void standardDeleteProject(IProject project, int updateFlags, IProgressMonitor monitor);
/**
* Moves the given file in the standard manner from both the local file
* system and from the workspace resource tree.
*
* Implementations of IMoveDeleteHook
must invoke this method
* in lieu of source.move(destination.getProjectRelativePath(),
* updateFlags, monitor)
because all regular API operations that
* modify resources are off limits.
*
* If the operation fails, the reason for the failure is automatically
* collected by an internal call to failed
.
*
*
* @param source the handle of the source file to move
* @param destination the handle of where the file will move to
* @param updateFlags bit-wise or of update flag constants as per
* IResource.move(IPath,int,IProgressMonitor)
* @param monitor the progress monitor, or null
as per
* IResource.move(IPath,int,IProgressMonitor)
*/
void standardMoveFile(IFile source, IFile destination, int updateFlags, IProgressMonitor monitor);
/**
* Moves the given folder and its descendents in the standard manner from
* both the local file system and from the workspace resource tree.
*
* Implementations of IMoveDeleteHook
must invoke this method
* in lieu of source.move(destination.getProjectRelativePath(),
* updateFlags, monitor)
because all regular API operations that
* modify resources are off limits.
*
* If the operation fails, the reason for the failure is automatically
* collected by an internal call to failed
.
*
*
* @param source the handle of the source folder to move
* @param destination the handle of where the folder will move to
* @param updateFlags bit-wise or of update flag constants as per
* IResource.move(IPath,int,IProgressMonitor)
* @param monitor the progress monitor, or null
as per
* IResource.move(IPath,int,IProgressMonitor)
*/
void standardMoveFolder(IFolder source, IFolder destination, int updateFlags, IProgressMonitor monitor);
/**
* Renames and/or relocates the given project in the standard manner.
*
* Implementations of IMoveDeleteHook
must invoke this method
* in lieu of source.move(description, updateFlags, monitor)
* because all regular API operations that modify resources are off limits.
*
* If the operation fails, the reason for the failure is automatically
* collected by an internal call to failed
.
*
*
* @param source the handle of the source folder to move
* @param description the new project description
* @param updateFlags bit-wise or of update flag constants as per
* IResource.move(IPath,int,IProgressMonitor)
* @param monitor the progress monitor, or null
as per
* IResource.move(IPath,int,IProgressMonitor)
*/
void standardMoveProject(IProject source, IProjectDescription description, int updateFlags, IProgressMonitor monitor);
}