org.eclipse.core.internal.resources
Class SavedState

java.lang.Object
  org.eclipse.core.internal.resources.SavedState

All Implemented Interfaces:

ISavedState

public class SavedState
extends java.lang.Object
implements ISavedState

Standard implementation of the ISavedState interface.

Method Summary

org.eclipse.core.runtime.IPath[]	getFiles() Returns the files mapped with the ISaveContext.map(IPath, IPath) facility.
int	getSaveNumber() Returns the save number for the save participant.
org.eclipse.core.runtime.IPath	lookup(org.eclipse.core.runtime.IPath file) Returns the mapped location associated with the given path or null if none.
void	processResourceChangeEvents(IResourceChangeListener listener) Used to receive notification of changes that might have happened while this plug-in was not active.

Methods inherited from class java.lang.Object

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

Method Detail

getSaveNumber

public int getSaveNumber()

Description copied from interface: ISavedState

Returns the save number for the save participant. This is the save number of the last successful save in which the plug-in actively participated, or 0 if the plug-in has never actively participated in a successful save.

Specified by:

getSaveNumber in interface ISavedState

Returns:

the save number

lookup

public org.eclipse.core.runtime.IPath lookup(org.eclipse.core.runtime.IPath file)

Description copied from interface: ISavedState

Returns the mapped location associated with the given path or null if none.

Specified by:

lookup in interface ISavedState

Returns:

the mapped location of a given path

See Also:

ISavedState.getFiles(), ISaveContext.map(IPath, IPath)

getFiles

public org.eclipse.core.runtime.IPath[] getFiles()

Description copied from interface: ISavedState

Returns the files mapped with the ISaveContext.map(IPath, IPath) facility. Returns an empty array if there are no mapped files.

Specified by:

getFiles in interface ISavedState

Returns:

the files currently mapped by the participant

See Also:

ISavedState.lookup(IPath), ISaveContext.map(IPath, IPath)

processResourceChangeEvents

public void processResourceChangeEvents(IResourceChangeListener listener)

Description copied from interface: ISavedState

Used to receive notification of changes that might have happened while this plug-in was not active. The listener receives notifications of changes to the workspace resource tree since the time this state was saved. After this method is run, the delta is forgotten. Subsequent calls to this method will have no effect.

No notification is received in the following cases:

• if a saved state was never recorded (ISaveContext.needDelta() was not called)
• a saved state has since been forgotten (using IWorkspace.forgetSavedTree(String))
• a saved state has been deemed too old or has become invalid

All clients should have a contingency plan in place in case a changes are not available (the case should be very similar to the first time a plug-in is activated, and only has the current state of the workspace to work from).

The supplied event is of type IResourceChangeEvent.POST_BUILD and contains the delta detailing changes since this plug-in last participated in a save. This event object (and the resource delta within it) is valid only for the duration of the invocation of this method.

Specified by:

processResourceChangeEvents in interface ISavedState

Parameters:

listener - the listener

See Also:

ISaveContext.needDelta(), IResourceChangeListener