Класс 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 по умолчанию. Таким образом, в предыдущем фрагменте кода, если в экземпляре SyncFactory не зарегистрирована реализация с именем com.fred.providers.HighAvailabilitySyncProvider, 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