public class SyncProviderException extends SQLException
SyncProvidermechanism. This exception is created by a
SyncProviderabstract class extension if it encounters violations in reading from or writing to the originating data source.
If it is implemented to do so, the
SyncProvider object may also create a
SyncResolver object and either initialize the
object with it at construction time or set it with the
SyncProvider object at
a later time.
acceptChanges will throw this exception after the writer
has finished checking for conflicts and has found one or more conflicts. An
application may catch a
SyncProviderException object and call its
getSyncResolver method to get its
See the code fragment in the interface comment for
SyncResolver for an example.
SyncResolver object will mirror the
object that generated the exception, except that it will contain only the values
from the data source that are in conflict. All other values in the
object will be
SyncResolver object may be used to examine and resolve
each conflict in a row and then go to the next row with a conflict to
repeat the procedure.
SyncProviderException object may or may not contain a description of the
condition causing the exception. The inherited method
getMessage may be
called to retrieve the description if there is one.
|Constructor and Description|
Creates a new
|Modifier and Type||Method and Description|
getErrorCode, getNextException, getSQLState, iterator, setNextException
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
SyncProviderExceptionobject without a detail message.
public SyncProviderException(String msg)
SyncProviderExceptionobject with the specified detail message.
msg- the detail message
public SyncProviderException(SyncResolver syncResolver)
SyncProviderExceptionobject with the specified
SyncResolverinstance used to to process the synchronization conflicts
IllegalArgumentException- if the
public SyncResolver getSyncResolver()
SyncResolverobject that has been set for this
SyncProviderExceptionobject, or if none has been set, an instance of the default
SyncResolverimplementation included in the reference implementation.
SyncProviderException object is thrown, an application
may use this method to generate a
with which to resolve the conflict or conflicts that caused the
exception to be thrown.
SyncResolverobject set for this
SyncProviderExceptionobject or, if none has been set, an instance of the default
SyncResolverimplementation. In addition, the default
SyncResolverimplementation is also returned if the
SyncResolver(String)constructors are used to instantiate the
public void setSyncResolver(SyncResolver syncResolver)
SyncResolverobject for this
SyncProviderExceptionobject to the one supplied. If the argument supplied is
null, a call to the method
getSyncResolverwill return the default reference implementation of the