Класс SyncFactory

public class SyncFactory extends Object

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

Поскольку все методы в классе SyncFactory статические, существует только один объект SyncFactory на одну виртуальную машину Java в любой момент времени. Это гарантирует, что существует единственный источник, из которого реализация 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.