为应用程序客户机配置数据访问

为应用程序客户机配置数据访问涉及数据访问需要的指定资源引用和关联的数据库信息。此规范作为应用程序客户机的组装和部署步骤的一部分执行。

关于此任务

需要两个工具配置 J2EE 应用程序客户机使用的数据源:
  • 用于在部署描述符中定义资源引用的组装工具;以及
  • 在客户机部署环境中定义到数据库的连接的 Application Client Resource Configuration Tool (ACRCT)。

从应用程序客户机的数据访问使用直接来自客户机端的 JDBC 驱动程序连接功能。它不利用 WebSphere® Application Server 运行时中可用的其他合用支持。为应用程序客户机配置数据访问不需要在 WebSphere Application Server 服务器上配置 JDBC 提供程序和数据源。

如果要利用产品提供的池以及其他数据库函数,那么建议客户机应用程序利用在服务器端上运行的企业 Bean 来执行数据访问。

使用组装工具定义应用程序客户机资源引用

过程

  1. 按“组装 Java EE 客户机应用程序”主题中的描述组装应用程序客户机模块。
  2. 创建新的资源引用:
    1. 在“项目资源管理器”视图中,右键单击应用程序客户机模块,然后单击打开方式 > 部署描述符编辑器
    2. 引用选项卡上,单击添加 > 资源引用 > 下一步
    3. 在“资源引用”页上,输入此资源引用的名称 Application Client for WebSphere Application Server 运行时将此名称用于两个目的:将对象绑定到 JNDI 名称空间的 java:comp/env 部分,以及查找特定于客户机的配置信息。如果应用程序客户机的代码执行 java:comp/env/jdbc/myDB 查找,那么资源引用的名称应该为 jdbc/myDB
    4. 对于类型,为 JDBC 连接选择 javax.sql.DataSource
    5. 对于认证,如果您的客户机应用程序打算提供认证信息,选择应用程序。如果应用程序客户机运行时提供认证信息(如 Application Client Resource Configuration Tool 所配置),那么选择容器
    6. 忽略共享范围设置;在应用程序客户机资源引用中不使用它。所有应用程序客户机资源都不共享。
    7. 单击完成
    8. 结束部署描述符并且保存您的更改。

结果

添加引用后,WebSphere 绑定下出现 JNDI 名称字段。

使用 ACRCT 的客户机配置

关于此任务

您可以在 Application Client Resource Configuration Tool (ACRCT) 中配置两个客户机资源,以从应用程序客户机启用数据访问:数据源提供程序和数据源。
限制: 客户机上不支持以下可绑定到服务器名称空间的对象:
  • Java 2 连接器 (J2C) 对象
  • 连接管理器对象

应用程序客户机不提供客户机数据库驱动程序。如果您的客户机应用程序直接使用数据库而不是使用企业 Bean,那么您必须在客户机上提供数据库驱动程序。此操作可涉及联系您的数据库供应商以获取客户机数据库驱动程序代码和许可证。

建议您的客户机应用程序使用企业 Bean,而不是直接访问数据库。通过企业 Bean 访问数据库时不需要客户机上具有数据库驱动程序,因为数据库访问由应用程序服务器上运行的企业 Bean 处理。企业 Bean 还可以利用运行时提供的其他数据库函数。

过程

  1. 按“配置新数据源提供程序”主题中的描述配置新数据源提供程序。 此提供程序描述客户机应用程序的 JDBC 数据库实现。
  2. 常规选项卡上输入以下信息:
    1. 此数据源提供程序的名称
    2. 可选: 描述
    3. 数据源提供程序实现类或 JAR 文件的类路径 如果实现类或 JAR 文件已存在于客户机的类路径配置中,那么它是可选的。
    4. 实现类的名称。 例如,对于 DB2,此值是 COM.ibm.db2.jdbc.DB2DataSource。记住此类必须实现 javax.sql.DataSource 类。 如果此类不实现 javax.sql.DataSource,那么 ACRCT 不验证此类,并且当您运行您的客户机应用程序时将接收到一个错误。
    使用定制选项卡配置数据源提供程序的非标准属性。此面板允许您输入属性值对。在运行时期间,创建实现类名并且使用反射在新创建的数据源对象上设置此面板上添加的任何定制属性。此面板上配置的任何属性必须在数据源类上具有相应的设置方法。例如,假设有一个称为 use2Phase 的属性,并且其值应该为 1。在“定制”面板上您将值 use2Phase 输入到名称列而将值 1 输入到列。然后,应用程序客户机运行时使用反射在通常称为 setUse2Phase 的数据源类上查找属性,并调用传递值 1 的方法。请参阅数据库产品文档,以获取有关数据源实现的有效属性。
  3. 单击确定
  4. 按“为应用程序客户机配置新数据源”主题中的描述配置新数据源。 这描述客户机应用程序所使用的数据库的客户机属性。
  5. 常规选项卡上输入以下信息:
    1. 名称 此字段是必需的并且它标识要使用的 Application Client Resource Configuration Tool 的名称。此名称由客户机应用程序使用。
    2. 可选: 描述
    3. JNDI 名称。此字段是必需的并且必须匹配组装工具的“添加资源引用”页的名称字段中输入的值。在上述示例中,将此值设置为 jdbc/myDB
    4. 可选: 数据库名称
    5. 可选: 用户字段中的用户标识
    6. 可选: 密码字段中的密码 此密码不显示。
    7. 重新输入密码字段中再次确认您的密码。 注:只有当组装工具“添加资源引用”页上的认证字段设置为容器时才使用用户密码字段。

指示主题类型的图标 任务主题



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