J2C 连接工厂设置

使用此页面可指定连接工厂的设置。

可以通过下面两种方法中的一种方法来访问此管理控制台页面:
  • 资源 > 资源适配器 > J2C 连接工厂 > J2C_connection_factory
  • 资源 > 资源适配器 > 资源适配器 > resource_adapter > J2C 连接工厂 > J2C_connection_factory

范围

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

提供程序

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

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

创建新提供程序

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

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

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

名称

指定此连接工厂的名称。

这是一个必需属性。

信息
数据类型 String

JNDI 名称

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

例如,名称可以为 eis/myECIConnection

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

信息
数据类型 String
缺省 eis/display name
要点: 请遵循 JNDI 名称的下列要求:
  • 不要在不同资源类型(如数据源与 J2C 连接工厂或 JMS 连接工厂)间指定重复的 JNDI 名称。
  • 不要对同一范围中同一类型的多个资源指定重复的 JNDI 名称。

描述

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

信息
数据类型 String

连接工厂接口

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

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

信息
数据类型 下拉列表或文本

类别

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

信息
数据类型 String

用于 XA 恢复的认证别名

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

从列表中选择别名。

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

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

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

仅当至少定义了一个安全域并指定了对要编辑的资源适用的范围时,“浏览”按钮才可用。而且,该安全域必须至少包含一个 JAAS J2C 认证别名。

信息
数据类型 下拉列表

组件管理的认证别名

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

从列表中选择别名。

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

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

仅当至少定义了一个安全域并指定了对要编辑的资源适用的范围时,“浏览”按钮才可用。而且,该安全域必须至少包含一个 JAAS 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

映射配置别名

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

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

容器管理的认证别名

指定向资源进行容器管理的登录时使用的认证数据,即 JAAS - J2C 认证数据条目。根据对映射配置别名设置选择的值,可禁用此设置。

从列表中选择别名。

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

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

仅当至少定义了一个安全域并指定了对要编辑的资源适用的范围时,“浏览”按钮才可用。而且,该安全域必须至少包含一个 JAAS J2C 认证别名。

信息
数据类型 选取列表

认证首选项

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

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

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=udat_j2cconnfacdet
文件名:udat_j2cconnfacdet.html