Параметры фабрики соединений J2C

Конфигурация

Область действия

Задает область адаптера ресурса, соединяющего приложение с информационная система предприятия (EIS) через данную фабрику соединений. Использовать эту фабрику соединений могут лишь приложения, установленные в данной области.

Поставщик

Задает адаптер ресурса, используемый WebSphere Application Server для данной фабрики соединений.

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

Создать новый провайдер

Позволяет настроить новый адаптер ресурса для новой фабрики соединений.

Опция Создать новый провайдер отображается только при создании, а не изменении фабрики соединений.

При щелчке на опции Создать новый провайдер консоль отображает страницу настройки адаптера ресурса, с помощью которой можно создать новый адаптер. После нажатия кнопки OK для сохранения изменений вы увидите страницу набора фабрик соединений. Выберите Создать для определения новой фабрики соединений для применения с новым адаптером ресурса; консоль отобразит страницу настройки, на которой адаптер ресурса будет указан как новый провайдер фабрики соединений.

Имя

Имя данной фабрики соединений.

Это обязательное свойство.

Тип данных

Строка

Имя JNDI

Задает имя JNDI данной фабрики соединений.

Например, именем может быть eis/myECIConnection.

Задав это значение сохраните его и перезапустите сервер. Вы увидите эту строку при запуске инструмента dumpNameSpace. Это обязательное свойство. Если не указать имя JNDI, оно будет заполнено по умолчанию с помощью поля Имя.

Тип данных	Строка
Значение по умолчанию	eis/отображаемое имя

Важное замечание: Имена JNDI должны удовлетворять следующим требованиям:

Не указывайте одинаковые имена JNDI для ресурсов разных типов (например, ресурсов источников данных и фабрик соединений J2C или JMS).
Не указывайте одинаковые имена JNDI для разных ресурсов одного и того же типа из одной области.

Описание

Задает текстовое описание данной фабрики соединений.

Тип данных

Строка

Интерфейс фабрики соединений

Задает полное имя интерфейса фабрики соединений, поддерживаемое адаптером ресурса.

Это обязательное свойство. Для новых объектов список доступных классов предоставляется адаптером ресурса с помощью выпадающего списка. После создания фабрики соединений это поле станет доступным только для чтения.

Тип данных

Выпадающий список или текст

Категория

Задает строку, используемую для классификации или группировки фабрик соединений.

Тип данных

Строка

Псевдоним идентификации компонентов

Задает данные идентификации для управляемого компонентом входа в ресурс.

Выберите псевдоним из списка.

Чтобы задать новый псевдоним, отсутствующий в списке, выполните следующие действия:

Нажмите Применить. В разделе "Связанные элементы" будет показан список "Записи идентификационных данных архитектуры коннекторов Java Platform, Enterprise Edition (Java EE) (J2C).
Выберите Записи данных идентификации архитектуры коннектора J2EE (J2C).
Нажмите Создать.
Задайте псевдоним.
Нажмите OK. На консоли будет показана страница набора псевдонимов. Эта страница содержит таблицу со списком всех настроенных псевдонимов. Перед таблицей на этой странице приведено имя фабрики соединений.
Щелкните на имени фабрики соединений J2C. Появится страница настройки фабрики соединений.
Выберите новый псевдоним в списке управляемых контейнером псевдонимов идентификации.
Нажмите Применить.

Если на сервере приложений определены домены защиты, для выбора псевдонима идентификации настраиваемого ресурса можно воспользоваться кнопкой Обзор.... Домены защиты позволяют изолировать псевдонимы идентификации одного сервера от других. Данный иерархический список помогает получить представление о том, какому домену защиты принадлежит псевдоним, и какие серверы к каким псевдонимам имеют доступ. Этот список настраивается под каждый ресурс индивидуально, поэтому домены и псевдонимы, к которым вы не имеете доступа, не показываются.

Тип данных

Список

Псевдоним, указанный для управляемой компонентом идентификации, не относится ко всем клиентам, которым необходим доступ к защищенному ресурсу. Внешние клиенты Java с доступом JNDI могут находить ресурс Java 2 Connector (J2C), например источник данных или очередь службы сообщений Java (JMS). Однако они не могут использовать псевдоним управляемой компонентом идентификации, заданный для ресурса. Этот псевдоним — значение по умолчанию, используемое, когда во время вызова метода getConnection() не указываются данные идентификации (такие как user и password) или ConnectionSpec. Если внешнему клиенту требуется установить соединение, он должен передать аргументы для идентификации в вызове getConnection().

