数据API 案例 开发者 关于
掌握聚合最新动态了解行业最新趋势
API接口,开发服务,免费咨询服务

为什么要从FMDB迁移到WCDB?

背景


WCDB 开源至今已两个月有余,我们在不断迭代功能、完善文档的同时,也与来自世界各地的开发者进行交流,帮助他们更快地了解、掌握 WCDB 。这其中,也不乏使用 FMDB 的开发者。他们正准备将项目的数据库模块改为 WCDB 。

对于一个已经上线运行的项目,数据库这类基础组件与业务的耦合通常较多,迁移有一定工作量的。因此,开发者通常会做很多预研,以确定是否进行迁移。

WCDB 在 Github 的 wiki 上提供了专门的教程,帮助使用FMDB的开发者进行迁移。同时,也希望通过本文全面地介绍 WCDB 和 FMDB 在使用方式、性能等方面的差异,以及迁移中可能遇到的问题,帮助开发者决定是否进行迁移。

平滑迁移


文件格式

由于 FMDB 和 WCDB 都基于 SQLite ,因此两者在数据库的文件格式上一致。用 FMDB 创建、操作的数据库,可以直接通过 WCDB 打开、使用。因此开发者无需做额外的数据迁移。

表结构

WCDB 提供了 ORM 的功能,将类的属性绑定到数据库表的字段。在日常实践中,类的属性名和表的字段名通常不一致。因此,WCDB 提供了 WCDB_SYNTHESIZE_COLUMN(className, propertyName, columnName) 宏,用于映射属性名。

对于

  • 表:CREATE TABLE message (db_id INTEGER, db_content TEXT)

  • 类:

这里表字段都加了"db_"的前缀,并且使用了不一样的字段名。通过 WCDB 的 ORM,可以映射为

通过 WCDB_SYNTHESIZE_COLUMN 宏映射后,WCDB 同样能兼容 FMDB 的表结构,开发者也不需要做数据迁移。

因此,开发者可以平滑地从 FMDB 迁移到 WCDB 。

性能比较


对于已经上线运行的项目,解决性能瓶颈会是一个常见的迁移理由。相较于 FMDB 直白的封装, WCDB 上到 OC 层的 ORM ,下到 SQLite 源码,都做了各类性能优化。

为了验证优化效果,我们提供了 benchmark ,并将性能测试结果和测试代码上传到了 Github 。同时, benchmark 中也加入了 FMDB 的测试代码,用于横向比较。

以下性能测试均为 WAL 模式、缓存大小2000字节、页大小 4 KB:

  • PRAGMA cache_size=-2000

  • PRAGMA page_size=4096

  • PRAGMA journal_mode=WAL

测试数据均为含有一个整型和一个二进制数据的表: CREATE TABLE benchmark(key INTEGER, value BLOB) ,二进制数据长度为 100 字节。

未命名1502876770.png

对于读操作,SQLite 速度很快,因此封装层的消耗占比较多。 FMDB 只做了最简单的封装, 而 WCDB 还包括 ORM 、 WINQ 等操作,因此执行的指令会比 FMDB 多,从而导致 WCDB 在读操作上性能劣于 FMDB 5% 。

而写操作通常是性能的瓶颈,我们重点对其做了许多针对性的优化,使得  WCDB 写操作优于 FMDB 28%、批量写操作优于 FMDB 180% 。

未命名1502876779.png

WCDB 多线程并发的优势,将读操作的性能劣势拉了回来,使得在 读操作 WCDB 的性能与 FMDB 基本持平 ,而 多线程读写性能则优于 FMDB 62% 。

在多线程写操作的测试中, FMDB 直接返回错误 SQLITE_BUSY,无法完成

初始化性能测试

SQLite 连接的初始化速度会随着数据库内表的数量增加而逐渐上升, WCDB 也针对这个场景做了优化。相较于没有优化的 FMDB , WCDB 的初始化速度有 107% 的性能优势

易用性比较


与已经上线运行项目不同,新项目更关注开发的效率。此时数据库的易用和便捷更重要。

对于等价的功能, WCDB 所需的代码量往往会比 FMDB 少很多。而更少的代码量通常意味着更快的开发效率和更少的错误。

基础操作

ORM 是现代客户端数据库比较普遍的功能。 CoreData 、 Realm 都支持 ORM , WCDB 也不例外。

FMDB 因其直白的封装,没有提供该功能。但在设计数据库表时,开发者通常会对数据进行建模。因此开发者只需将已有建模用 WCDB 的 ORM 表达出来即可。

对于在 FMDB 的一组定义:

  • 表:CREATE TABLE message (localID INTEGER PRIMARY KEY AUTOINCREMENT, content TEXT, createTime INTEGER, modfiedTime INTEGER)

  • 索引:CREATE INDEX message_index ON message(createTime)

  • 类:

