test

Sun Java System Application Server Enterprise Edition 8.1 2005Q2 管理指南

第 7 章 连接器资源

本章说明如何配置用于访问企业信息系统 (EIS) 的连接器。本章包括以下几个部分：

关于连接器

连接器模块也称为资源适配器，是允许应用程序与企业信息系统 (EIS) 进行交互式操作的 J2EE 组件。EIS 软件包含各种类型的系统：包括企业资源规划 (ERP)、主机事务处理和非关系数据库。类似其他 J2EE 模块，安装连接器模块即是部署该连接器模块。

连接器连接池是一组用于特定 EIS 的可重复使用的连接。要创建连接器连接池，请指定与池关联的连接器模块（资源适配器）。

连接器资源是为应用程序提供到 EIS 的连接的程序对象。要创建连接器资源，请指定其 JNDI 名称及其关联的连接池。多个连接器资源可以指定一个连接池。应用程序可通过查找资源的 JNDI 名称定位资源。（有关 JNDI 的更多信息，请参见“JNDI 名称和资源”部分）。EIS 的连接器资源的 JNDI 名称通常位于 java:comp/env/eis-specific 子上下文中。

Application Server 使用连接器模块（资源适配器）实现 JMS。请参见“JMS 资源与连接器资源之间的关系”部分。

有关连接器连接池的管理控制台任务

Procedure设置 EIS 访问

  1. 部署（安装）连接器。请参见部署连接器模块。

  2. 为连接器创建连接池。请参见创建连接器连接池。

  3. 创建与连接池关联的连接器资源。请参见创建连接器资源。

Procedure创建连接器连接池

开始之前

创建池之前，请部署与池关联的连接器模块（资源适配器）。为新池指定的值取决于部署的连接器模块。

  1. 在树组件中，展开“资源”节点，然后展开“连接器”节点。

  2. 选择“连接器连接池”节点。

  3. 在“连接器连接池”页面中，单击“新建”。

  4. 在“创建连接器连接池”的第一个页面中，指定以下设置：

    1. 在“名称”字段中，输入池的逻辑名称。

      创建连接器资源时将指定此名称。

    2. 从“资源适配器”组合框中选择一个条目。

      该组合框显示已部署的资源适配器（连接器模块）的列表。

  5. 单击“下一步”。

  6. 在“创建连接器连接池”的第二个页面中，从“连接定义”组合框中选择一个值。

    组合框中的选项取决于资源适配器。通常，指定一种 ConnectionFactory（工厂实例）以建立与 EIS 的连接。

  7. 单击“下一步”。

  8. 在“创建连接池”的第三个也即最后一个页面中，执行以下任务：

    1. 在“常规设置”部分中检验各个值是否正确。

    2. 对于“池设置”部分中的字段，可以保留默认值。

      可以在以后更改这些设置。请参见“编辑连接器连接池”。

    3. 在“其他属性”表中添加任何所需的属性。

      在“创建连接器连接池”的上一个页面中，从“连接定义”组合框中选择了一个类。如果此类位于服务器的类路径中，则“其他属性”表将显示默认属性。

  9. 单击“完成”。

等效的 asadmin 命令

create-connector-connection-pool

