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

javax.resource.spi
Интерфейс ManagedConnectionFactory

Все Суперинтерфейсы:

java.io. Сериализуемый

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

Экземпляр ManagedConnectionFactory является фабрикой и ManagedConnection и специфичных для EIS экземпляров фабрики соединения. Этот интерфейс поддерживает объединение в пул соединения, обеспечивая методы для соответствия и создания экземпляра ManagedConnection. Экземпляр ManagedConnectionFactory обязан быть JavaBean.

Версия:

0.6

Автор:

Рэхул Шарма

См. Также:

ManagedConnection

Сводка метода

java.lang.Object	createConnectionFactory() Создает экземпляр Фабрики Соединения.
java.lang.Object	createConnectionFactory(ConnectionManager cxManager) Создает экземпляр Фабрики Соединения.
ManagedConnection	createManagedConnection(javax.security.auth.Subject subject, ConnectionRequestInfo cxRequestInfo) Создает новое физическое соединение с базовым менеджером ресурсов EIS.
boolean	equals(java.lang.Object other) Проверьте, равен ли этот ManagedConnectionFactory другому ManagedConnectionFactory.
java.io.PrintWriter	getLogWriter() Получите писателя журнала для этого экземпляра ManagedConnectionFactory.
int	hashCode() Возвращает хэш-код для ManagedConnectionFactory
ManagedConnection	matchManagedConnections(java.util.Set connectionSet, javax.security.auth.Subject subject, ConnectionRequestInfo cxRequestInfo) Возвращает соответствующее соединение из набора кандидата соединений.
void	setLogWriter(java.io.PrintWriter out) Установите писателя журнала для этого экземпляра ManagedConnectionFactory.

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

createConnectionFactory

java.lang.Object createConnectionFactory(ConnectionManager cxManager)
                                         throws ResourceException

Создает экземпляр Фабрики Соединения. Экземпляр Фабрики Соединения инициализируется с переданным ConnectionManager. В управляемом сценарии ConnectionManager предоставляет сервер приложений.

Параметры:

cxManager - ConnectionManager, который будет связан с создаваемым экземпляром фабрики соединения EIS

Возвраты:

Специфичный для EIS экземпляр Фабрики Соединения или javax.resource.cci. Экземпляр ConnectionFactory

Броски:

ResourceException - Универсальное исключение

ResourceAdapterInternalException - Адаптер ресурса связанное состояние ошибки

createConnectionFactory

java.lang.Object createConnectionFactory()
                                         throws ResourceException

Создает экземпляр Фабрики Соединения. Экземпляр Фабрики Соединения инициализируется со значением по умолчанию ConnectionManager, предоставленный адаптером ресурса.

Возвраты:

Специфичный для EIS экземпляр Фабрики Соединения или javax.resource.cci. Экземпляр ConnectionFactory

Броски:

ResourceException - Универсальное исключение

ResourceAdapterInternalException - Адаптер ресурса связанное состояние ошибки

createManagedConnection

ManagedConnection createManagedConnection(javax.security.auth.Subject subject,
                                          ConnectionRequestInfo cxRequestInfo)
                                          throws ResourceException

Создает новое физическое соединение с базовым менеджером ресурсов EIS.

ManagedConnectionFactory использует информацию о безопасности (передал поскольку Предмет) и дополнительный ConnectionRequestInfo (который является определенным для ResourceAdapter и непрозрачным к серверу приложений) создать это новое соединение.

Параметры:

subject - Информация о безопасности вызывающей стороны

cxRequestInfo - Дополнительный адаптер ресурса определенная информация о запросе соединения

Возвраты:

Экземпляр ManagedConnection

Броски:

ResourceException - универсальное исключение

SecurityException - безопасность связанная ошибка

ResourceAllocationException - отказавший, чтобы выделить системные ресурсы для запроса соединения

ResourceAdapterInternalException - адаптер ресурса связанное состояние ошибки

EISSystemException - внутреннее состояние ошибки в экземпляре EIS

matchManagedConnections

ManagedConnection matchManagedConnections(java.util.Set connectionSet,
                                          javax.security.auth.Subject subject,
                                          ConnectionRequestInfo cxRequestInfo)
                                          throws ResourceException

Возвращает соответствующее соединение из набора кандидата соединений.

ManagedConnectionFactory использует информацию безопасности (в качестве в Предмете) и информация, предоставленная через ConnectionRequestInfo и дополнительный Адаптер Ресурса определенные критерии, чтобы сделать соответствие. Отметьте, что критерии, используемые для того, чтобы соответствовать, являются определенными для адаптера ресурса и не предписываются спецификацией Соединителя.

Этот метод возвращает экземпляр ManagedConnection, который является лучшим соответствием для того, чтобы обработать запрос выделения соединения.

Параметры:

connectionSet - соединение кандидата устанавливается

subject - информация о безопасности вызывающей стороны

cxRequestInfo - дополнительный адаптер ресурса определенная информация о запросе соединения

Возвраты:

ManagedConnection, если адаптер ресурса считает приемлемое соответствие иначе нулем

Броски:

ResourceException - универсальное исключение

SecurityException - безопасность связанная ошибка

ResourceAdapterInternalException - адаптер ресурса связанное состояние ошибки

NotSupportedException - если работа не поддерживается

setLogWriter

void setLogWriter(java.io.PrintWriter out)
                  throws ResourceException

Установите писателя журнала для этого экземпляра ManagedConnectionFactory.

Писатель журнала является потоком вывода символов, к которому будут напечатаны все журналирование и трассировка сообщений для этого экземпляра ManagedConnectionfactory.

ApplicationServer управляет ассоциацией потока вывода с ManagedConnectionFactory. Когда объект ManagedConnectionFactory создается, писатель журнала является первоначально нулем, другими словами, журналирование отключается. Как только писатель журнала связывается с ManagedConnectionFactory, регистрируя и трассировка для экземпляра ManagedConnectionFactory включаются.

Экземпляры ManagedConnection, создаваемые ManagedConnectionFactory, "наследовали" писателя журнала, который может быть переопределен ApplicationServer, используя ManagedConnection.setLogWriter, чтобы установить ManagedConnection определенное журналирование и трассировка.

Параметры:

out - PrintWriter - поток для регистрации ошибок и трассировки

Броски:

ResourceException - универсальное исключение

ResourceAdapterInternalException - адаптер ресурса связанное состояние ошибки

getLogWriter

java.io.PrintWriter getLogWriter()
                                 throws ResourceException

Получите писателя журнала для этого экземпляра ManagedConnectionFactory.

Писатель журнала является потоком вывода символов, к которому будут напечатаны все журналирование и трассировка сообщений для этого экземпляра ManagedConnectionFactory

ApplicationServer управляет ассоциацией потока вывода с ManagedConnectionFactory. Когда объект ManagedConnectionFactory создается, писатель журнала является первоначально нулем, другими словами, журналирование отключается.

Возвраты:

PrintWriter

Броски:

ResourceException - универсальное исключение

хэш-код

int hashCode()

Возвращает хэш-код для ManagedConnectionFactory

Переопределения:

hashCode в class java.lang.Object

Возвраты:

хэш-код для ManagedConnectionFactory

равняется

boolean equals(java.lang.Object other)

Проверьте, равен ли этот ManagedConnectionFactory другому ManagedConnectionFactory.

Переопределения:

equals в class java.lang.Object

Возвраты:

истина, если два экземпляра равны