本文作者:icy

ZeosLib:Pascal/Delphi 世界的数据库访问瑞士军刀

icy 昨天 55 抢沙发
ZeosLib:Pascal/Delphi 世界的数据库访问瑞士军刀摘要: ZeosLib:Pascal/Delphi 世界的数据库访问瑞士军刀 引言 在 Delphi 和 Free Pascal 的生态圈里,数据库访问组件的选择其实并不算多。官方提供的...

ZeosLib:Pascal/Delphi 世界的数据库访问瑞士军刀

ZeosLib:Pascal/Delphi 世界的数据库访问瑞士军刀

引言

在 Delphi 和 Free Pascal 的生态圈里,数据库访问组件的选择其实并不算多。官方提供的 dbExpress 逐渐式微,FireDAC 虽然功能强大但仅限 Delphi 且收费,而 ZeosLib(Zeos Database Objects,简称 ZDBC)则以开源、跨编译器、跨数据库的姿态,成为许多 Pascal 开发者手中不可或缺的工具。

本文就来系统地介绍一下这个项目,包括它的定位、架构、支持的数据库、使用方式以及一些实战经验。


什么是 ZeosLib

ZeosLib 是一套原生的数据库访问组件库,专为 Delphi 和 Free Pascal 设计。它的项目主页位于 https://github.com/frones/ZeosLib,由早期的 SourceForge 时代延续至今,如今在 GitHub 上活跃维护。

它的核心目标很明确:用一套统一的 API,访问尽可能多的数据库系统。而且这套 API 是纯 Pascal 实现的,不依赖任何外部客户端库的 C 接口绑定(部分数据库除外,取决于连接方式),也不需要中间件。

主要特性

  • 跨编译器:同时支持 Delphi 7 一直到最新的 Delphi 版本,以及 Free Pascal / Lazarus。
  • 多数据库支持:MySQL、MariaDB、PostgreSQL、SQLite、Firebird、Interbase、Oracle、MSSQL、Sybase、DB2、ODBC、ASA 等。
  • 原生协议实现:对 MySQL、PostgreSQL、Firebird、SQLite 等,Zeos 直接实现数据库的通信协议,无需安装客户端库。
  • Dataset 与连接池:提供 TZConnection、TZQuery、TZTable、TZStoredProc 等组件,与原生 TDataSet 体系高度兼容。
  • 事务与参数化查询:完整支持参数化语句、事务控制、批量执行等。
  • Unicode 支持:新版本全面支持 Unicode(UTF-8 传输层)。
  • 线程安全考虑:支持多线程场景下的连接管理,配合连接池使用。

项目架构概览

ZeosLib 从代码结构上看,可以划分为几个层次(在仓库的 src 目录下):

Plain text
src/
├── core/          -- 核心框架:ZDBC 抽象接口、连接、语句、结果集、事务
├── dbc/           -- 各数据库驱动实现(ZDBCMySql、ZDBCPostgreSql...)
├── component/     -- VCL/LCL 组件封装(TZConnection、TZQuery 等)
├── plain/         -- 纯接口层(不依赖 TDataSet,可直接用对象编程)
├── parsedb/       -- 数据库元数据解析
└── ...

1. 核心抽象层(ZDBC)

这是整个库的心脏。它定义了一套数据库无关的接口:

  • IZConnection:连接抽象
  • IZStatement:SQL 语句抽象
  • IZResultSet:结果集抽象
  • IZTransaction:事务抽象

这一层的设计思路和 JDBC 很像——上层只面向接口编程,下层由具体驱动实现。正是这种抽象让 Zeos 能”一套代码对接 N 个数据库”。

2. 驱动层(dbc)

每个数据库对应一个子目录,例如 dbc/ZDBCMySql、dbc/ZDBCPostgreSql。驱动负责:

  • 协议拼包与解析(如 MySQL 的握手包、PostgreSQL 的 startup message)
  • 数据类型映射
  • 特定 SQL 方言处理(如 LIMIT/OFFSET、分页语法差异)

