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