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