Класс 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 для получения описания, если оно есть.

Since:

1.5

См. также:

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

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

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

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

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

getErrorCode, getNextException, getSQLState, iterator, setNextException

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

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

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

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

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

forEach, spliterator

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

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(String) используются для создания экземпляра SyncResolver.

setSyncResolver

public void setSyncResolver(SyncResolver syncResolver)

Устанавливает объект SyncResolver для этого объекта SyncProviderException на предоставленный. Если предоставленный аргумент является 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.sql.rowset/javax/sql/rowset/spi/SyncProviderException.html