添加资源管理器连接工厂引用

J2EE 规范为 J2EE 组件提供了通过使用“逻辑”名称(称为资源管理器连接工厂引用)来引用资源管理器连接工厂的方法。可以使用部署描述符编辑器来定义资源管理器连接工厂引用。

资源管理器连接工厂是用来创建与资源管理器之间的连接的对象。例如,实现 javax.sql.DataSource 接口的对象是 java.sql.Connection 对象的资源管理器连接工厂,用于实现与数据库管理系统之间的连接。

在部署时,资源管理器连接工厂引用被绑定至目标运营环境中存在的实际资源管理器连接工厂。

通过引用访问的资源管理器连接工厂对象仅在执行查询的组件实例中有效。

对于定义的每个资源管理器连接工厂引用,都会有一个 resourece-ref 元素添加到 该应用程序组件的部署描述符。资源管理器连接工厂引用的作用域为定义这些引用的应用程序组件,因此在运行时,其他应用程序组件不能访问这些引用。其他组件可以定义同名的资源管理器连接工厂引用,而不会引起名称冲突。

要定义资源管理器连接工厂引用,请执行以下操作:

  1. 从 J2EE 模块的部署描述符编辑器中打开添加引用向导
  2. 选择资源引用,然后单击下一步
  3. 名称字段中,为引用指定名称,或者接受向导提供的缺省名称(建议)。名称字段中输入的值用于部署描述符中的 res-ref-name 条目。

    引用的名称相对于 java:comp/env 上下文。例如,名称应为 jms/StockHistoryDB,而不是 java:comp/env/jms/StockHistoryDB

  4. 类型字段中,选择应用程序组件代码所期望的资源管理器连接工厂的 Java™ 编程语言类型。 在此字段中输入的值用于部署描述符的 res-type 条目。
  5. 认证字段中,指示应用程序(对于 JSP 1.2 Web 项目为 servlet)是否以编程方式执行资源登录,或者容器是否为此资源管理所有认证。 在此处指定的值用于部署描述符的 res-auth 条目。
  6. 对于 J2EE 1.3 或更新的项目,请在可共享字段中指示是否可共享与资源管理器之间的连接(此连接是通过给定的资源管理器连接工厂引用而建立的)。缺省情况下,假定可以共享连接。 在此处指定的值用于部署描述符的 res-sharing-scope 条目。
  7. 描述文本区域中,输入引用的描述。
  8. 单击完成
相关概念
客户机部署描述符编辑器
相关任务
定义 J2EE 模块中的引用
添加 EJB 引用
添加消息目标引用
添加资源环境引用
添加安全角色引用
添加 Web service 引用

反馈