Класс SyncFactory

public class SyncFactory
extends Object

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

Поскольку все методы в классе SyncFactory статические, существует только один объект SyncFactory на одну Java VM в любой момент времени. Это гарантирует, что существует единственный источник, из которого реализация RowSet может получить свою реализацию SyncProvider.

1.0 Обзор

Класс SyncFactory предоставляет внутренний реестр доступных реализаций поставщиков синхронизации (объекты SyncProvider). Этот реестр можно запросить, чтобы определить, какие поставщики синхронизации доступны. Следующая строка кода получает перечисление текущих зарегистрированных поставщиков.

java.util.Enumeration e = SyncFactory.getRegisteredProviders();

Все стандартные реализации RowSet должны предоставлять как минимум двух поставщиков:

• оптимистичного поставщика для использования с реализацией CachedRowSet или реализацией, производной от неё
• поставщика XML, который используется для чтения и записи XML, например, с объектами WebRowSet

Обратите внимание, что реализации JDBC RowSet включают реализации SyncProvider RIOptimisticProvider и RIXmlProvider, которые удовлетворяют этому требованию.

Класс SyncFactory предоставляет методы доступа, чтобы помочь приложениям определить, какие поставщики синхронизации в настоящее время зарегистрированы в SyncFactory.

Другие методы позволяют регистрировать или де-регистрировать поставщиков персистентности RowSet с механизмом фабрики. Это позволяет сделать доступными дополнительные реализации поставщиков синхронизации для объектов RowSet во время выполнения.

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

1. Если конкретный поставщик указан объектом RowSet и SyncFactory не содержит ссылку на этого поставщика, выбрасывается SyncFactoryException с сообщением, что поставщик синхронизации не найден.
2. Если реализация RowSet инициализируется с указанным поставщиком и указанный поставщик должным образом зарегистрирован, запрашиваемый поставщик предоставляется. В противном случае выбрасывается SyncFactoryException.
3. Если объект RowSet не указывает реализацию SyncProvider и нет дополнительных реализаций SyncProvider, предоставляются поставщики-реализации по умолчанию.

2.0 Регистрация реализаций SyncProvider

Как поставщики, так и разработчики могут регистрировать реализации SyncProvider с помощью одного из следующих механизмов.

• Использование командной строки
  Имя поставщика передаётся в командной строке, что добавит поставщика в системные свойства. Например:

  -Drowset.provider.classname=com.fred.providers.HighAvailabilityProvider

• Использование стандартного файла свойств
  Реализация по умолчанию предназначена для отправки с J2SE 1.5, которая будет включать дополнительный файл ресурсов, который можно редактировать вручную. Вот пример файла свойств, включённого в реализацию по умолчанию:

  #Default JDBC RowSet sync providers listing
     #
  
     # Optimistic synchronization provider
     rowset.provider.classname.0=com.sun.rowset.providers.RIOptimisticProvider
     rowset.provider.vendor.0=Oracle Corporation
     rowset.provider.version.0=1.0
  
     # XML Provider using standard XML schema
     rowset.provider.classname.1=com.sun.rowset.providers.RIXMLProvider
     rowset.provider.vendor.1=Oracle Corporation
     rowset.provider.version.1=1.0

  Класс SyncFactory проверяет этот файл и регистрирует содержащиеся в нём реализации SyncProvider. Разработчик или поставщик может добавить другие реализации в этот файл. Например, вот возможное добавление:

  rowset.provider.classname.2=com.fred.providers.HighAvailabilityProvider
       rowset.provider.vendor.2=Fred, Inc.
       rowset.provider.version.2=1.0

• Использование контекста JNDI
  Доступные поставщики могут быть зарегистрированы в контексте JNDI, и SyncFactory попытается загрузить реализации SyncProvider из этого контекста JNDI. Например, следующий фрагмент кода регистрирует реализацию поставщика в контексте JNDI. Это обычно выполняет развертыватель. В этом примере MyProvider регистрируется в пространстве имён CosNaming, которое используется ресурсами J2EE.

  import javax.naming.*;
  
      Hashtable svrEnv = new  Hashtable();
      srvEnv.put(Context.INITIAL_CONTEXT_FACTORY, "CosNaming");
  
      Context ctx = new InitialContext(svrEnv);
      com.fred.providers.MyProvider = new MyProvider();
      ctx.rebind("providers/MyProvider", syncProvider);

Далее приложение зарегистрирует контекст JNDI с экземпляром SyncFactory. Это позволяет SyncFactory просматривать контекст JNDI в поисках реализаций SyncProvider.

Hashtable appEnv = new Hashtable();
    appEnv.put(Context.INITIAL_CONTEXT_FACTORY, "CosNaming");
    appEnv.put(Context.PROVIDER_URL, "iiop://hostname/providers");
    Context ctx = new InitialContext(appEnv);

    SyncFactory.registerJNDIContext(ctx);

Если объект RowSet пытается получить объект MyProvider, SyncFactory попытается его найти. Сначала он ищет его в системных свойствах, затем в файлах ресурсов и, наконец, проверяет установленный контекст JNDI. Экземпляр SyncFactory проверяет, является ли запрашиваемый поставщик допустимым расширением абстрактного класса SyncProvider, и затем передаёт его объекту RowSet. В следующем фрагменте кода создаётся новый объект CachedRowSet и инициализируется со значением env, содержащим привязку к MyProvider .

Hashtable env = new Hashtable();
    env.put(SyncFactory.ROWSET_SYNC_PROVIDER, "com.fred.providers.MyProvider");
    CachedRowSet crs = new com.sun.rowset.CachedRowSetImpl(env);

Более подробные сведения об этих механизмах см. в спецификации пакета javax.sql.rowset.spi.