Project Icon

wcdb

跨平台多语言支持的高性能移动数据库框架

WCDB是基于SQLite和SQLCipher的移动数据库框架,支持C++、Java、Kotlin、Swift和Objective-C,适用于多个主流平台。它提供ORM和WINQ特性,简化数据库操作,具备并发处理、加密、数据恢复等功能。WCDB还支持模型升级、全文搜索、数据迁移和压缩,为移动应用提供全面的数据存储解决方案。

WCDB

欢迎提交PR 发布版本 编程语言平台

英文版本请参看这里

WCDB是一个高效完整易用的移动数据库框架,已应用于微信。它基于SQLite和SQLCipher,支持五种语言:C++、Java、Kotlin、Swift和Objective-C。

特性

易用性

  • ORM(对象关系映射):WCDB提供了灵活易用的ORM,用于创建表、索引和约束,以及通过C++/Java/Kotlin/Swift/Objc对象进行CRUD操作。
  • WINQ(WCDB语言集成查询):WINQ是一种原生数据查询能力,让开发者无需编写胶水代码来拼接SQL查询字符串。

借助ORM和WINQ,你可以用一行代码实现对象的插入、更新、查询和删除:

// C++
database.insertObjects<Sample>(Sample(1, "text"), myTable);
database.updateRow("text2", WCDB_FIELD(Sample::content), myTable, WCDB_FIELD(Sample::id) == 1);
auto objects = database.getAllObjects<Sample>(myTable, WCDB_FIELD(Sample::id) > 0);
database.deleteObjects(myTable, WCDB_FIELD(Sample::id) == 1);
// Java
database.insertObject(new Sample(1, "text"), DBSample.allFields(), myTable);
database.updateValue("text2", DBSample.content, myTable, DBSample.id.eq(1));
List<Sample> objects = database.getAllObjects(DBSample.allFields(), myTable, DBSample.id.gt(0));
database.deleteObjects(myTable, DBSample.id.eq(1));
// Kotlin
database.insertObject<Sample>(Sample(1, "text"), DBSample.allFields(), myTable)
database.updateValue("text2", DBSample.content, myTable, DBSample.id.eq(1))
val objects = database.getAllObjects<Sample>(DBSample.allFields(), myTable, DBSample.id.gt(0))
database.deleteObjects(myTable, DBSample.id.eq(1))
// Swift
try database.insert(Sample(id:1, content:"text"), intoTable: myTable)
try database.update(table: myTable,
                    on: Sample.Properties.content,
                    with: "text2"
                    where:Sample.Properties.id == 1)
let objects: [Sample] = try database.getObjects(fromTable: myTable,
                                                where: Sample.Properties.id > 0)
try database.delete(fromTable: myTable where: Sample.Properties.id == 1)
// Objc
[database insertObject:sample intoTable:myTable];
[database updateTable:myTable
          setProperty:Sample.content
              toValue:@"text2"
                where:Sample.id == 1];
NSArray* objects = [database getObjectsOfClass:Sample.class
                                     fromTable:myTable
                                         where:Sample.id > 0];
[database deleteFromTable:myTable where:Sample.id == 1];

高效性

通过框架层和sqlcipher源码优化,WCDB具有更高效的性能。

  • 多线程并发:WCDB通过连接池支持并发的读读和读写访问。
  • 深度优化:WCDB对SQLite的源码和配置进行了深度优化,以适应移动端的开发场景。同时,WCDB还针对常见的耗时场景进行了优化,如批量写入数据。

完整性

WCDB总结了实践中的常见问题,为数据库开发提供更完整的开发体验:

  • 加密支持:WCDB通过SQLCipher支持数据库加密。
  • 损坏恢复:WCDB提供内置修复工具包用于数据库损坏恢复。
  • 防注入:WCDB提供内置保护,防止SQL注入。
  • 数据库模型升级:数据库模型与类定义绑定,使得数据库字段的增删改与类变量的定义保持一致。
  • 全文搜索:WCDB提供易用的全文搜索接口,并包含多种语言的分词器。
  • 数据迁移:WCDB支持通过简单配置将数据从一个数据库迁移到另一个数据库。开发者无需关心迁移的中间状态和进度。
  • 数据压缩:WCDB支持通过简单配置,使用Zstd对数据库表中特定字段的内容进行压缩。一旦配置完成,数据压缩和解压缩的细节对开发者来说是透明的,WCDB可以自动压缩现有数据。

兼容性

WCDB拥有五种语言的接口:C++、Java、Kotlin、Swift和Objc。不同语言的接口共享相同的底层逻辑。WCDB的代码结构如下图所示:

在这种架构下,不同语言的WCDB可以拥有相同的接口结构和接口能力。在一个项目中,你可以使用一个WCDB用不同语言编写数据库代码。不同语言的数据库逻辑不会冲突。一些全局接口,如错误监控,可以同时作用于不同语言的数据库逻辑。

构建和安装

以下wiki包含了关于WCDB构建和安装的详细说明。

教程

不同语言的教程可以在以下链接找到:

贡献

如果你有兴趣贡献代码,请查看 [CONTRIBUTING.md],也可以加入我们的腾讯开源计划

信息公示

项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台,能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐,Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持,能够阅读和理解用户上传的文件内容,解析网页信息,并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题,Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型,免费访问各种图像生成与AI训练工具,从Stable Diffusion等基础模型开始,轻松实现创新图像生成。体验前沿的AI技术,推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器,它将改变您观看视频的方式!SubCat结合了先进的人工智能技术,为您提供即时视频字幕翻译,无论是本地视频还是网络流媒体,让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台,利用前沿AI技术,为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图,再到文案生成,美间让创意设计更简单、更高效。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号