WCDB需要对其建模,可以定义为

其中:

  • WCDB_IMPLEMENTATION(className) 用于定义进行绑定的类

  • WCDB_PROPERTY(propertyName) 和 WCDB_SYNTHESIZE(className, propertyName) 用于声明和定义字段。

  • WCDB_PRIMARY_AUTO_INCREMENT(className, propertyName) 用于定义主键且自增。

  • WCDB_INDEX(className, indexNameSubfix, propertyName) 用于定义索引。

虽然 WCDB 多了一步 ORM 的操作,但这是一劳永逸的,并且会给我们后续的使用带来很大的便利。

经过 ORM 的类,大部分操作都只需要一行代码即可完成。 Talk is cheap,直接看代码对比:

查询操作

插入操作

可以看到,

  • 对于查询操作, FMDB 需要进行很多拼装组合,而 WCDB 只需要一行代码就能完成。

  • 对于插入操作, FMDB 也只用了一行代码,但其需要将 property 逐个拆分为最基本的类型。而 WCDB 所需要关注的只有 object 和表名两个参数。

数据库升级

SQLite 的数据库升级一直是一个比较繁杂的问题。

通常的做法是,开发者自行定义一个版本号,并保存下来。数据库创建时每次检查版本号,若版本号较低,则对其字段进行升级,并更新版本号。但在多个版本的增增减减之后,版本的处理逻辑会越来越复杂,甚至可能弄错表内哪些字段是新增的,哪些是废弃的。

WCDB 将数据库升级和 ORM 结合起来,对于需要增删改的字段,只需直接在 ORM 层面修改,并再次调用 createTableAndIndexesOfName:withClass: 接口即可自动升级。以下是一个数据库升级的例子。

删除字段

如例子中的 createTime 字段,删除字段只需直接将 ORM 中的定义删除即可。

增加字段

如例子中的 aNewProperty 字段,增加字段只需直接添加 ORM 的定义即可。

修改字段类型

如例子中的 content 字段,字段类型可以直接修改,但需要确保新类型与旧类型兼容。

修改字段名称

如例子中的 aNewModifiedTime ,字段名称可以通过 WCDB_SYNTHESIZE_COLUMN(className, propertyName, columnName) 重新映射。

增加约束

如例子中的 WCDB_UNIQUE(Message, aNewModifiedTime) ,新的约束只需直接在 ORM 中添加即可。

增加索引

如例子中的 WCDB_INDEX(Message, "_newIndex", aNewProperty) ,新的索引只需直接在 ORM 添加。

多线程操作

WCDB 与 FMDB 都支持多线程操作。

在 FMDB 内,当开发者需要进行多线程操作时,需要使用另外一个类 FMDatabasePool来进行操作。

而 WCDB 基础的 CRUD 接口都支持多线程,因此开发者不需要额外关心线程安全的问题。同样的, WCDB 多线程使用的代码量也比 FMDB 少得多。

功能完整性比较


加密

WCDB 基于 SQLCipher 提供了加密功能

统计

WCDB 内提供统计的接口注册获取数据库操作的 SQL 、性能、错误等,开发者可以将这些信息打印到日志或上报到后台,以调试或统计

修复

WCDB 提供了数据库修复工具,以应对数据库损坏无法使用的极端情况。

总结


与 FMDB 对比, WCDB 使得开发者可以写更少的代码,但能获得更高的性能。开发者不需要额外关注数据库升级和多线程操作的问题。同时, WCDB 还提供了加密、统计、修复等功能。

因此,对于新项目,我们推荐使用 WCDB ,以获得更好的性能和开发效率。对于已经上线、稳定运行的项目,如果遇到性能瓶颈,或者对加密、统计、修复等功能有需求,我们建议参考 Github 上的文档进行迁移。

后续我们还将加入更多的功能,欢迎来 Github 关注我们。

原文来自: WeMobileDev

声明:所有来源为“聚合数据”的内容信息,未经本网许可,不得转载!如对内容有异议或投诉,请与我们联系。邮箱:marketing@think-land.com

掌握聚合最新动态了解行业最新趋势
API接口,开发服务,免费咨询服务
为什么要从FMDB迁移到WCDB?
发布:2017-08-16

背景


WCDB 开源至今已两个月有余,我们在不断迭代功能、完善文档的同时,也与来自世界各地的开发者进行交流,帮助他们更快地了解、掌握 WCDB 。这其中,也不乏使用 FMDB 的开发者。他们正准备将项目的数据库模块改为 WCDB 。

