连接器架构规定了打包和部署资源适配器的标准方式,使 Java EE 容器能够将自身的连接、事务和安全管理与外部资源管理整合起来。本章介绍 JDBC API 与连接器架构的关系。

18.1 系统约定

连接器架构定义了一组系统约定。资源适配器必须支持这些约定,才能与 Java EE 应用服务器集成:

  • 连接管理约定 — 允许应用服务器对底层 EIS 的连接进行池化管理
  • 事务管理约定 — 允许应用服务器管理事务
  • 安全性约定 — 允许应用服务器进行安全性集成
  • 生命周期管理约定 — 允许应用服务器管理资源适配器的生命周期
赞助商

18.2 将连接器系统约定映射到 JDBC 接口

JDBC API 接口与连接器系统约定之间存在以下映射:

连接器约定JDBC 接口
ConnectionFactoryDataSource
ConnectionConnection
ConnectionEventListenerConnectionEventListener
ConnectionEventConnectionEvent
ManagedConnectionFactoryConnectionPoolDataSource / XADataSource
ManagedConnectionPooledConnection / XAConnection

18.2.1 连接管理

JDBC 的连接池接口(ConnectionPoolDataSource、PooledConnection)对应连接器的连接管理约定。

18.2.2 事务管理

JDBC 的事务接口(XADataSource、XAConnection、XAResource)对应连接器的事务管理约定。

18.2.3 安全性

JDBC API 使用标准的用户名/密码认证机制。

18.3 以连接器 RAR 文件格式打包 JDBC 驱动程序

JDBC 驱动程序可以打包为资源适配器归档(RAR)文件,再部署到 Java EE 应用服务器。RAR 文件包含:

  • ra.xml — 部署描述符
  • JDBC 驱动程序类 — 驱动程序实现
  • 任何本地库 — 驱动程序所需的本地代码

18.3.1 部署描述符

ra.xml 部署描述符指定:

  • 资源适配器类
  • 连接工厂接口和实现
  • 连接接口和实现
  • 受管连接工厂类
  • 配置属性

18.3.2 部署

将 RAR 文件部署到应用服务器后,应用程序可以:

  1. 使用 JNDI 查找 DataSource
  2. 获取连接
  3. 执行 SQL 操作

18.4 迁移路径

如果 JDBC 驱动程序供应商希望迁移到连接器架构,可以按照以下建议进行:

  1. 实现 ManagedConnectionFactory 接口(通常通过包装现有的 XADataSource 或 ConnectionPoolDataSource)
  2. 实现 ManagedConnection 接口(通常通过包装现有的 XAConnection 或 PooledConnection)
  3. 创建 ra.xml 部署描述符
  4. 将驱动程序打包为 RAR 文件

通过这种迁移方式,驱动程序可以使用 Java EE 应用服务器提供的基础设施服务,同时保持与现有 JDBC 应用程序的兼容性。