头图

【Flutter 3-4】Flutter进阶教程——数据持久化sqflite使用

作者 | 弗拉德
来源 | 弗拉德(公众号:fulade_me)

sqflite

数据持久化是在移动端开发中必不可少的技术手段。我们总是有一些用户信息,应用资源,列表数据等需要存储起来,这里我们主要来讲基于SQLite数据库的数据储存。
SQLite,是一款轻型的数据库。它的设计目标是嵌入式的,而且已经在很多嵌入式产品中使用了它,它占用资源非常的低,在嵌入式设备中,可能只需要几百K的内存就够了。更多详细信息可以参考:维基百科百度百科
Flutter已经帮助我们封装了操作SQLite的库,它就是:sqflite

集成sqflite库

使用sqflite第三方库需要我们在pubspec.yaml文件先添加库的名字和版本号
dependencies字段下添加:

sqflite: ^1.1.3

这里以1.1.3为例
添加完成后保存一下,VSCode默认会执行pub get帮我们把需要的库下载下来,同样我们也可以在项目根目录下执行pub get来手动拉取需要的库。

1. 创建本地数据文件

static Future<SqfliteManager> _initDataBase() async {
SqfliteManager manager = SqfliteManager();
String dbPath = await getDatabasesPath() + "/$sqlName";
if (manager.db == null) {
    manager.db = await openDatabase(
    dbPath,
    version: 1,
    onCreate: (db, version) async {
        /// 如果不存在 当前的表 就创建需要的表
        if (await manager.isTableExit(db, tableName) == false) {
        await db.execute(CREATE_DATA_TABLE);
        }
    },
    );
}
return manager;
}

首先我们通过getDatabasesPath()函数获取到本地保存数据库文件的路径,在此路径后面拼接上我们的数据库文件名字,就是保存数据库文件的路径。在iOS中该路径在沙河路径下的Documents文件夹内,在Android中时默认数据库目录。
之后我们声明一个Database对象,用来保存数据库操作对象

Database db;

先判断此对象是否存在,如果不存在我们调用openDatabase来创建
这里传入前面获取到的数据库地址,版本号,和onCreate回调函数。
onCreate回调内部判断是否存在我们需要使用的表名字,如果不存就执行创建数据库表的sql语句。

除了onCreate回调,还有onUpgradeonDowngradeonOpen等回调。另外一个参数singleInstance它表示当传入相同的数据库路径是否返回同一个的实例对象,默认是true

2. 插入数据

鉴于sqflite帮我们做了很多工作,所以在使用基本的也很简单

  /// 插入数据
  Future<int> insertData(Map<String, dynamic> value) async {
    return await db.insert(tableName, value);
  }

只需要传入表名字和要插入的数据就行
我们再来看一下insert函数的其他参数

Future<int> insert(String table, Map<String, dynamic> values,
      {String nullColumnHack, ConflictAlgorithm conflictAlgorithm});
  • nullColumnHack 是在传入的插入数据是空的时候 起到作用的

如果插入数据为空:
若不添加nullColumnHack则sql语句最终的结果将会类似insert into tableName()values(),这是不允许的。
若添加上nullColumnHack则sql语句将会变成insert into tableName (nullColumnHack)values(null),这是可以的。

  • conflictAlgorithm 是一个枚举,当插入的数据出现冲突或错误时,我们该使用哪种策略,有以下几个值
enum ConflictAlgorithm {
  rollback,
  abort,
  fail,
  ignore,
  replace,
}

3. 删除数据

删除数据的代码如下

  /// 删除一条数据
Future<int> deleteData(int id) async {
    return await db.delete(tableName, where: "id = ?", whereArgs: [id]);
}

来看一下详细的delete函数都有哪些参数:

Future<int> delete(String table, {String where, List<dynamic> whereArgs});
  • table是要删除数据所在的表的名字 例如:testTable
  • where是一个字符串,表示的是要删除的表达语句 例如:"id = ?"
  • whereArgs是一个数组,是用来补充where语句里面的?参数的 例如:[2]