对于一个已经上线运行的项目,数据库这类基础组件与业务的耦合通常较多,迁移有一定工作量的。因此,开发者通常会做很多预研,以确定是否进行迁移。

WCDB 在 Github 的 wiki 上提供了专门的教程,帮助使用FMDB的开发者进行迁移。同时,也希望通过本文全面地介绍 WCDB 和 FMDB 在使用方式、性能等方面的差异,以及迁移中可能遇到的问题,帮助开发者决定是否进行迁移。

平滑迁移


文件格式

由于 FMDB 和 WCDB 都基于 SQLite ,因此两者在数据库的文件格式上一致。用 FMDB 创建、操作的数据库,可以直接通过 WCDB 打开、使用。因此开发者无需做额外的数据迁移。

表结构

WCDB 提供了 ORM 的功能,将类的属性绑定到数据库表的字段。在日常实践中,类的属性名和表的字段名通常不一致。因此,WCDB 提供了 WCDB_SYNTHESIZE_COLUMN(className, propertyName, columnName) 宏,用于映射属性名。

对于

  • 表:CREATE TABLE message (db_id INTEGER, db_content TEXT)

  • 类:

这里表字段都加了"db_"的前缀,并且使用了不一样的字段名。通过 WCDB 的 ORM,可以映射为

通过 WCDB_SYNTHESIZE_COLUMN 宏映射后,WCDB 同样能兼容 FMDB 的表结构,开发者也不需要做数据迁移。

因此,开发者可以平滑地从 FMDB 迁移到 WCDB 。

性能比较


对于已经上线运行的项目,解决性能瓶颈会是一个常见的迁移理由。相较于 FMDB 直白的封装, WCDB 上到 OC 层的 ORM ,下到 SQLite 源码,都做了各类性能优化。

为了验证优化效果,我们提供了 benchmark ,并将性能测试结果和测试代码上传到了 Github 。同时, benchmark 中也加入了 FMDB 的测试代码,用于横向比较。

以下性能测试均为 WAL 模式、缓存大小2000字节、页大小 4 KB:

  • PRAGMA cache_size=-2000

  • PRAGMA page_size=4096

  • PRAGMA journal_mode=WAL

测试数据均为含有一个整型和一个二进制数据的表: CREATE TABLE benchmark(key INTEGER, value BLOB) ,二进制数据长度为 100 字节。

未命名1502876770.png

对于读操作,SQLite 速度很快,因此封装层的消耗占比较多。 FMDB 只做了最简单的封装, 而 WCDB 还包括 ORM 、 WINQ 等操作,因此执行的指令会比 FMDB 多,从而导致 WCDB 在读操作上性能劣于 FMDB 5% 。

而写操作通常是性能的瓶颈,我们重点对其做了许多针对性的优化,使得  WCDB 写操作优于 FMDB 28%、批量写操作优于 FMDB 180% 。

未命名1502876779.png

WCDB 多线程并发的优势,将读操作的性能劣势拉了回来,使得在 读操作 WCDB 的性能与 FMDB 基本持平 ,而 多线程读写性能则优于 FMDB 62% 。

在多线程写操作的测试中, FMDB 直接返回错误 SQLITE_BUSY,无法完成

初始化性能测试

SQLite 连接的初始化速度会随着数据库内表的数量增加而逐渐上升, WCDB 也针对这个场景做了优化。相较于没有优化的 FMDB , WCDB 的初始化速度有 107% 的性能优势

易用性比较


与已经上线运行项目不同,新项目更关注开发的效率。此时数据库的易用和便捷更重要。

对于等价的功能, WCDB 所需的代码量往往会比 FMDB 少很多。而更少的代码量通常意味着更快的开发效率和更少的错误。

基础操作

ORM 是现代客户端数据库比较普遍的功能。 CoreData 、 Realm 都支持 ORM , WCDB 也不例外。

FMDB 因其直白的封装,没有提供该功能。但在设计数据库表时,开发者通常会对数据进行建模。因此开发者只需将已有建模用 WCDB 的 ORM 表达出来即可。

对于在 FMDB 的一组定义:

  • 表:CREATE TABLE message (localID INTEGER PRIMARY KEY AUTOINCREMENT, content TEXT, createTime INTEGER, modfiedTime INTEGER)

  • 索引:CREATE INDEX message_index ON message(createTime)

  • 类:

WCDB需要对其建模,可以定义为

其中:

  • WCDB_IMPLEMENTATION(className) 用于定义进行绑定的类

  • WCDB_PROPERTY(propertyName) 和 WCDB_SYNTHESIZE(className, propertyName) 用于声明和定义字段。

  • WCDB_PRIMARY_AUTO_INCREMENT(className, propertyName) 用于定义主键且自增。

  • WCDB_INDEX(className, indexNameSubfix, propertyName) 用于定义索引。