Procedure编辑连接器连接池

  1. 在树组件中，展开“资源”节点，然后展开“连接器”节点。

  2. 展开“连接器连接池”节点。

  3. 选择要编辑的池的节点。

  4. 在“编辑连接器连接池”页面中，您可以更改控制池中连接的数目的设置。请参见下表。

    参数 

    说明 

    初始和最小池大小 

    池中连接的最小数目。该值还确定了首次创建池或应用程序服务器启动时被置于池中的连接的数目。 

    最大池大小 

    池中连接的最大数目。 

    池大小调整数量 

    当池向最小池大小方向收缩时，将成批调整大小。此值确定批处理中的连接数目。将该值设置过大会延迟连接回收；而将该值设置过小则会导致效率太低。 

    空闲超时 

    连接在池中保持空闲的最长时间（以秒为单位）。一旦超过此时间，即从池中删除该连接。 

    最长等待时间 

    已请求连接的应用程序在达到连接超时之前等待的时间。由于默认等待时间过长，应用程序可能会出现无限期挂起的情况。 

    一旦失败 

    选中标记为“关闭所有连接”的复选框之后，如果单个连接失败，应用程序服务器将关闭池中的所有连接，然后重新建立这些连接。如果未选中此复选框，则只有在使用各个连接时才会重新建立这些连接。 

    事务支持 

    使用“事务支持”列表可以为连接池选择事务支持类型。选择的事务支持将以向下兼容方式覆盖与此连接池关联的资源适配器中的事务支持属性。也就是说，它可以支持比资源适配器中指定的事务级别低或与其相同的事务级别，但它不能指定更高的级别。 

    事务支持选项包括以下内容： 

    “事务支持”菜单中的“无”选项表示资源适配器不支持资源管理器本地事务或 JTA 事务，也不实现 XAResource 或 LocalTransaction 接口。

    “本地”事务支持表示资源适配器将通过实现 LocalTransaction 接口来支持本地事务。本地事务的管理在资源管理器内部进行，不涉及任何外部事务管理器。

    "XA" 事务支持表示资源适配器将通过实现 LocalTransaction 和 XAResource 接口来支持本地资源管理器和 JTA 事务。XA 事务由事务管理器在资源管理器外部进行控制和调整。本地事务的管理在资源管理器内部进行，不涉及任何外部事务管理器。

  5. 在“其他属性”表中，指定名称-值对。

    指定的属性取决于此池使用的资源适配器。部署者使用此表指定的名称-值对可用于覆盖由资源适配器供应商定义的属性的默认值。

  6. 在“安全映射”选项卡窗格中，创建或修改用于连接池的安全映射。

    有关如何创建安全映射的信息，请参见关于安全映射。

  7. 单击“保存”。

Procedure删除连接器连接池

  1. 在树组件中，展开“资源”节点，然后展开“连接器”节点。

  2. 选择“连接器连接池”节点。

  3. 在“连接器连接池”页面中，选中要删除的池的复选框。

  4. 单击“删除”。

等效的 asadmin 命令

delete-connector-connection-pool

有关连接器资源的管理控制台任务

Procedure创建连接器资源

连接器资源（数据源）为应用程序提供 EIS 连接。

开始之前

创建连接器资源之前，请先创建连接器连接池。

  1. 在树组件中，展开“资源”节点，然后展开“连接器”节点。

  2. 展开“连接器资源”节点。

  3. 在“连接器资源”页面中，单击“新建”。

  4. 在“创建连接器资源”页面中，指定资源的设置：

    1. 在“JNDI 名称”字段中，键入唯一的名称，例如：eis/myERP。

      请不要忘记正斜杠。

    2. 在“池名称”组合框中，选择新连接器资源所属的连接池。

    3. 要将资源更改为不可用，请选中“在所有目标上禁用”单选按钮。

      默认情况下，创建资源之后立即可以使用资源（已启用）。

    4. 在页面的“目标”部分，从“可用”字段中选择连接器资源将驻留的域、群集或服务器实例，然后单击“添加”。

      如果不想将连接器资源部署到“已选择”字段中列出的某个域、群集或服务器实例，请从字段中选择该域、群集或服务器实例，然后单击“删除”。

  5. 单击“确定”。

等效的 asadmin 命令

create-connector-resource

Procedure编辑连接器资源

  1. 在树组件中，展开“资源”节点，然后展开“连接器”节点。

  2. 展开“连接器资源”节点。

  3. 选择要编辑的连接器资源的节点。

  4. 在“编辑连接器资源”页面中，您可以从“池名称”菜单中选择其他连接池。

  5. 在“目标”选项卡窗格中，可以通过单击“管理目标”来编辑连接器资源部署到的目标。

    有关目标的更多信息，请参见创建连接器资源。

  6. 单击“保存”以应用所做的编辑。

