Класс SyncProviderException

javax.sql.rowset.spi.SyncProviderException

Все реализуемые интерфейсы:: Serializable, Iterable<Throwable>

public class SyncProviderException extends SQLException

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

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

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

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

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

С момента выпуска:

1.5

См. также:

Краткое описание конструкторов

Конструктор	Описание
`SyncProviderException()`	Создает новый объект `SyncProviderException` без подробного сообщения.
`SyncProviderException(String msg)`	Создает объект `SyncProviderException` с указанным подробным сообщением.
`SyncProviderException(SyncResolver syncResolver)`	Создает объект `SyncProviderException` с указанным экземпляром `SyncResolver`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`SyncResolver`	`getSyncResolver()`	Получает объект `SyncResolver`, установленный для данного объекта `SyncProviderException`, или, если он не установлен, экземпляр реализации `SyncResolver` по умолчанию, включенной в эталонную реализацию.
`void`	`setSyncResolver(SyncResolver syncResolver)`	Устанавливает для данного объекта `SyncProviderException` предоставленный объект `SyncResolver`.

Методы, объявленные в классе SQLException

getErrorCode, getNextException, getSQLState, iterator, setNextException

Модификатор и тип	Метод	Описание
`int`	`getErrorCode()`	Получает код исключения, специфичный для поставщика, для данного объекта `SQLException`.
`SQLException`	`getNextException()`	Получает исключение, присоединенное к данному объекту `SQLException` методом setNextException(SQLException ex).
`String`	`getSQLState()`	Получает SQLState для данного объекта `SQLException`.
`Iterator<Throwable>`	`iterator()`	Возвращает итератор по цепочке исключений SQLException.
`void`	`setNextException(SQLException ex)`	Добавляет объект `SQLException` в конец цепочки.

Методы, объявленные в классе Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Модификатор и тип	Метод	Описание
`final void`	`addSuppressed(Throwable exception)`	Добавляет указанное исключение к исключениям, подавленным при возникновении этого исключения.
`Throwable`	`fillInStackTrace()`	Заполняет трассировку стека выполнения.
`Throwable`	`getCause()`	Возвращает причину этого объекта throwable или `null`, если причина отсутствует или неизвестна.
`String`	`getLocalizedMessage()`	Создает локализованное описание этого объекта throwable.
`String`	`getMessage()`	Возвращает строку подробного сообщения этого объекта throwable.
`StackTraceElement[]`	`getStackTrace()`	Предоставляет программный доступ к сведениям о трассировке стека, выводимым методом `Throwable.printStackTrace()`.
`final Throwable[]`	`getSuppressed()`	Возвращает массив, содержащий все исключения, которые были подавлены, обычно оператором `try`-with-resources, при возникновении этого исключения.
`Throwable`	`initCause(Throwable cause)`	Инициализирует причину этого объекта throwable указанным значением.
`void`	`printStackTrace()`	Выводит этот объект throwable и его трассировку стека в стандартный поток ошибок.
`void`	`printStackTrace(PrintStream s)`	Выводит этот объект throwable и его трассировку стека в указанный поток печати.
`void`	`printStackTrace(PrintWriter s)`	Выводит этот объект throwable и его трассировку стека в указанный объект print writer.
`void`	`setStackTrace(StackTraceElement[] stackTrace)`	Устанавливает элементы трассировки стека, которые будут возвращены методом `Throwable.getStackTrace()` и выведены методами `Throwable.printStackTrace()` и связанными с ним.
`String`	`toString()`	Возвращает краткое описание этого объекта throwable.

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и планируется к удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого объекта `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода для этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Методы, объявленные в интерфейсе Iterable

forEach, spliterator

Модификатор и тип	Метод	Описание
`default void`	`forEach(Consumer<? super Throwable> action)`	Выполняет указанное действие для каждого элемента объекта `Iterable`, пока не будут обработаны все элементы или действие не вызовет исключение.
`default Spliterator<Throwable>`	`spliterator()`	Создает `Spliterator` для элементов, описываемых этим объектом `Iterable`.

Подробное описание конструкторов

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 по умолчанию, включенной в эталонную реализацию.

Если выбрасывается объект SyncProviderException, приложение может использовать этот метод для создания объекта SyncResolver, с помощью которого можно разрешить конфликт или конфликты, вызвавшие исключение.

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

setSyncResolver

public void setSyncResolver(SyncResolver syncResolver)

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

Параметры:

syncResolver — объект SyncResolver, который требуется установить; не может быть равен null

Выбрасывает:

IllegalArgumentException — если объект SyncResolver равен null.

См. также:

© 1993, 2025, 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.