SuperAPI AI 工具集

database-driver-design

设计与创作

查看项目

更新于 10-16 01:48

技能介绍

用途:为开发者构建生产级 Swift 数据库客户端库提供指导,涵盖 wire protocol 实现、连接管理、类型安全 API 以及 Swift Concurrency 集成。模式源自 valkey-swift 与 postgres-nio 等实现。

主要能力:以类型定义命令与查询,关联响应类型;用字符串插值把值转为绑定参数以防注入;用分层协议处理编解码的不同保证(可抛出、静态类型等);带长度前缀的消息编码(写占位、编码后回填长度);解析时限制嵌套深度;用状态机管理连接生命周期;actor 配合 NIO executor 对齐以减少上下文切换;按消费者速率自适应背压与结果流式;连接池接入、keep-alive 与可观测性回调;变参泛型多列行解码。

必要用法与模式:命令定义为实现 DatabaseCommand 的结构体;查询用 ExpressibleByStringInterpolation 生成 $1、$2 占位;actor 用 unownedExecutor 绑定 channel.eventLoop.executor;长度前缀写入使用 buffer.setInteger 回填;嵌套解析设 maxDepth 限制;连接池实现 PooledConnection 协议并配置 KeepAliveBehavior。

适用场景:编写数据库驱动、协议客户端或需要类型安全查询与可靠连接池的 Swift 服务端库。

限制:资料未提供安装命令、包依赖版本、支持的数据库/协议范围、性能基准、许可与价格信息;示例代码出自资料原文,命名与 API 以其为准。