Класс 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