J2C 连接工厂设置

使用此面板来指定连接工厂的设置。

可以通过下面两种方法中的一种方法来访问此管理控制台页面:

“配置”选项卡

作用域

指定资源适配器的作用域,该资源适配器通过此连接工厂将应用程序连接到企业信息系统(EIS)。只有安装在此作用域内的应用程序才能使用此连接工厂。

提供程序

指定 WebSphere® Application Server 对此连接工厂使用的资源适配器。

仅当创建新的连接工厂时,在此位置中才会显示提供程序。此列表显示了相关作用域中定义的所有现有资源适配器。如果要使用现有资源适配器作为提供程序,请从列表中选择一个资源适配器。

创建新提供程序

此选项允许为新连接工厂配置新资源适配器。

仅当您创建(而不是编辑)连接工厂时,才会显示创建新提供程序

如果单击创建新提供程序触发器,控制台就会显示资源适配器配置页面,在该页面中可以创建新的适配器。在单击确定保存设置后,您将看到连接工厂集合页面。单击新建以定义要与新资源适配器配合使用的新连接工厂;控制台现在将显示一个配置页面,该页面将该资源适配器列示为新连接工厂提供程序。

名称

指定此连接工厂的名称。

这是一个必需属性。

数据类型 字符串
JNDI 名称

指定此连接工厂的 JNDI 名称。

例如,名称可以为 eis/myECIConnection

设置此值后,保存它并重新启动服务器。运行 dumpNameSpace 工具时,您可以看到此字符串。这是一个必需属性。如果您未指定 JNDI 名称,那么缺省情况下,使用“名称”字段填写它。

数据类型 字符串
缺省值 eis/display name
重要: 请遵循 JNDI 名称的下列要求:
  • 不要在不同资源类型(如数据源与 J2C 连接工厂或 JMS 连接工厂)间指定重复的 JNDI 名称。
  • 不要对同一作用域中的同一类型的多个资源指定重复的 JNDI 名称。
描述

指定此连接工厂的文本描述。

数据类型 字符串
连接工厂接口

指定资源适配器支持的连接工厂接口的标准名称。

这是一个必需属性。在下拉列表中,资源适配器为新对象提供的可用类的列表。您创建连接工厂之后,字段为只读文本字段。

数据类型 下拉列表或文本
类别

指定您可用于将此连接工厂分类或分组的字符串。

数据类型 字符串
组件管理的认证别名

为到资源的组件管理的登录指定认证数据。

从列表中选择别名。

要定义列表中未显示的新别名:
  • 单击应用。在“相关项”下,您现在将看到 Java™ Platform, Enterprise Edition(Java EE)连接器体系结构(J2C)认证数据条目列表。
  • 单击 J2EE 连接器体系结构(J2C)认证数据条目
  • 单击新建
  • 定义别名。
  • 单击确定。控制台现在显示别名集合页面。此页面包含一个表,该表列示了所有已配置的别名。在该表前面,此页面还显示了连接工厂的名称。
  • 单击 J2C 连接工厂的名称。您现在看到连接工厂的配置页面。
  • 在“组件管理的认证别名”列表中选择新别名。
  • 单击应用

如果在应用程序服务器中已经定义了安全域,那么可以单击浏览...以对要配置的资源选择认证别名。安全域允许您在服务器之间隔离认证别名。树形视图对于确定别名所属的安全域很有用,并且树形视图可以帮助您确定将能够访问每个认证别名的服务器。树形视图将针对每个资源进行调整,因此,当您无法使用域和别名时,就会将它们隐藏起来。

数据类型 列表

为组件管理的认证配置的别名并不适用于所有必须访问受保护资源的客户机。通过 Java 命名和目录接口(JNDI)进行访问的外部 Java 客户机可以查找 Java 2 连接器(J2C)资源,例如,数据源或 Java 消息服务(JMS)队列。但是,不允许这些客户机利用对资源定义的组件管理的认证别名。当 getConnection() 方法未指定任何认证数据(例如 userpassword),或者没有指定 ConnectionSpec 的值,那么会将此别名用作缺省值。如果外部客户机需要获取连接,那么它必须通过在 getConnection() 调用中的自变量之间传递来承担认证的责任。

