Класс SyncProvider

public abstract class SyncProvider extends Object

Механизм синхронизации, предоставляющий возможности чтения/записи для отключенных RowSet объектов. Реализация SyncProvider — это класс, который расширяет абстрактный класс SyncProvider.

Реализация SyncProvider идентифицируется уникальным идентификатором, который представляет собой полное имя класса. Это имя должно быть зарегистрировано в SPI SyncFactory, тем самым делая реализацию доступной для всех реализаций RowSet. Механизм фабрики в эталонной реализации использует это имя для создания реализации, которая может затем предоставить объект RowSet со своим читателем (объект javax.sql.RowSetReader) и своим писателем (объект javax.sql.RowSetWriter).

Спецификация JDBC RowSet Implementations предоставляет две эталонные реализации абстрактного класса SyncProvider: RIOptimisticProvider и RIXMLProvider. RIOptimisticProvider может установить любую реализацию RowSet с объектом RowSetReader и объектом RowSetWriter. Однако только реализация RIXMLProvider может установить объект XmlReader и объект XmlWriter. Объект WebRowSet использует объект XmlReader для чтения данных в формате XML, чтобы заполнить себя этими данными. Он использует объект XmlWriter для записи себя в поток или объект java.io.Writer в формате XML.

1.0 Правила именования реализаций

В качестве руководства по именованию реализаций SyncProvider следует учитывать следующее:

• Имя реализации SyncProvider — это полное имя класса.
• Рекомендуется, чтобы поставщики предоставляли реализацию SyncProvider в пакете с именем providers.

Например, если поставщик Fred, Inc. предложил реализацию SyncProvider, вы могли бы иметь следующее:

     Vendor name:  Fred, Inc.
     Domain name of vendor:  com.fred
     Package name:  com.fred.providers
     SyncProvider implementation class name:  HighAvailabilityProvider

     Fully qualified class name of SyncProvider implementation:
                        com.fred.providers.HighAvailabilityProvider
 

Следующая строка кода использует полное имя для регистрации этой реализации в статической переменной SyncFactory.

     SyncFactory.registerProvider(
                          "com.fred.providers.HighAvailabilityProvider");
 

Объект по умолчанию SyncProvider, предоставляемый эталонной реализацией, использует следующее имя:

     com.sun.rowset.providers.RIOptimisticProvider
 

Поставщики должны обратиться к эталонным реализациям поставщиков синхронизации для получения дополнительной информации о том, как реализовать новую реализацию SyncProvider.

2.0 Как объект RowSet получает своего поставщика

Отключенный объект Rowset может получить доступ к объекту SyncProvider двумя способами:

• Используя конструктор
  

         CachedRowSet crs = new CachedRowSet(
                    "com.fred.providers.HighAvailabilitySyncProvider");
        

• Используя метод setSyncProvider

         CachedRowSet crs = new CachedRowSet();
         crs.setSyncProvider("com.fred.providers.HighAvailabilitySyncProvider");
        

По умолчанию эталонные реализации поставщиков синхронизации RowSet всегда доступны для платформы Java. Если другие подключаемые поставщики синхронизации не были правильно зарегистрированы, платформа SyncFactory автоматически создаст экземпляр реализации по умолчанию SyncProvider эталонной реализации. Таким образом, в приведенном фрагменте кода, если никакая реализация с именем com.fred.providers.HighAvailabilitySyncProvider не была зарегистрирована в экземпляре SyncFactory, crs получит поставщика по умолчанию в эталонной реализации, которая является com.sun.rowset.providers.RIOptimisticProvider.

3.0 Нарушения и проблемы с синхронизацией

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

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

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

Любой отключенный или подключенный объект RowSet может быть заполнен из SQL-запроса, который изначально сформулирован из SQL-представления VIEW. Хотя во многих случаях возможно выполнить обновление базового представления, такое обновление требует дополнительной метаданных, которые могут отличаться. Класс SyncProvider предоставляет две константы для указания, поддерживает ли реализация обновление SQL-представления VIEW.

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

По умолчанию объект RowSet не обновляется, если он был заполнен данными из SQL-представления VIEW.

5.0 Константы SyncProvider

Класс SyncProvider предоставляет три набора констант, которые используются в качестве возвращаемых значений или параметров для методов SyncProvider. Объекты SyncProvider могут быть реализованы для выполнения синхронизации между объектом RowSet и его базовым источником данных с различной степенью тщательности. Первая группа констант указывает, как обрабатывается синхронизация. Например, GRADE_NONE указывает, что объект SyncProvider не будет обращать никакого внимания на то, какие данные действительны, и просто запишет данные RowSet в источник данных. GRADE_MODIFIED_AT_COMMIT указывает, что поставщик будет проверять только измененные данные на предмет их валидности. Другие уровни проверки всех данных на предмет валидности или установления блокировок при изменении или загрузке данных.

1. Константы для указания уровня синхронизации объекта SyncProvider
   • SyncProvider.GRADE_NONE
   • SyncProvider.GRADE_MODIFIED_AT_COMMIT
   • SyncProvider.GRADE_CHECK_ALL_AT_COMMIT
   • SyncProvider.GRADE_LOCK_WHEN_MODIFIED
   • SyncProvider.GRADE_LOCK_WHEN_LOADED
2. Константы для указания, какие блокировки устанавливаются на источнике данных
   • SyncProvider.DATASOURCE_NO_LOCK
   • SyncProvider.DATASOURCE_ROW_LOCK
   • SyncProvider.DATASOURCE_TABLE_LOCK
   • SyncProvider.DATASOURCE_DB_LOCK
3. Константы для указания, может ли объект SyncProvider выполнять обновления SQL-представления VIEW
   Эти константы описаны в предыдущем разделе (4.0).
   • SyncProvider.UPDATABLE_VIEW_SYNC
   • SyncProvider.NONUPDATABLE_VIEW_SYNC