org.rococoa.cocoa.syncservices
Class SyncServicesLibrary.ISyncSessionCancelledException

java.lang.Object
  org.rococoa.cocoa.syncservices.SyncServicesLibrary.ISyncSessionCancelledException

Enclosing interface:

SyncServicesLibrary

public static final class SyncServicesLibrary.ISyncSessionCancelledException
extends Object

This exception may be thrown from any instance method on ISyncSession. It indicates that the sync
session has been cancelled, either directly on the session using -cancelSyncing or externally by
someone else.
If a sync is cancelled during the negotiate phase, the negotiations simply fail and
+beginSessionWithClient:entityNames:beforeDate:(NSDate *)date returns nil.
If a sync is cancelled during the push phase, no further changes from the client will be accepted. The
changes that have been accepted will be discarded. If a client cannot provide those changes on a
subsequent sync, it must force a slow sync. The client cannot proceed to the mingle and pull
phases.
If a sync is cancelled during the mingle phase (ie. the exception is thrown from
-prepareToPullChangesForEntityNames:beforeDate:), the changes that have been accepted from the
client will be discarded. If a client cannot provide those changes on a subsequent sync, it must
force a slow sync. The client cannot proceed to the pull phase.
If a sync is cancelled during the pull phase, the changes that have not been accepted or rejected by
the client and explicitly committed (using -clientCommittedAcceptedChanges) will be given to the
client again on a subsequent sync. After a cancellation, a client may continue to accept or reject
the changes it received prior to the cancellation; it may invoke -clientCommittedAcceptedChanges to
indicate its acceptance of these changes; and it may use -clientChangedRecordIdentifiers: to update
the client Ids. It will not be given any further changes, however.

Nested Class Summary

static class

SyncServicesLibrary.ISyncSessionCancelledException.ISyncSessionCancelledException_holder

Constructor Summary

SyncServicesLibrary.ISyncSessionCancelledException()

Method Summary

static SyncServicesLibrary.ISyncSessionCancelledException.ISyncSessionCancelledException_holder

get()

Methods inherited from class java.lang.Object

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

Constructor Detail

SyncServicesLibrary.ISyncSessionCancelledException

public SyncServicesLibrary.ISyncSessionCancelledException()

Method Detail

get

public static SyncServicesLibrary.ISyncSessionCancelledException.ISyncSessionCancelledException_holder get()