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

弗拉德 2021/2/8 20:41:20

作者 | 弗拉德 来源 | 弗拉德 sqflite 数据持久化是在移动端开发中必不可少的技术手段。我们总是有一些用户信息,应用资源,列表数据等需要存储起来,这里我们主要来讲基于SQLite数据库的数据储存。 SQLite,是一款轻型的数据库。它的设计目标是嵌入式的,而且已经在很多…

作者 | 弗拉德

来源 | 弗拉德

sqflite

数据持久化是在移动端开发中必不可少的技术手段。我们总是有一些用户信息,应用资源,列表数据等需要存储起来,这里我们主要来讲基于SQLite数据库的数据储存。

SQLite,是一款轻型的数据库。它的设计目标是嵌入式的,而且已经在很多嵌入式产品中使用了它,它占用资源非常的低,在嵌入式设备中,可能只需要几百K的内存就够了。

Flutter已经帮助我们封装了操作SQLite的库,它就是:[sqflite] pub.dev/packages/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仓库] github.com/Johnson8888/learn_flutter 项目flutter_app->lib->routes->sqflite_page.dart查看,并且可以下载下来运行并体验。


随时随地学软件编程-关注百度小程序和微信小程序
关于找一找教程网

本站文章仅代表作者观点,不代表本站立场,所有文章非营利性免费分享。
本站提供了软件编程、网站开发技术、服务器运维、人工智能等等IT技术文章,希望广大程序员努力学习,让我们用科技改变世界。
[【Flutter 3-4】Flutter进阶教程——数据持久化sqflite使用]http://www.zyiz.net/tech/detail-151786.html

上一篇:【安卓开发】Android工程师必须知道的模块化开发

下一篇:在应用中导航时使用 SafeArgs | MAD Skills

赞(0)

共有 条评论 网友评论

验证码: 看不清楚?
    关注微信小程序
    程序员编程王-随时随地学编程

    扫描二维码或查找【程序员编程王】

    可以随时随地学编程啦!

    技术文章导航 更多>
    扫一扫关注最新编程教程