Класс SyncProviderException

public class SyncProviderException
extends SQLException

Указывает на ошибку в механизме SyncProvider. Данное исключение создается расширением абстрактного класса SyncProvider, если оно обнаруживает нарушения при чтении или записи в исходный источник данных.

Если это реализовано, объект SyncProvider может также создать объект SyncResolver и либо инициализировать объект SyncProviderException им во время создания, либо установить его в объекте SyncProvider в более позднее время.

Метод acceptChanges выбросит это исключение после того, как писатель закончит проверку на конфликты и обнаружит один или несколько конфликтов. Приложение может перехватить объект SyncProviderException и вызвать его метод getSyncResolver, чтобы получить его объект SyncResolver. См. фрагмент кода в комментарии к интерфейсу SyncResolver для примера. Этот объект SyncResolver будет отражать объект RowSet, который сгенерировал исключение, за исключением того, что он будет содержать только те значения из источника данных, которые находятся в конфликте. Все остальные значения в объекте SyncResolver будут null.

Объект SyncResolver может быть использован для проверки и разрешения каждого конфликта по очереди, а затем переходить к следующей строке с конфликтом, чтобы повторить процедуру.

Объект SyncProviderException может или может не содержать описание условия, вызвавшего исключение. Наследованный метод getMessage может быть вызван для получения описания, если оно есть.

Конструкторы

SyncProviderException

public SyncProviderException()

Создает новый объект SyncProviderException без сообщения об ошибке.

SyncProviderException

public SyncProviderException(String msg)

Создает объект SyncProviderException с указанным сообщением об ошибке.

Параметры:

msg - сообщение об ошибке

SyncProviderException

public SyncProviderException(SyncResolver syncResolver)

Создает объект SyncProviderException с указанным экземпляром SyncResolver.

Параметры:

syncResolver - экземпляр SyncResolver, используемый для обработки конфликтов синхронизации

Исключения:

IllegalArgumentException - если объект SyncResolver является null.

Методы

getSyncResolver

public SyncResolver getSyncResolver()

Возвращает:

объект SyncResolver, установленный для данного объекта SyncProviderException, или, если он не установлен, экземпляр по умолчанию реализации SyncResolver в эталонной реализации. Кроме того, по умолчанию возвращается реализация SyncResolver, если конструкторы SyncResolver() или SyncResolver(String) используются для создания экземпляра SyncResolver.

setSyncResolver

public void setSyncResolver(SyncResolver syncResolver)

Устанавливает объект SyncResolver для этого объекта SyncProviderException на предоставленный. Если переданный аргумент null, вызов метода getSyncResolver вернёт реализацию по умолчанию интерфейса SyncResolver.

Параметры:

syncResolver - объект SyncResolver, который необходимо установить; не может быть null.

Исключения:

IllegalArgumentException - если объект SyncResolver является null.

См. также:

getSyncResolver()