但是,如果客户机(例如 servlet 或企业 bean)在应用程序服务器的同一单元内的进程中运行,并且客户机可以查找 JNDI 名称空间中的资源,那么这些客户机可以获取连接,而不必在调用 getConnection() 时显式提供认证数据。在这种情况下,如果组件的 res-auth 设置是应用程序,那么可以从连接工厂中定义的组件管理的认证别名中获得认证。当您将 res-auth 设置为容器时,将从在组件的资源引用中定义的登录配置中获取认证。如果组件的资源引用未定义登录配置,那么将从连接工厂中定义的容器管理的认证别名中获得认证。
避免故障: J2C 认证别名是按每个单元提供的。因为不能解析别名,所以一个应用程序服务器中的企业 bean 或 servlet 不能查找其他单元中的另一个服务器进程中的资源。gotcha
用于 XA 恢复的认证别名

此字段用于指定应该在 XA 恢复处理期间使用的认证别名。如果在服务器发生故障之后更改了此别名,那么后续的 XA 恢复处理将使用在发生故障之前有效的原始设置。

如果资源适配器不支持 XA 事务,那么不会显示此字段。缺省值将来自所选的应用程序认证别名(如果指定)。

如果在应用程序服务器中已经定义了安全域,那么可以单击浏览...以对要配置的资源选择认证别名。安全域允许您在服务器之间隔离认证别名。树形视图对于确定别名所属的安全域很有用,并且树形视图可以帮助您确定将能够访问每个认证别名的服务器。树形视图将针对每个资源进行调整,因此,当您无法使用域和别名时,就会将它们隐藏起来。

数据类型 下拉列表
映射配置别名

指定此连接工厂使用的 Java 认证和授权服务(JAAS)映射配置的认证别名。

单击安全性 > 全局安全性 > Java 认证和授权服务 > 应用程序登录,然后从表中选择别名。

DefaultPrincipalMapping JAAS 配置将认证别名映射到用户标识和密码。您可定义和使用其他映射配置。
避免故障: 某些映射配置别名不使用容器管理的认证别名,因此,如果选择了其中一个映射配置别名,您就不能选择容器管理的认证别名。gotcha
数据类型 选取列表
容器管理的认证别名

指定向资源进行容器管理的登录时使用的认证数据,即 JAAS - J2C 认证数据条目。

从列表中选择别名。

要定义列表中未显示的新别名:
  1. 单击应用。在“相关项”下,您现在将看到 Java Platform, Enterprise Edition(Java EE)连接器体系结构(J2C)认证数据条目列表。
  2. 单击 J2EE 连接器体系结构(J2C)认证数据条目
  3. 单击新建
  4. 定义别名。
  5. 单击确定。控制台现在显示别名集合页面。此面板包含一个表,该表列示了所有已配置的别名。在该表前面,此页面还显示了连接工厂的名称。
  6. 单击 J2C 连接工厂的名称。您现在看到连接工厂的配置面板。
  7. 在“容器管理的认证别名”列表中选择新别名。
  8. 单击应用

如果在应用程序服务器中已经定义了安全域,那么可以单击浏览...以对要配置的资源选择认证别名。安全域允许您在服务器之间隔离认证别名。树形视图对于确定别名所属的安全域很有用,并且树形视图可以帮助您确定将能够访问每个认证别名的服务器。树形视图将针对每个资源进行调整,因此,当您无法使用域和别名时,就会将它们隐藏起来。

数据类型 选取列表
认证首选项(建议不要使用)

指定为该连接工厂定义的认证机制。

注: 从 WebSphere Application Server V6.0 开始,认证首选项由 <res-auth> 应用程序组件部署描述符设置和部署时有关资源引用映射的登录配置规范的组合来取代。

此设置指定了为相应资源适配器定义的哪些认证机制适用于此连接工厂。根据资源适配器的功能,公共值是:KERBEROSBASIC_PASSWORDNone

如果选择 None,需要应用程序组件来管理认证(<res-auth>Application</res-auth>)。在这种情况下,按以下某种方式获取用户标识和密码:
  • 组件管理的认证别名
  • 用户名、密码定制属性
  • 以 getConnection 方法传递的字符串
例如,如果已在 xa.xml 文档中为一个资源适配器定义了两个认证机制条目:
  • <authentication-mechanism-type>BasicPassword</authentication-mechanism-type>
  • <authentication-mechanism-type>Kerbv5</authentication-mechanism-type>
认证首选项指定用于容器管理的认证的机制。如果选择了资源适配器不支持的机制,那么服务器启动期间会产生异常。
数据类型 选取列表
缺省值 BASIC_PASSWORD



标有(在线)的链接要求访问因特网。

相关概念
相关任务


文件名: udat_j2cconnfacdet.html