Refreshes the resource hierarchy from this resource and its children (to the specified depth) relative to the local file system. Creations, deletions, and changes detected in the local file system will be reflected in the workspace's resource tree. This resource need not exist or be local.
This method may discover changes to resources; any such changes will be reported in a subsequent resource change event.
If a new file or directory is discovered in the local file system at or below the location of this resource, any parent folders required to contain the new resource in the workspace will also be created automatically as required.
This method is long-running; progress and cancellation are provided by the given progress monitor.
@param depth valid values are
DEPTH_ZERO
,
DEPTH_ONE
, or
DEPTH_INFINITE
@param monitor a progress monitor, or
null
if progressreporting is not desired
@exception CoreException if this method fails. Reasons include:
- Resource changes are disallowed during certain types of resource change event notification. See
IResourceChangeEvent
for more details.
@exception OperationCanceledException if the operation is canceled. Cancelation can occur even if no progress monitor is provided.
@see IResource#DEPTH_ZERO
@see IResource#DEPTH_ONE
@see IResource#DEPTH_INFINITE
@see IResourceRuleFactory#refreshRule(IResource)