虽然 WCDB 多了一步 ORM 的操作,但这是一劳永逸的,并且会给我们后续的使用带来很大的便利。

经过 ORM 的类,大部分操作都只需要一行代码即可完成。 Talk is cheap,直接看代码对比:

查询操作

插入操作

可以看到,

  • 对于查询操作, FMDB 需要进行很多拼装组合,而 WCDB 只需要一行代码就能完成。

  • 对于插入操作, FMDB 也只用了一行代码,但其需要将 property 逐个拆分为最基本的类型。而 WCDB 所需要关注的只有 object 和表名两个参数。

数据库升级

SQLite 的数据库升级一直是一个比较繁杂的问题。

通常的做法是,开发者自行定义一个版本号,并保存下来。数据库创建时每次检查版本号,若版本号较低,则对其字段进行升级,并更新版本号。但在多个版本的增增减减之后,版本的处理逻辑会越来越复杂,甚至可能弄错表内哪些字段是新增的,哪些是废弃的。

WCDB 将数据库升级和 ORM 结合起来,对于需要增删改的字段,只需直接在 ORM 层面修改,并再次调用 createTableAndIndexesOfName:withClass: 接口即可自动升级。以下是一个数据库升级的例子。

删除字段

如例子中的 createTime 字段,删除字段只需直接将 ORM 中的定义删除即可。

增加字段

如例子中的 aNewProperty 字段,增加字段只需直接添加 ORM 的定义即可。

修改字段类型

如例子中的 content 字段,字段类型可以直接修改,但需要确保新类型与旧类型兼容。

修改字段名称

如例子中的 aNewModifiedTime ,字段名称可以通过 WCDB_SYNTHESIZE_COLUMN(className, propertyName, columnName) 重新映射。

增加约束

如例子中的 WCDB_UNIQUE(Message, aNewModifiedTime) ,新的约束只需直接在 ORM 中添加即可。

增加索引

如例子中的 WCDB_INDEX(Message, "_newIndex", aNewProperty) ,新的索引只需直接在 ORM 添加。

多线程操作

WCDB 与 FMDB 都支持多线程操作。

在 FMDB 内,当开发者需要进行多线程操作时,需要使用另外一个类 FMDatabasePool来进行操作。

而 WCDB 基础的 CRUD 接口都支持多线程,因此开发者不需要额外关心线程安全的问题。同样的, WCDB 多线程使用的代码量也比 FMDB 少得多。

功能完整性比较


加密

WCDB 基于 SQLCipher 提供了加密功能

统计

WCDB 内提供统计的接口注册获取数据库操作的 SQL 、性能、错误等,开发者可以将这些信息打印到日志或上报到后台,以调试或统计

修复

WCDB 提供了数据库修复工具,以应对数据库损坏无法使用的极端情况。

总结


与 FMDB 对比, WCDB 使得开发者可以写更少的代码,但能获得更高的性能。开发者不需要额外关注数据库升级和多线程操作的问题。同时, WCDB 还提供了加密、统计、修复等功能。

因此,对于新项目,我们推荐使用 WCDB ,以获得更好的性能和开发效率。对于已经上线、稳定运行的项目,如果遇到性能瓶颈,或者对加密、统计、修复等功能有需求,我们建议参考 Github 上的文档进行迁移。

后续我们还将加入更多的功能,欢迎来 Github 关注我们。

原文来自: WeMobileDev

声明:所有来源为“聚合数据”的内容信息,未经本网许可,不得转载!如对内容有异议或投诉,请与我们联系。邮箱:marketing@think-land.com

选择想要的接口, 看看能免费获取多少次调用 选择(单选)或填写想要的接口
  • 短信API服务
  • 银行卡四元素检测[简]
  • 身份证实名认证
  • 手机状态查询
  • 三网手机实名制认证[简]
  • 身份证OCR识别
  • 风险信息查询
  • 企业工商信息
短信API服务
  • 短信API服务
  • 银行卡四元素检测[简]
  • 身份证实名认证
  • 手机状态查询
  • 三网手机实名制认证[简]
  • 身份证OCR识别
  • 风险信息查询
  • 企业工商信息
  • 确定
选择您的身份
请选择寻找接口的目的
预计每月调用量
请选择预计每月调用量
产品研发的阶段
请选择产品研发的阶段
×

前往领取
×
企业用户认证,
可获得1000次免费调用
注册登录 > 企业账户认证 > 领取接口包
企业用户认证领取接口包 立即领取
× 企业用户认证,
可获得1000次免费调用,立即领取>
数 据 驱 动 未 来
Data Drives The Future