当我们传入上面示例参数后,要标的意思就是:要删除testTable 表内 id = 2 的数据

4. 更新数据

删除数据代码如下

Future<int> updateData(Map<String, dynamic> value, int id) async {
    return await db.update(
        tableName,
        value,
        where: "id = ?",
        whereArgs: [id],
    );
}

详细的update函数如下

Future<int> update(String table, Map<String, dynamic> values,
      {String where,
      List<dynamic> whereArgs,
      ConflictAlgorithm conflictAlgorithm});

insert函数的参数基本一致,这里就不赘述了

5. 查询数据

直接来看查询语句的参数

Future<List<Map<String, dynamic>>> query(
    String table,  /// 表名字 是必传参数
    {bool distinct,  // 是否包含重复数据
    List<String> columns,  // 需要查询的列
    String where,       //  查询条件
    List<dynamic> whereArgs, // 查询条件参数
    String groupBy,  //按列分组 列的名字
    String having,   // 给分组设置条件
    String orderBy,   // 按列排序 asc/desc
    int limit,     // 限制查询结果数量
    int offset});  // 从第几条开始查询

查询语句的参数比较丰富,基本可以满足我们一些复杂场景的查询需求

好了,关于sqflite的使用就总结这些了。

想体验以上的示例的运行效果,可以到我的Github仓库项目flutter_app->lib->routes->sqflite_page.dart查看,并且可以下载下来运行并体验。


公众号

一生只有一个职业:学生

29 声望
6 粉丝
0 条评论
推荐阅读
【Flutter 3-5】Flutter进阶教程——在Flutter中使用Lottie动画
在移动开发中总是需要展示一些动画特效,作为程序员的我们并不是很擅长用代码做动画,即便是有些动画可以实现,在跨平台的过程中也会因为API的差异性导致动画在各个平台中展示的有差异。所以为了释放程序员的双手...

弗拉德阅读 4.7k

封面图
程序员英语学习指南
动机为什么程序员要学习英语?工作:我们每天接触的代码都是英文的、包括很多技术文档也是英文的学习:最新最前沿的技术最开始都是只有English版本就业:学好英语让你的就业范围扩大到全球,而不只限于国内目标读...

九旬6阅读 642

安卓逆向之破解某成人APP播放次数限制
某成人水果APP非VIP用户存在播放次数限制,每天只能播放3次。超过3次需要购买VIP。 由于过于贫穷,于是抽空,对其安卓APP进行了逆向分析,最终成功破解了其播放次数限制。

悖论3阅读 1.3k评论 3

封面图
iOSer 年度总结|晋升的逻辑是什么
2022年是疫情3年的一个“小尾巴”,但它一点也不小,因为它是3年内大家感受最深的一年,也是影响最大的一年。身边同事们换工作、周围见闻都可以印证这个结论。

杭城小刘6阅读 1.8k

封面图
这一次,解决Flutter Dialog的各种痛点!
4.0版本做了重大调整,迁移请参照: SmartDialog 3.x 迁移 4.0本文内容已更新,文中内容及其代码皆为4.0用法前言Q:你一生中闻过最臭的东西,是什么?A:我那早已腐烂的梦。兄弟萌!!!我又来了!这次,我能自信...

小呆呆6661阅读 3.4k

封面图
iOS 健康共享失败如何解决
您要开始与之共享的对象必须已经连同他们的 iCloud 账户邮箱一起保存在您的“通讯录”中(iCloud 账户邮箱即 iCloud 账户绑定的邮箱信息,不是强制要求 @iCloud.com 邮箱)。

岚哲阅读 7.2k

uni-app中安卓包检查更新、新版本下载、下载进度条显示功能实现
如果想要做一个app的话,可以有很多种选择方案,uni-app是其中的一个性价比高一些(坑多一些)的方案。本文记录一下,uni-app打安卓包以后,需要检查并下载更新,且显示进度条的功能。

水冗水孚2阅读 748

一生只有一个职业:学生

29 声望
6 粉丝
宣传栏