Procedure删除连接器资源

  1. 在树组件中，展开“资源”节点，然后展开“连接器”节点。

  2. 选择“连接器资源”节点。

  3. 在“连接器资源”页面中，选中要删除的资源的复选框。

  4. 单击“删除”。

等效的 asadmin 命令

delete-connector-resource

Procedure配置连接器服务

使用“连接器服务”屏幕可以为部署到此群集或服务器实例的所有资源适配器配置连接器容器。

  1. 从树中选择“配置”。

  2. 选择要配置的实例：

    • 要配置特定的实例，请选择该实例的配置节点。例如，对于默认实例 server，请选择 "server-config" 节点。

    • 要为将来的实例（使用 default-config 的副本）配置默认设置，请选择 "default-config" 节点。

  3. 选择“连接器服务”节点。

  4. 在“关闭超时”字段中指定关闭超时（以秒为单位）。

    请输入一个整数，此整数表示应用程序服务器等待连接器模块的实例的 ResourceAdapter.stop 方法完成的秒数。应用程序服务器将忽略需要比指定关闭超时的时间更长的时间的资源适配器，并且关闭过程将继续。默认的关闭超时为 30 秒。单击“装入默认值”，可以为部署到此群集或服务器实例的资源适配器选择默认关闭超时。

有关管理对象资源的管理控制台任务

Procedure创建管理的对象资源

封装在资源适配器（连接器模块）中的管理的对象为应用程序提供了专用功能。例如，管理的对象可以提供对特定于资源适配器及其关联的 EIS 的分析器的访问。对象可以被管理，即管理员可以配置对象。要配置对象，请在“创建管理对象资源”页面或“编辑管理对象资源”页面中添加名称-值属性对。创建管理的对象资源时，请使管理的对象与 JNDI 名称相关联。

Application Server 使用资源适配器实现 JMS。对于创建的每个 JMS 目标，Application Server 都会自动创建一个管理的对象资源。

  1. 在树组件中，展开“资源”节点，然后展开“连接器”节点。

  2. 展开“管理的对象资源”节点。

  3. 在“管理的对象资源”页面中，单击“新建”。

  4. 在“管理的对象资源”页面中，指定以下设置：

    1. 在“JNDI 名称”字段中，键入标识资源的唯一名称。

    2. 在“资源类型”字段中，输入资源的 Java 类型。

    3. 从“资源适配器”组合框中，选择包含管理的对象的资源适配器。

    4. 选中或取消选中复选框以启用或禁用资源。

    5. 单击“下一步”。

  5. 在“创建管理的对象资源”的第二个页面中，可以执行以下任务。

    1. 要使用名称-值属性对配置管理的对象，请单击“添加属性”。

    2. 在页面的“目标”部分，从“可用”字段中选择管理的对象将驻留的域、群集或服务器实例，然后单击“添加”。

      要将管理的对象取消部署到“已选择”字段中列出的某个域、群集或服务器实例，请从字段中选择该域、群集或服务器实例，然后单击“删除”。

  6. 单击“完成”。

等效的 asadmin 命令

create-admin-object

Procedure编辑管理的对象资源

  1. 在树组件中，展开“资源”节点，然后展开“连接器”节点。

  2. 展开“管理的对象资源”节点。

  3. 选择要编辑的管理的对象资源的节点。

  4. 在“编辑管理的对象资源”页面中，修改在“创建管理的对象资源”中指定的值。

  5. 在“目标”选项卡窗格中，通过单击“管理目标”来编辑管理的对象部署到的目标。

    有关目标的更多信息，请参见创建管理的对象资源。

  6. 单击“保存”以应用所做的编辑。

Procedure删除管理的对象资源

  1. 在树组件中，展开“资源”节点，然后展开“连接器”节点。

  2. 选择“管理的对象资源”节点。

  3. 在“管理的对象资源”页面中，选中要删除的资源的复选框。

  4. 单击“删除”。

等效的 asadmin 命令

delete-admin-object