3. 组件层(component)

对使用 VCL/LCL 的开发者来说,最常用的就是这一层。它把 ZDBC 的接口包装成标准的 TComponent 和 TDataSet 派生类,可以直接放到 DataModule 上,用可视化方式配置。

4. Plain 层

如果你的项目不需要 TDataSet(例如服务端程序、控制台程序),可以直接使用 plain 目录下的对象式 API,更轻量、更直接。


组件快速上手

安装

  1. 从 GitHub 克隆仓库。
  2. 进入 packages 目录,按你的 Delphi 版本打开对应的包工程编译安装(例如 Delphi12 或 lazarus)。
  3. 安装后会在组件面板上出现 Zeos 分类。

基本用法(以 Firebird 为例)

在窗体或 DataModule 上放置:

Pascal
uses
  ZConnection, ZDataset;

var
  ZConnection1: TZConnection;
  ZQuery1: TZQuery;

配置连接:

Pascal
ZConnection1.Protocol := 'firebird-3.0';
ZConnection1.HostName := 'localhost';
ZConnection1.Port     := 3050;
ZConnection1.Database := 'c:\data\mydb.fdb';
ZConnection1.User     := 'SYSDBA';
ZConnection1.Password := 'masterkey';
ZConnection1.Connect;

执行查询:

Pascal
ZQuery1.Connection := ZConnection1;
ZQuery1.SQL.Text := 'SELECT ID, NAME FROM CUSTOMERS WHERE CITY = :CITY';
ZQuery1.ParamByName('CITY').AsString := 'Shanghai';
ZQuery1.Open;

while not ZQuery1.Eof do
begin
  Memo1.Lines.Add(Format('%d - %s',
    [ZQuery1.FieldByName('ID').AsInteger,
     ZQuery1.FieldByName('NAME').AsString]));
  ZQuery1.Next;
end;
ZQuery1.Close;

如果不想用组件,也可以纯代码方式:

Pascal
uses
  ZConnection, ZDataset;

var
  Conn: TZConnection;
  Qry: TZQuery;
begin
  Conn := TZConnection.Create(nil);
  try
    Conn.Protocol := 'mysql';
    Conn.HostName := '127.0.0.1';
    Conn.Database := 'test';
    Conn.User     := 'root';
    Conn.Password := '';
    Conn.Connect;

    Qry := TZQuery.Create(nil);
    try
      Qry.Connection := Conn;
      Qry.SQL.Text := 'SELECT * FROM users';
      Qry.Open;
      // ...
    finally
      Qry.Free;
    end;
  finally
    Conn.Free;
  end;
end;

组件一览

组件 作用
TZConnection 数据库连接,管理协议、主机、库名、字符集等
TZQuery 执行 SQL 查询/更新,支持参数化
TZTable 单表操作封装
TZStoredProc 调用存储过程
TZUpdateSQL 复杂查询的更新语句封装

支持数据库清单(摘要)

ZeosLib 官方支持并通过测试的数据库包括(协议名即 Protocol 属性值):

  • MySQL / MariaDB:mysql、mariadb
  • PostgreSQL:postgresql
  • Firebird / Interbase:firebird、interbase
  • SQLite:sqlite-3
  • Oracle:oracle(需 OCI)
  • Microsoft SQL Server:mssql(直连或 ODBC)
  • DB2:db2
  • Sybase ASE:sybase
  • ODBC 通用:odbc
  • SAP SQL Anywhere / ASA:asa

具体协议字符串建议参考项目 src/dbc 目录下各驱动的文档或 ZPlainDriver 相关单元。


一些实战经验与注意事项

1. 字符集与 Unicode

新版本统一采用 UTF-8 传输。连接 MySQL 时务必设置:

Pascal
ZConnection1.Properties.Values['characterEncoding'] := 'utf8';

或在协议端指定正确的 charset。否则中文乱码几乎是必然的。

