Класс SyncProvider

public abstract class SyncProvider extends Object

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

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

Спецификация Jdbc RowSet Реализации предоставляет две эталонные реализации абстрактного класса 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