共计 2870 个字符,预计需要花费 8 分钟才能阅读完成。
作者 | 弗拉德
起源 | 弗拉德(公众号: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
回调,还有onUpgrade
、onDowngrade
、onOpen
等回调。另外一个参数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
是要删除数据所在的表的名字 例如:testTablewhere
是一个字符串,示意的是要删除的表白语句 例如:”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
查看,并且能够下载下来运行并体验。