Spec-Zone .ru спецификации, руководства, описания, API

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 - Отказавший, чтобы получить информацию метаданных об адаптере ресурса