Но если клиенты (например сервлеты или объекты EJB) работают в процессах, расположенных в одной ячейке с сервером приложений, и могут искать ресурсы в пространстве имен JNDI, тогда они могут получать соединения, не предоставляя идентификационные данные во время вызова getConnection(). В этом случае, если для параметра res-auth компонента установлено значение Application, то для идентификации применяется псевдоним управляемой компонентом идентификации, определенный в фабрике соединений. Когда вы устанавливаете res-auth в значение Container, данные идентификации берутся из конфигурации входа в систему, определяемой в ссылке на ресурс. Если ссылка на ресурс для данного компонента не определяет конфигурацию входа, данные идентификации берутся из "Управляемого контейнером псевдонима идентификации", определяемого фабрикой соединений.

Предотвращение неполадок: Псевдоним идентификации J2C задается в каждой ячейке. Объект EJB или сервлет на сервере приложений не может находить ресурсы в другом процессе сервера, который находится в другой ячейке, поскольку псевдоним в данном случае невозможно обработать.gotcha

Псевдоним идентификации для восстановления XA

Это поле используется для указания псевдонима идентификации, используемого при обработке восстановления XA. Если имя псевдонима изменяется после сбоя сервера, последующее восстановление XA будет использовать значение этого параметра, которое было до сбоя.

Если адаптер ресурса не поддерживает транзакции XA, это поле не будет отображаться. Значение по умолчанию будет получено от выбранного псевдонима для идентификации приложения (если указано).

Тип данных

Выпадающий список

Преобразование псевдонимов конфигурации

Задает псевдоним идентификации для конфигурации преобразования службы идентификации Java (JAAS), используемой этой фабрикой соединений.

Нажмите Защита > Глобальная защита > Служба идентификации Java > Сеансы приложений, и выберите из таблицы псевдоним.

Конфигурация JAAS DefaultPrincipalMapping преобразует псевдоним идентификации в ИД пользователя и пароль. Можно задать и использовать и другие конфигурации преобразования.

Предотвращение неполадок: Некоторые псевдонимы конфигурации преобразования не используют псевдонимы идентификации, управляемые контейнером, поэтому, если выбраны именно такие псевдонимы конфигурации преобразования, управляемые контейнером псевдонимы идентификации выбрать будет нельзя. gotcha

Тип данных

Список выбора

Управляемый контейнером псевдоним идентификации

Задает данные идентификации, которые представляют собой JAAS (записи идентификационных данных J2C), для управляемого контейнером входа в ресурс.

Выберите псевдоним из списка.

Чтобы задать новый псевдоним, отсутствующий в списке, выполните следующие действия:

Нажмите Применить. В разделе "Связанные элементы" будет показан список "Записи идентификационных данных архитектуры коннекторов Java Platform, Enterprise Edition (Java EE) (J2C).
Выберите Записи данных идентификации архитектуры коннектора J2EE (J2C).
Нажмите Создать.
Задайте псевдоним.
Нажмите OK. На консоли будет показана страница набора псевдонимов. Эта панель содержит таблицу со списком всех настроенных псевдонимов. Перед таблицей на этой странице приведено имя фабрики соединений.
Щелкните на имени фабрики соединений J2C. Появится панель настройки фабрики соединений.
Выберите новый псевдоним в списке управляемых контейнером псевдонимов идентификации.
Нажмите Применить.

Тип данных

Список выбора

Свойство идентификации (устаревшее)

Задает механизм идентификации, указанный для данной фабрики соединений.

Прим.: Начиная с WebSphere Application Server версии 6.0 свойство идентификации заменено сочетанием параметра файла описания компонента приложения <res-auth> и спецификацией конфигурации входа в систему по преобразованию ссылки на ресурс во время развертывания.

Этот параметр указывает, какой из механизмов идентификации, заданных для соответствующего адаптера ресурса, применяется к данной фабрике соединений. К общим значениям, в зависимости от возможностей адаптера, относятся KERBEROS, BASIC_PASSWORD и None.

Если выбрано значение None, идентификацией будет управлять компонент приложения (<res-auth>Application</res-auth>). В таком случае ИД пользователя и пароль берутся из одного из следующих:

Псевдонима управляемой компонентом идентификации
Пользовательских свойств Имя пользователя, Пароль
Параметров, переданных методу getConnection

Например, если для адаптера ресурса в документе ra.xml заданы две записи механизма идентификации:

<authentication-mechanism-type>BasicPassword</authentication-mechanism-type>
<authentication-mechanism-type>Kerbv5</authentication-mechanism-type>

свойство идентификации указывает механизм, используемый для управляемой контейнером идентификации. Если выбранный механизм не поддерживается адаптером ресурса, при запуске сервера выбрасывается исключительная ситуация.

Тип данных	Список выбора
Значение по умолчанию	BASIC_PASSWORD