Пакет javax.sql.rowset.spi

3.1 Требования

Реализация SyncProvider, полностью подключаемая к SyncFactory, должна расширять и реализовывать все абстрактные методы класса SyncProvider. Кроме того, реализация должна определить параметры уровня, блокировки и возможности обновляемого представления, определённые в описании класса SyncProvider. Должны поддерживаться один или несколько критериев описания SyncProvider. Ожидается, что реализации поставщиков предложат различные уровни, блокировки и возможности обновляемого представления.

Кроме того, необходимо следовать соглашению об именовании SyncProvider, как подробно описано в описании класса SyncProvider.

3.2 Уровни

JSR 114 определяет набор уровней для описания качества синхронизации, которые объект SyncProvider может предложить объекту RowSet без подключения. Эти уровни перечислены от низшего качества обслуживания к высшему.

• GRADE_NONE - Синхронизация с исходным источником данных не предоставляется. Реализация SyncProvider, возвращающая этот уровень, просто попытается записать в исходный источник данных любые изменённые данные из объекта RowSet, перезаписывая имеющиеся данные. Не предпринимается попытка сравнить исходные значения с текущими значениями, чтобы определить конфликт. Реализация RIXMLProvider использует этот уровень.
• GRADE_CHECK_MODIFIED_AT_COMMIT - Низкий уровень оптимистичной синхронизации. Реализация SyncProvider, возвращающая этот уровень, проверит конфликты в строках, которые были изменены между последней синхронизацией и текущей. Любые изменения в исходном источнике данных, которые были изменены, не будут отражены в объекте RowSet без подключения. Если конфликтов нет, изменения в объекте RowSet будут записаны в источник данных. Если конфликты есть, изменения не записываются. Реализация RIOptimisticProvider использует этот уровень.
• GRADE_CHECK_ALL_AT_COMMIT - Высокий уровень оптимистичной синхронизации. Реализация SyncProvider, возвращающая этот уровень, проверит все строки, включая те, которые не были изменены в объекте RowSet без подключения. Таким образом, любые изменения строк в базовом источнике данных будут отражены в объекте RowSet без подключения, когда синхронизация завершится успешно.
• GRADE_LOCK_WHEN_MODIFIED - Пессимистический уровень синхронизации. Реализации SyncProvider, возвращающие этот уровень, заблокируют строку в исходном источнике данных, соответствующую строке, изменяемой в объекте RowSet, чтобы снизить вероятность изменения одних и тех же данных в источнике данных другими процессами.
• GRADE_LOCK_WHEN_LOADED - Более высокий пессимистический уровень синхронизации. Реализация SyncProvider, возвращающая этот уровень, заблокирует всё представление и/или таблицу, затронутые исходным запросом, используемым для заполнения объекта RowSet.

3.3 Блокировки

JSR 114 определяет набор констант, которые указывают, были ли установлены какие-либо блокировки на базовом источнике данных объекта RowSet и, если да, то на каких конструкциях установлены блокировки. Эти блокировки останутся в источнике данных, пока объект RowSet не подключен к источнику данных.

Эти константы должны рассматриваться как дополнительные к константам уровня. Значение по умолчанию для большинства настроек уровня требует, чтобы блокировки источника данных не оставались, когда объект RowSet отключен от своего источника данных. Уровни GRADE_LOCK_WHEN_MODIFIED и GRADE_LOCK_WHEN_LOADED позволяют объекту RowSet без подключения иметь тонкую настройку степени блокировки.

• DATASOURCE_NO_LOCK - Блокировки не остаются на исходном источнике данных. Это значение по умолчанию для всех реализаций SyncProvider, если не указано иначе объектом RowSet .
• DATASOURCE_ROW_LOCK - Блокировка устанавливается на строки, затронутые исходным SQL-запросом, используемым для заполнения объекта RowSet.
• DATASOURCE_TABLE_LOCK - Блокировка устанавливается на все таблицы, затронутые запросом, используемым для заполнения объекта RowSet.
• DATASOURCE_DB_LOCK Блокировка устанавливается на весь источник данных, используемый объектом RowSet.

3.4 Обновляемые представления

