public class SyncProviderException extends SQLException
Indicates an error with the
SyncProvider mechanism. This exception is created by a
SyncProvider abstract 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
SyncProviderException 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
SyncResolver object. See the code fragment in the interface comment for
SyncResolver for an example. This
SyncResolver object will mirror the
RowSet 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
SyncResolver 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.
Creates a new
SyncProviderException object without a detail message.
public SyncProviderException(String msg)
SyncProviderException object with the specified detail message.
msg- the detail message
public SyncProviderException(SyncResolver syncResolver)
SyncProviderException object with the specified
SyncResolverinstance used to to process the synchronization conflicts
IllegalArgumentException- if the
public SyncResolver getSyncResolver()
SyncResolver object that has been set for this
SyncProviderException object, or if none has been set, an instance of the default
SyncResolver implementation included in the reference implementation.
SyncProviderException object is thrown, an application may use this method to generate a
SyncResolver object 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)
SyncResolver object for this
SyncProviderException object to the one supplied. If the argument supplied is
null, a call to the method
getSyncResolver will return the default reference implementation of the
SyncResolverobject to be set; cannot be
IllegalArgumentException- if the
© 1993–2017, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.