Примечание. Термины J2C и JCA оба обозначают J2EE Connector Architecture и используются равнозначно.
Фабрика соединений J2C представляет собой набор конфигурационных значений для соединения. Компоненты приложений, такие как EJB, имеют элементы дескрипторов <resource-ref>, которые ссылаются на фабрику соединений, а не на адаптер ресурсов. Фабрика соединений — это просто место хранения списка конфигурационных свойств соединения. Наряду с произвольным набором конфигурационных свойств, определяемых производителем адаптера ресурсов, существует несколько стандартных конфигурационных свойств, которые относятся к фабрике соединений. Эти стандартные свойства используются менеджером пула соединений в среде выполнения сервера приложений, и не используются кодом адаптера ресурсов, предоставленным производителем.
Чтобы создать фабрику соединений J2C, выполните следующие действия.
1. Выберите пункт Resources (Ресурсы) → J2C connection factories (Фабрики соединений J2C). Вы увидите список фабрик соединений J2C, относящихся к выбранной области действия.
2. Нажмите New (Создать), чтобы создать новую фабрику соединений, или выберите существующую фабрику, чтобы изменить ее свойства.
Страница конфигурации фабрики соединений приводится на рис. 6.20.
Рис. 6.20. Свойства фабрики соединений J2C
К общим относятся следующие свойства.
• Name (Имя).
Административное имя фабрики соединений J2C.
• JNDI name (JNDI-имя).
В данном поле содержится имя фабрики соединений, которое будет зарегистрировано в пространстве имен сервера приложений, с указанием подконтекста системы имен.
При инсталляции приложения, содержащего модули со ссылками на ресурсы J2C, ресурсы, которые определены в дескрипторе развертывания модуля, должны быть связаны с JNDI-именем ресурса.
В соответствии с соглашением, используйте для значения в свойстве Name префикс eis/, например, eis/<ConnectionFactoryName>
• Description (Описание).
Это необязательное описание фабрики соединений J2C, для административных записей.
• Connection factory interface (Интерфейс фабрики соединений).
В этом поле указывается название интерфейса фабрики соединений, поддерживаемого адаптером ресурсов.
• Category (Категория).
Указывается категория, которую можно использовать для классификации или распределения на группы фабрик соединений.
• Component-managed authentication alias (управляемый компонентом аутенти фикационный псевдоним).
Данный аутентификационный псевдоним используется для аутентификации при управляемом компонентом доступе к ресурсам.
Выводятся из употребления в версии 6.1. Выводятся из употребления следующие настройки системы безопасности.
• Container managed authentication alias (управляемый контейнером аутентификационный псевдоним).
• Authentication preference (Приоритет аутентификации).
• Mapping configuration alias (Привязка конфигурационного псевдонима).
Вместо них следует использовать параметры аутентификации ресурсов. За дополнительной информацией обращайтесь к разделу 6.7, «Аутентификация ресурсов»
3. Нажмите Apply (Применить). В разделе Additional Properties (Дополнительные
свойства) станут активными ссылки параметров пула соединений, дополнительных свойств фабрики соединений и клиентских настраиваемых свойств.
Свойства пула соединений конфигурируются так же, как для источника данных JDBC. За информацией об этих параметрах обращайтесь к разделу «Конфигурирование свойств пула соединений» выше.
Дополнительные свойства фабрики соединений показаны на рис. 6.21.
• Manage cached handles (Управлять сохраненными в кеш дескрипторами).
Когда вы вызываете для доступа к базе данных метод getConnection(), он возвращает дескриптор соединения. Этот дескриптор — это не физическое соединение, а представление физического соединения. Физическим соединением управляет менеджер соединений. Кешированный дескриптор — это дескриптор соединения, который хранится приложением при выходе за рамки транзакции и метода.
Данный параметр указывает, должен ли контейнер отслеживать кешированные дескрипторы. Это может создавать дополнительную нагрузку, и данный параметр следует включать лишь в специальных ситуациях. За дополнительной информацией о кешированных дескрипторах обращайтесь к теме «Connection Handles» (Дескрипторы соединений) Центра информации.
• Log missing transaction context (Заносить в журнал отсутствие контекста транз акции).
В программной модели J2EE указывается, что соединения всегда должны иметь контекст транзакции. Однако некоторые приложения не имеют своего контекста. Данная опция указывает, что контейнер должен заносить отсутствие контекста транзакции в журнал операций при получении соединения.
Рис. 6.21. Дополнительные свойства фабрики соединений
