javax.resource.cci
Интерфейс ConnectionFactory

Все Суперинтерфейсы:
javax.naming. Referenceable, java.io. Сериализуемый

public interface ConnectionFactory
расширяет java.io. Сериализуемый, Referenceable

ConnectionFactory обеспечивает интерфейс для того, чтобы делать пересадку к экземпляру EIS. Реализация интерфейса ConnectionFactory обеспечивается адаптером ресурса.

Код программы ищет экземпляр ConnectionFactory от пространства имен JNDI и использует его, чтобы получить соединения EIS.

Реализация class для ConnectionFactory обязана реализовывать java.io.Serializable и javax.resource.Referenceableинтерфейсы, чтобы поддерживать регистрацию JNDI.

Версия:
0.8
Автор:
Рэхул Шарма
См. Также:
Connection, Referenceable

Сводка метода
 Соединение getConnection()
          Получает соединение с экземпляром EIS.
 Соединение getConnection(ConnectionSpec properties)
          Получает соединение с экземпляром EIS.
 ResourceAdapterMetaData getMetaData()
          Получает метаданные для Адаптера Ресурса.
 RecordFactory getRecordFactory()
          Получает экземпляр RecordFactory.
 
Методы, наследованные от интерфейса javax.resource. Referenceable
setReference
 
Методы, наследованные от интерфейса javax.naming. Referenceable
getReference
 

Деталь метода

getConnection

Connection getConnection()
                         throws ResourceException
Получает соединение с экземпляром EIS. Эта getConnection разновидность должна использоваться, когда компонент хочет, чтобы контейнер управлял входом в систему EIS. Этот случай называют управляемым контейнером входом в систему. Компонент не передает информации о безопасности.

Возвраты:
Экземпляр соединения
Броски:
ResourceException - Отказавший, чтобы получить соединение с экземпляром EIS. Примеры ошибочных случаев:
  • Недопустимая конфигурация ManagedConnectionFactory - пример: недопустимое имя сервера
  • Внутренняя сервером приложений ошибка - пример: пул соединения связанная ошибка
  • Коммуникационная ошибка
  • Специфичная для EIS ошибка - пример: EIS, не активный
  • Ресурс внутренняя адаптером ошибка
  • Безопасность связанная ошибка; пример: недопустимый пользователь
  • Отказ выделить системные ресурсы

getConnection

Connection getConnection(ConnectionSpec properties)
                         throws ResourceException
Получает соединение с экземпляром EIS. Компонент должен использовать getConnection разновидность с javax.resource.cci. Параметр ConnectionSpec, если это должно передать какой-либо адаптер ресурса определенная информация о безопасности и параметры соединения. В компоненте - управляемый случай входа в систему, компонент приложения передает информацию о безопасности (пример: имя пользователя, пароль) через экземпляр ConnectionSpec.

Важно отметить, что свойства, через которые проходят getConnection метод, должны быть специфичными для клиента (пример: имя пользователя, пароль, язык) и не связанный с конфигурацией целевого экземпляра EIS (пример: номер порта, имя сервера). Экземпляр ManagedConnectionFactory конфигурируется с полным набором свойств, требуемых для создания соединения с экземпляром EIS.

Параметры:
properties - Параметры соединения и информация о безопасности, определенная как экземпляр ConnectionSpec
Возвраты:
Экземпляр соединения
Броски:
ResourceException - Отказавший, чтобы получить соединение с экземпляром EIS. Примеры ошибочных случаев:
  • Недопустимая спецификация входных параметров
  • Недопустимая конфигурация ManagedConnectionFactory - пример: недопустимое имя сервера
  • Внутренняя сервером приложений ошибка - пример: пул соединения связанная ошибка
  • Коммуникационная ошибка
  • Специфичная для EIS ошибка - пример: EIS, не активный
  • Ресурс внутренняя адаптером ошибка
  • Безопасность связанная ошибка; пример: недопустимый пользователь
  • Отказ выделить системные ресурсы
См. Также:
ConnectionSpec

getRecordFactory

RecordFactory getRecordFactory()
                               throws ResourceException
Получает экземпляр RecordFactory. RecordFactory используется для создания универсальных экземпляров Записи.

Возвраты:
RecordFactory экземпляр RecordFactory
Броски:
ResourceException - Отказавший, чтобы создать RecordFactory
NotSupportedException - Работа, не поддерживаемая

getMetaData

ResourceAdapterMetaData getMetaData()
                                    throws ResourceException
Получает метаданные для Адаптера Ресурса. Отметьте, что информация о метаданных о ResourceAdapter а не экземпляре EIS. Вызов этого метода не требует, чтобы было установлено активное соединение с экземпляром EIS.

Возвраты:
Экземпляр ResourceAdapterMetaData
Броски:
ResourceException - Отказавший, чтобы получить информацию метаданных об адаптере ресурса


Представьте ошибку или функцию

Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается срокам действия лицензии.

Сгенерированный на 10-February-2011 12:41


Spec-Zone.ru - all specs in one place



free hit counter