Объект RowSet может быть заполнен данными из SQL-VIEW. Следующие константы указывают, может ли объект SyncProvider обновлять данные в таблице или таблицах, из которых был получен VIEW.

• UPDATABLE_VIEW_SYNC Указывает, что реализация SyncProvider поддерживает синхронизацию с таблицей или таблицами, из которых был получен SQL-VIEW , используемый для заполнения объекта RowSet.
• NONUPDATABLE_VIEW_SYNC Указывает, что реализация SyncProvider не поддерживает синхронизацию с таблицей или таблицами, из которых был получен SQL-VIEW , используемый для заполнения объекта RowSet.

3.5 Использование оценки SyncProvider и блокировки

В примере ниже, реализация CachedRowSetImpl перенастраивает свой текущий объект SyncProvider, вызывая метод setSyncProvider.

CachedRowSetImpl crs = new CachedRowSetImpl();
    crs.setSyncProvider("com.foo.bar.HASyncProvider");

SyncProvider sync = crs.getSyncProvider();

    switch (sync.getProviderGrade()) {
    case: SyncProvider.GRADE_CHECK_ALL_AT_COMMIT
         //A high grade of optimistic synchronization
    break;
    case: SyncProvider.GRADE_CHECK_MODIFIED_AT_COMMIT
         //A low grade of optimistic synchronization
    break;
    case: SyncProvider.GRADE_LOCK_WHEN_LOADED
         // A pessimistic synchronization grade
    break;
    case: SyncProvider.GRADE_LOCK_WHEN_MODIFIED
         // A pessimistic synchronization grade
    break;
    case: SyncProvider.GRADE_NONE
      // No synchronization with the originating data source provided
    break;
    }

    switch (sync.getDataSourcLock() {
      case: SyncProvider.DATASOURCE_DB_LOCK
       // A lock is placed on the entire datasource that is used by the
       // RowSet object
       break;

      case: SyncProvider.DATASOURCE_NO_LOCK
       // No locks remain on the  originating data source.
      break;

      case: SyncProvider.DATASOURCE_ROW_LOCK
       // A lock is placed on the rows that are  touched by the original
       // SQL statement used to populate
       // the RowSet object that is using the SyncProvider
       break;

      case: DATASOURCE_TABLE_LOCK
       // A lock is placed on  all tables that are touched by the original
       // SQL statement used to populated
       // the RowSet object that is using the SyncProvider
       break;

Enumeration e = SyncFactory.getRegisteredProviders();

4.0 Разрешение конфликтов при синхронизации

Объект SyncResolver, который является специальным видом объекта CachedRowSet или объекта JdbcRowSet, реализующего интерфейс SyncResolver, исследует конфликты строка за строкой. Он является дубликатом объекта RowSet , который синхронизируется, за исключением того, что он содержит только данные из источника данных, вызывающего конфликт. Все другие значения столбцов установлены в null. Для перехода от одного значения конфликта к другому, объект SyncResolver предоставляет методы nextConflict и previousConflict.

Интерфейс SyncResolver также предоставляет методы для выполнения следующих действий:

• определение, был ли конфликт обновлением, удалением или вставкой
• получение значения в источнике данных, вызвавшего конфликт
• установка значения, которое должно быть в источнике данных, если его необходимо изменить, или установка значения, которое должно быть в объекте RowSet, если его нужно изменить

Когда вызывается метод CachedRowSet acceptChanges, он делегирует объекту RowSet объект SyncProvider. Способ реализации поставщика, предоставляемого этим объектом SyncProvider, определяет уровень (уровень) проверки на наличие конфликтов. После завершения проверки на конфликты и обнаружения одного или нескольких конфликтов, метод acceptChanges выбрасывает объект SyncProviderException. Приложение может перехватить исключение и использовать его для получения объекта SyncResolver.

Затем приложение может использовать методы SyncResolver для получения информации о каждом конфликте и принятия решения о том, что делать. Если логика приложения или пользователь решает, что значение в объекте RowSet должно быть сохранённым, приложение или пользователь могут переопределить значение источника данных с ним.

Комментарий к интерфейсу SyncResolver содержит больше деталей.

5.0 Связанные спецификации

• JNDI 1.3
• Java Logging APIs

• Свойства системы
• Файлы ресурсов
• Источник данных для подключений JDBC