Класс SyncFactory

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

Поскольку все методы класса SyncFactory являются статическими, в любой момент времени в виртуальной машине Java существует только один объект SyncFactory. Это гарантирует, что реализация RowSet может получить свою реализацию объекта SyncProvider из единственного источника.

1.0 Обзор

java.util.Enumeration e = SyncFactory.getRegisteredProviders();

• оптимистичный поставщик для использования с реализацией CachedRowSet или реализацией, производной от нее
• поставщик XML, используемый для чтения и записи XML, например, с объектами WebRowSet

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

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);

Hashtable env = new Hashtable();
    env.put(SyncFactory.ROWSET_SYNC_PROVIDER, "com.fred.providers.MyProvider");
    CachedRowSet crs = new com.sun.rowset.CachedRowSetImpl(env);

Поля

ROWSET_SYNC_PROVIDER

public static final String ROWSET_SYNC_PROVIDER

Стандартный идентификатор свойства для имени реализации поставщика синхронизации.

См. также:

Значения постоянных полей

ROWSET_SYNC_VENDOR

public static final String ROWSET_SYNC_VENDOR

Стандартный идентификатор свойства для имени поставщика реализации поставщика синхронизации.

См. также:

Значения постоянных полей

ROWSET_SYNC_PROVIDER_VERSION

public static final String ROWSET_SYNC_PROVIDER_VERSION

Стандартный идентификатор свойства для тега версии реализации поставщика синхронизации.

См. также:

Значения постоянных полей

Методы

registerProvider

public static void registerProvider(String providerID)
                             throws SyncFactoryException

SyncProvider p = new MySyncProvider();
 InitialContext ic = new InitialContext();
 ic.bind ("jdbc/rowset/MySyncProvider", p);

Параметры:

providerID - Объект String с уникальным идентификатором регистрируемого поставщика синхронизации

Исключения:

SyncFactoryException - если попытка предоставить пустое или null имя поставщика

См. также:

setJNDIContext(javax.naming.Context)

getSyncFactory

public static SyncFactory getSyncFactory()

Возвращает единственный экземпляр SyncFactory.

Возвращает:

экземпляр SyncFactory

unregisterProvider

public static void unregisterProvider(String providerID)
                               throws SyncFactoryException

Удаляет указанный в настоящее время зарегистрированный поставщик синхронизации из реестра SPI фабрики.

Параметры:

providerID - Уникальный идентификатор поставщика синхронизации

Исключения:

SyncFactoryException - Если попытка дерегистрации реализации SyncProvider, которая не была зарегистрирована.

getInstance

public static SyncProvider getInstance(String providerID)
                                throws SyncFactoryException

Возвращает экземпляр SyncProvider, идентифицированный по providerID.

Параметры:

providerID - уникальный идентификатор поставщика

Возвращает:

реализация SyncProvider

Исключения:

SyncFactoryException - Если SyncProvider не найден, providerID является null или возникла ошибка при попытке вызвать этого поставщика.

getRegisteredProviders

public static Enumeration<SyncProvider> getRegisteredProviders()
                                                        throws SyncFactoryException

Возвращает:

Перечисление A перечисление доступных зарегистрированных поставщиков синхронизации

Исключения:

SyncFactoryException - Если при получении зарегистрированных поставщиков возникла ошибка

setLogger

public static void setLogger(Logger logger)

Параметры:

logger - Экземпляр объекта Logger

Исключения:

SecurityException - если существует менеджер безопасности и его метод checkPermission запрещает вызов метода setLogger

NullPointerException - если регистратор null

См. также:

SecurityManager.checkPermission(java.security.Permission)

setLogger

public static void setLogger(Logger logger,
                             Level level)

Параметры:

logger - экземпляр объекта Logger

level - экземпляр объекта Level, указывающий требуемый уровень регистрации

Исключения:

SecurityException - если существует менеджер безопасности и его метод checkPermission запрещает вызов метода setLogger

NullPointerException - если регистратор null

См. также:

SecurityManager.checkPermission(java.security.Permission), LoggingPermission

getLogger

public static Logger getLogger()
                        throws SyncFactoryException

Возвращает объект логгирования для приложений, чтобы получить события синхронизации, опубликованные реализациями SyncProvider.

Возвращает:

Объект Logger, указанный для использования реализациями SyncProvider

Исключения:

SyncFactoryException - если объект логгирования не был задан.

setJNDIContext

public static void setJNDIContext(Context ctx)
                           throws SyncFactoryException

Параметры:

ctx - действительный контекст JNDI

Исключения:

SyncFactoryException - если предоставленный контекст JNDI равен null

SecurityException - если существует менеджер безопасности и его метод checkPermission запрещает вызов метода setJNDIContext

См. также:

SecurityManager.checkPermission(java.security.Permission)