Класс 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, используя один из следующих механизмов.

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

      -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.