Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Mail Systems
Eclipse Documentation

How To Guides
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Problem Solutions
Privacy Policy




Eclipse Plug-in Developer Guide
Previous Page Home Next Page

Eclipse Platform
Release 3.5


Application programming interfaces for managing synchronization state.


Interface Summary
ISyncInfoSetChangeEvent An event generated when a SyncInfoSet collection is changed.
ISyncInfoSetChangeListener Classes which implement this interface provide methods that deal with the change events that are generated by a SyncInfoSet.
ISyncInfoTreeChangeEvent This is a change event that provides access to changes in subtrees that contain the out-of-sync resources.

Class Summary
FastSyncInfoFilter A specialized SyncInfoFilter that does not require a progress monitor.
FastSyncInfoFilter.AndSyncInfoFilter Selects SyncInfo which match all child filters.
FastSyncInfoFilter.AutomergableFilter Selects SyncInfo instances that are auto-mergable.
FastSyncInfoFilter.CompoundSyncInfoFilter An abstract class which contains a set of FastSyncInfoFilter instances.
FastSyncInfoFilter.OrSyncInfoFilter Selects SyncInfo that match any of the child filters.
FastSyncInfoFilter.PseudoConflictFilter Selects SyncInfo instances that are pseudo-conflicts.
FastSyncInfoFilter.SyncInfoChangeTypeFilter Selects SyncInfo whose change type match those of the filter.
FastSyncInfoFilter.SyncInfoDirectionFilter Selects SyncInfo whose change direction match those of the filter.
SyncInfo Describes the synchronization of a local resource relative to a remote resource variant.
SyncInfoFilter A SyncInfoFilter tests a SyncInfo for inclusion, typically in a SyncInfoSet.
SyncInfoFilter.ContentComparisonSyncInfoFilter Selects SyncInfo whose local and remote contents match.
SyncInfoSet A dynamic collection of SyncInfo objects that provides change notification to registered listeners.
SyncInfoSetChangeEvent This event keeps track of the changes in a SyncInfoSet
SyncInfoTree Provides addition API for accessing the SyncInfo in the set through their resource's hierarchical relationships.

Package Description

Application programming interfaces for managing synchronization state.

Package Specification

This package specifies the API for managing the synchronization state between the local workspace resources and a corresponding variants of those resources. The classes in this package can be used by Subscribers (see the package) or others. The classes are roughly divided into three categories:

  • describing the synchronization state of a one or more resources,
  • notifying interested parties of changes in the synchronization state.
  • filtering a set of resource based on a sync state criteria

Describing the synchronization state of resources

The following classes are provided to accumulate (and possibly filter) the synchronization state of one or more resources.

  • SyncInfo: node which maps a local resource to a corresponding variant resource (and a base resource for three-way compare) and descibes the synchronization state of those resources (e.g. in-sync or incoming-change).
  • SyncInfoSet: a set which contains the out-of-sync SyncInfo for multiple local resources.
  • SyncInfoTree: a specialized set optimized for hierarchical resource based access (e.g. to obtain all out-of-sync children of a particular local resource).

Notifying interested parties of sync info set changes

Interested parties can register with a SyncInfoSet in order to receive notification when a set changes.

  • ISyncInfoSetChangeListener: implementors of this interface can be registered with a SyncInfoSet in order to recieve notification when the contents of the set change.
  • ISyncInfoSetChangeEvent: the type of the events generated by a SyncInfoSet
  • ISyncInfoTreeChangeEvent: specialized ISyncInfoSetChangeEvent generated by SyncInfoTree which includes notification of resource subtree aditions and removals.

Sync info filtering

There are also some additional classes provided to help manage SyncInfoSets

  • SyncInfoFilter: a filter that can be used to test SyncInfo. Long running tests are supported via an IProgressMonitor. SyncInfoSet has API for selecting and rejecting SyncInfo based on a provided filter.
  • FastSyncInfoFilter: a specialized filter that does not support the ue of a progress monitor

Several common filters are provided as inner classes of the two filter classes for doing synchronization state tests and filter compounding (and, or, not).


Eclipse Platform
Release 3.5

Guidelines for using Eclipse APIs.

Copyright (c) Eclipse contributors and others 2000, 2008. All rights reserved.

  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire