前言
sqflite是一个轻量的关系型数据库,以表的形式将较为复杂的数据存储到.db文件中(数据库),同时支持安卓和IOS,简单数据可直接使用
shared_preferences
1. 准备工作
1.1 添加依赖:
在pubspec.yaml文件下添加
path_provider是用来处理路径相关的操作
dependencies:
sqflite: ^1.3.0+2
path_provider: ^1.6.9
1.2 安装
如果保存了有自动执行则最好,如果没有那么在终端运行flutter packages get命令
1.3 导入
import 'package:sqflite/sqflite.dart';
import 'package:path_provider/path_provider.dart';
1.4 注意
// SQLite支持的数据类型 不支持bool和DateTime
// SQL类型 ==== Dart类型
// integer ==== int
// real ==== num
// text ==== String
// blob ==== Uint8List
2. 使用流程
2.1 创建数据库
// 数据库文件路径:可以根据自己的需求自己定 这里使用的是外部存储可见的目录
// 可以将路径打印出来 在手机上找到它
String databasePath=(await getExternalStorageDirectory()).path+"/demo.db";
// 打开数据库 (若想数据库只能读取则使用openReadOnlyDatabase())
// 1 若数据库不存在 则创建数据库
// 2 若数据库存在 version大于当前数据库version 则升级
// 3 若数据库存在 version小于当前数据库version 则降级
// 4 若数据库存在 version等于当前数据库version 则不变
Database database=await openDatabase(databasePath,version: 2,
readOnly: false, // 是否只读
singleInstance: true, // 是否单例
// 第一个被调用的可选回调 配置数据库使用SQL语句配置
onConfigure: (Database database)async{
await database.execute("PRAGMA foreign_keys = ON");
print("配置数据库");
},
// 创建数据库回调
onCreate: (Database database,int version)async{
print("版本:$version 数据库创建成功");
},
// 数据库降级回调
onDowngrade: (Database database,int oldVersion,int newVersion)async{
print("版本$oldVersion 降级到 $newVersion");
},
// 数据库升级回调
onUpgrade: (Database database,int oldVersion,int newVersion)async{
print("版本$oldVersion 升级到 $newVersion");
},
// 数据库打开回调
onOpen: (Database database){
print("数据库打开成功");
},
);
2.2 创建数据表
// 使用execute方法执行SQL语句 注意:execute执行的SQL是没有返回值的
database.execute('CREATE TABLE Test (id INTEGER PRIMARY KEY, name TEXT, value INTEGER, age REAL)');
2.3 增删改查
2.3.1 where和whereArgs的使用
// 在查询和更新删除等语句中,会使用到where和whereArgs作为条件及条件参数
// 此处以查询为例 更新和删除请举一反三
// 查询test表中 name为zs并且age为18的记录
// where中 and代表并且(都满足) or代表或者(满足其一)
// where中的?为占位符 会依照顺序被后面whereArgs中的数据替换
await database.query('test',where:"name=? and age=?",whereArgs: ["zs",18]).then((value) => print(value));
2.3.2 插入数据
// 插入数据
//1.insert(表名,{"键":值},conflictAlgorithm(冲突算法:枚举类型)) 返回行数
database.insert('test',{"name":'zs',"age":18}).then((value) => print(value));
// 2. 使用SQL语句进行插入
// database.rawInsert("SQL语句");
2.3.3 删除数据
// 删除数据
// 1.delete("表名",where(条件),whereArgs(条件参数))
// 此处为寻找name为zs的记录
database.delete('test',where: "name=?",whereArgs: ["zs"]);
// 2. 使用SQL语句进行删除
// database.rawDelete("SQL语句");
2.3.4 更新数据
// 更新数据
// 1.update("表名",要修改的内容{'键':值},where(条件),whereArgs(条件参数),conflictAlgorithm(冲突算法:枚举类型))
// 将name为zs的记录的name改为ls,age改为18
database.update('test', {"name":'ls',"age":18},where: "name=?",whereArgs: ['zs']);
// 2.使用SQL语句进行更新
// database.rawUpdate("SQL语句");
2.3.5 查询数据
// 查询数据
// 1.query(表名,{distinct,columns(返回哪些字段),where(条件),
// whereArgs(条件参数),groupBy(分组),having(分组后的进行条件查询),
// orderBy(排序),limit(一次读几条),offset(起始位置)}) 返回读取到的结果(列表)
// 若没有查询条件 则返回这个表的数据
await database.query('test', //查询的表名
distinct: true, // 不重复
where:"value=? and age=?",whereArgs: [1,18], // 查询 value为1并且age为18的记录
columns: ["name","age"], // 返回的记录只包含name和age两个字段
groupBy: "age", // 根据age分组
orderBy: "age", // 根据age排序
limit: 10, // 一次读取10条记录
offset: 5 // 从第5条记录开始查询
);
// 2. 使用SQL语句进行查询
// database.rawQuery("SQL语句");
2.4 批处理 Batch
// 批处理SQL语句 往Batch中添加语句 但是这些语句并不会执行 需要调用commit方法 然后一次性执行
Batch batch=database.batch();
batch.insert("test",{"name":'ls'});
batch.insert("test",{"name":'ww'});
// noResult 是否不需要结果 continueOnError遇到异常是否继续执行
batch.commit(noResult: true,continueOnError: true).then((value) => print(value));
2.5 事务
// 事务
// 在事务中执行SQL语句 若发生异常 则进行回滚 即全部SQL语句无效
// 四大特征:
// 1. 原子性:即事务中的语句为一个整体 要么全部执行 要么全不执行
// 2. 一致性:保持数据的一致性 如转账 转账过后的总金额需要保持一致
// 3. 隔离性:多个事务并发时 互不干涉内部数据 处理的数据都是别的事务处理前或处理后的数据
// 4. 持久性:事务提交后 数据是持久不可更改的
database.transaction((txn)async{
// txn基本有database中所有的操作 基本可以当做database使用
txn.insert('test',{"name":'Rob'});
});
2.6 其他数据库操作
// 数据库是否打开
// print(database.isOpen);
// 获取默认数据库存放的路径
getDatabasesPath().then((value) => print("默认数据库路径"+value));
// 根据路径查看数据库是否存在
databaseExists(databasePath).then((value) => print("数据库是否存在:"+value.toString()));
// 设置数据库版本
database.setVersion(666);
// 获取数据库版本
database.getVersion().then((value) => print(value));
// 关闭数据库(数据库文件还在)
// database.close();
// 删除数据库(数据库文件不在)
// await deleteDatabase(databasePath);
根据官方文档和源码注解以及尝试所得,若有所帮,点赞一下
版权声明:本文为qq_41097495原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。