flutter中sqflite基本使用与注意点

前言

移动端数据库虽然不是特别常用,但肯定也是无法避免需要使用的,比如私聊聊天记录,比如历史记录,比如消息提醒等,flutter 你可以自建plugin,也可以使用三方的,本篇介绍的就是pub.dev中目前数据库使用排名第一的 sqflite,本文只是对 sqflite 的尝试,不对 sql 条件查询做过多的讲解.

sqlite 支持iOS,Android,MacOS

基础API 暂时先不讲解了,直接上代码,先用

1.把数据库抽成单例

static DBHelper get to => Get.find();

2.开启数据库

在用户登录成功后,及用户快速登录(从缓存中)成功后,开启数据库,(用户 id 做数据库,做用户数据隔离.)

open() async {
    if (!UserStore.to.isLogin) {
      return;
    }
    if (_db != null) {
      if (_db?.path.contains("${UserStore.current?.userId ?? 0}") ?? false) {
        // 如果_db 不为空,且与当前用户一致
        return;
      } else {
        _db?.close();
      }
    }
    final sqlFileName = "${UserStore.to.userId}.db";
    final path = "${await getDatabasesPath()}/$sqlFileName";
    print("~~~sql:$path");
    _db = await openDatabase(path, version: 3,
        onCreate: (Database db, int version) {
      db.execute("""
      CREATE TABLE If NOT EXISTS $_chatMessage (
        "id"    INTEGER NOT NULL,
        "userId"    INTEGER NOT NULL,
        "nickname"  TEXT,
        "content"   TEXT,
        PRIMARY KEY("id" AUTOINCREMENT)
      );
      """);
    }

3. 模拟器中数据库地址

/Users/suyikun/Library/Developer/CoreSimulator/Devices/0FE2E5FD-68AA-475D-841C-9D1DCE490F95/data/Containers/Data/Application/5B54CA08-BD78-4E54-A757-A18E8A29ACBA/Documents/200954533.db

4.插入数据

数据库操作 API 也算是十分简单 清晰了,具体大家真的用的时候直接看api就行了

Future<int> insert(Map<String, dynamic>? map) async {
    if (_db == null) {
      return Future.value(0);
    }
    if (map == null) {
      return Future.value(0);
    }
    int result = await _db!.insert(_chatMessage, map);
    return result;
  }

5.查询数据

查询提供了两种,一种是 sqlite 帮你拼接参数,一种是自己手写 sql 语句

反正底层都是走的_rawQuery(builder.sql, builder.arguments);,反正至少你得会基础的 sql 查询,分页,排序,条件查询等等.

Future<List<Map<String, dynamic>>> queryAll() async {
    if (_db == null) {
      return Future.value([]);
    }

    List<Map<String, dynamic>> list =
        await _db!.rawQuery("select * from $_chatMessage");
    return list;
  }

对应的数据库中数据

查询条件这个没啥好讲的,查询条件因人而已.只要你会mysql 即可.

升级数据库

十分不建议大量使用业务字段建立数据库字段,不要给自己和后来人挖抗.升级数据库在下图中展示,sqflite 升级数据库十分的麻烦,如果一定要升级,可以尝试下面我所展示的升级写法,建议业务中的数据结构,全部放在一个 text 字段中,比如 ext,做编解码成字符串处理数据.数据库字段只做必要的几个字段,比如 type,status,userId,create_time,update_time,sort 等等用于区分记录的字段,

升级完展示

sqflite 使用下来,就是这个升级太过麻烦,realm更改表结构比sqlite 简单的多,所以比较好更改表结构,但是,目前碰到的问题都是有办法解决的,多端的数据库实现>>>sqlite所支持的困难.