2. 连接池

Zeos 提供了 TZConnection 的内建连接池支持:

Pascal
ZConnection1.Properties.Values['Pooled'] := 'True';
ZConnection1.Properties.Values['MaxPooledConnections'] := '20';

对于多线程的 Web 后台或服务端程序,连接池几乎是必备的。注意配合 ZConnection1.GetConnection / ReleaseConnection 使用(线程内)。

3. 分页与方言差异

TZQuery 的 PageSize、FetchOptions 在不同数据库下表现不同。postgresql 与 mysql 都支持服务端游标式分页,但 Firebird 早期版本对 LIMIT 支持视版本而定。跨库项目里尽量用 Zeos 提供的分页机制,而非手写 SQL 方言。

4. 编译单元命名冲突

Zeos 的单元名(如 ZConnection、ZDataset)比较泛用。在大型项目中如果同时引入其他库,可能出现命名歧义,建议加包前缀或用别名:

Pascal
uses
  ZConnection in '...\ZConnection.pas';

5. Free Pascal / Lazarus 下的使用

在 Lazarus 里通过 Online Package Manager 即可安装 Zeos,或者手动编译 packages/lazarus 下的包。跨平台(Linux/ARM)下 Firebird、PostgreSQL、SQLite 驱动均表现良好,是树莓派、国产化替代场景中 Pascal 程序的常见选择。

6. 版本兼容

Zeos 不同大版本(如 7.x 与 8.x)之间有一定 API 变化,尤其是在 Unicode 与事务接口上。升级前务必阅读仓库里的改动日志(Changelog.txt),并跑一遍回归。


与其他方案的对比

方案 优点 缺点
ZeosLib 开源免费、跨库、跨编译器、纯 Pascal 大结果集性能略逊于原生客户端
FireDAC 官方强支持、功能全、性能好 仅 Delphi、商业授权(高级版)
dbExpress 官方、轻量 已停止更新、驱动依赖客户端库
UniDAC 性能优异、支持广 商业收费

如果预算有限、需要跨 Delphi + FPC、或者需要在 Linux/ARM 上跑数据服务,ZeosLib 基本是首选。


项目现状与社区

  • 维护状态:GitHub 上持续有提交,主要维护者响应提交问题积极,issue 区能看到版本迭代讨论。
  • 文档:官方 Wiki 与源码注释为主要参考;社区(如 Lazarus/Delphi 论坛、Stack Overflow)也有大量实例。
  • 许可证:基于 MPL 1.1 与 LGPL 混合授权(以仓库说明为准),商业项目可放心使用。

结语

ZeosLib 的存在,对 Pascal 生态来说意义重大:它让”写 Pascal 程序连数据库”这件事不再受制于某个特定 IDE 或商业授权,也不需要在不同数据库之间写一大堆适配代码。它的设计思路——核心抽象 + 驱动实现 + 组件封装——虽然朴素,但非常务实。

如果你正维护一个老 Delphi 项目,想迁移到 PostgreSQL 或 SQLite;如果你在用 Lazarus 做跨平台的数据应用;如果你只是想找一个纯粹的、能读能写的数据库组件——ZeosLib 都值得放进工具箱。

项目地址:https://github.com/frones/ZeosLib 参与贡献:欢迎提交 issue 与 PR,也可以从阅读 src/core 与某个驱动源码开始理解它的运作方式。


(本文基于 ZeosLib 当前主干版本整理,具体 API 与属性以所用版本为准。)

ZeosLib_20261020164649.zip
类型:压缩文件|已下载:2|下载方式:免费下载
立即下载
文章版权及转载声明

作者:icy本文地址:https://www.zelig.cn/delphi/1507.html发布于 昨天
文章转载或复制请以超链接形式并注明出处软角落-SoftNook

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

微信扫一扫打赏

阅读
分享

发表评论

快捷回复:

评论列表 (暂无评论,55人围观)参与讨论

还没有评论,来说两句吧...