连接器架构规定了打包和部署资源适配器的标准方式,使 Java EE 容器能够将自身的连接、事务和安全管理与外部资源管理整合起来。本章介绍 JDBC API 与连接器架构的关系。
18.1 系统约定
连接器架构定义了一组系统约定。资源适配器必须支持这些约定,才能与 Java EE 应用服务器集成:
- 连接管理约定 — 允许应用服务器对底层 EIS 的连接进行池化管理
- 事务管理约定 — 允许应用服务器管理事务
- 安全性约定 — 允许应用服务器进行安全性集成
- 生命周期管理约定 — 允许应用服务器管理资源适配器的生命周期
18.2 将连接器系统约定映射到 JDBC 接口
JDBC API 接口与连接器系统约定之间存在以下映射:
| 连接器约定 | JDBC 接口 |
|---|---|
ConnectionFactory | DataSource |
Connection | Connection |
ConnectionEventListener | ConnectionEventListener |
ConnectionEvent | ConnectionEvent |
ManagedConnectionFactory | ConnectionPoolDataSource / XADataSource |
ManagedConnection | PooledConnection / 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 文件部署到应用服务器后,应用程序可以:
- 使用 JNDI 查找
DataSource - 获取连接
- 执行 SQL 操作
18.4 迁移路径
如果 JDBC 驱动程序供应商希望迁移到连接器架构,可以按照以下建议进行:
- 实现
ManagedConnectionFactory接口(通常通过包装现有的XADataSource或ConnectionPoolDataSource) - 实现
ManagedConnection接口(通常通过包装现有的XAConnection或PooledConnection) - 创建
ra.xml部署描述符 - 将驱动程序打包为 RAR 文件
通过这种迁移方式,驱动程序可以使用 Java EE 应用服务器提供的基础设施服务,同时保持与现有 JDBC 应用程序的兼容性。
