Класс SyncProvider

public abstract class SyncProvider extends Object

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

Реализация SyncProvider идентифицируется уникальным идентификатором, который является полным именем класса. Это имя должно быть зарегистрировано в SPI SyncFactory, что делает реализацию доступной для всех реализаций 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