Класс SyncFactory

public class SyncFactory extends Object

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

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