【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回调，还有 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是要删除数据所在的表的名字 例如：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查看，而且能够下载下来运行并体验。

---