Flutter 本地数据库sqflite实战操作「建议收藏」

大家好，又见面了，我是你们的朋友全栈君。

Flutter 本地数据库sqflite实战操作

通过本文章将带你了解sqflite如何使用并管理，注意要学习本功能、要具备一定的sql数据库操作的基础知识！

知识点：

• 本地化列表数据
• 本地化列表详情数据
• sqflite 本地化数据库增删改查操作

一、安装sqflite

https://pub.flutter-io.cn/packages/sqflite

二、创建Db数据库文件夹，创建Db文件

文件夹路径：Lib/Db/StepTasksDb/StepTasksDb.dart

三、编辑Db文件

StepTasksDb.dart全部代码

import 'package:path/path.dart';
import 'package:sqflite/sqflite.dart';
// 定义数据库Mock模型
final String tableName = 'step_task_table';                       // 数据库名称
final String columnId = '_id';                                    // 索引id
final String columnType = 'step_listType';                        // 列表类型
final String columnStepListData = 'step_listData';                // 列表数据
final String columnStepDataDetails = 'step_status';               // 列表详情数据
// 定义模板模型类
class StepTasks { 

int id;
String stepListType;                                            // 列表类型
String stepListData;                                            // 列表数据
String stepDataDetails;                                         // 详情数据
StepTasks({ 
this.id, this.stepListType, this.stepListData, this.stepDataDetails});
// 模型转Map数据使用
Map<String, Object> toMap() { 

var map = <String ,Object>{ 

columnType:stepListType,
columnStepListData:stepListData,
columnStepDataDetails:stepDataDetails
};
if (id != null) { 

map[columnId] = id;
}
return map;
}
// 模型数据传入类中
StepTasks.fromMap(Map<String, Object> map){ 

id = map[columnId];
stepListType = map[columnType];
stepListData = map[columnStepListData];
stepDataDetails = map[columnStepDataDetails];
}
}
// 定义数据库
class StepTasksDb { 

Database db;
// 初始化数据库
Future<String> initDatabase() async { 

// 获取本地存储数据库路径
var databasesPath = await getDatabasesPath();
// 创建数据库db文件
String path = join(databasesPath, 'stepTasks.db');
return path;
}
// 打开并创建表
Future open(String path) async { 

print('------------------打开并创建表<StepTasksDb>------------------');
db = await openDatabase(path, version:1, onCreate:(Database db, int version) async { 

await db.execute('''
create table $tableName (
$columnId integer primary key autoincrement,
$columnType text ,
$columnStepListData text ,
$columnStepDataDetails text
)
''');
});
}
// 添加数据
Future<StepTasks> insert(StepTasks data) async { 

data.id = await db.insert(tableName, data.toMap());
return data;
}
// 获取数据(根据type条件查询)
Future<List> getData({ 
type = ''}) async { 

List<Map> maps = [];
maps = await db.query(tableName, columns:[columnId, columnType, columnStepListData, columnStepDataDetails], where: '$columnType = ?', whereArgs: [type]);
if(maps ==null || maps.length == 0){ 

return [];
}
List list = [];
for(int i = 0; i<maps.length; i++){ 

list.add(maps[i]);
}
return list;
}
// 修改数据（通过id匹配修改整个数据）
Future<int> update(StepTasks data) async { 

return await db.update(tableName, data.toMap(), where: '$columnId = ?', whereArgs: [data.id]);
}
// 删除数据（通过id匹配删除数据）
Future<int> delete(int id) async { 

return await db.delete(tableName, where:'$columnId = ?', whereArgs:[id]);
}
// 关闭此表的链接
Future close() async => db.close();
}

四、使用创建的数据库文件

注意：
首先安装网络监听插件：connectivity，虽然本插件已经停止更新了，但是在Pub官方文档也有新的插件替代了旧插件，大家可以凭个人需求来，这里不强求用什么插件，只需要达到网络监听效果即可。

import 'dart:convert';
import 'package:flutter/material.dart';
import 'TestDb_Flutter/Db/StepTasksDb/StepTasksDb.dart';
class TestDbPage extends StatefulWidget { 

@override
State<TestDbPage> createState() => _TestDbPageState();
}
class _TestDbPageState extends State<TestDbPage> { 

var listData = [];
var _storageListData = [];          // 存储本地数据
List cacheSelectList = [];          // 存储需要缓存的数据
var networkStatus = -1;			  // -1：没有网络 1：wifi 2：4G
StepTasksDb _stepTaskDb = StepTasksDb();
@override
void initState() { 
 
super.initState();
_initDatabase();
}
// 打开数据库
Future _initDatabase() async { 

String path = await _stepTaskDb.initDatabase();
// await File(path).delete(); // 删除表
await _stepTaskDb.open(path);       // 打开表
_getListData();
}
// 网络请求数据
Future _getListData() async { 

await _getStorageData();
if(networkStatus == 1){ 

var res = await api.request('https://xxx.xxxx/api');
setState((){ 
listData = res['data']})
return res;
}else{ 

// 没有网络的话
setState(() { 

_listData = _storageListData;
});
return _storageListData;
}
}
// 获取本地数据
Future _getStorageData() async { 

var data = await _stepTaskDb.getData(type: 'process');   
setState(() { 

_storageListData = data;           // 先赋值一次 以便添加时使用
});
}
@override
void dispose() { 

// 关闭数据库
_stepTaskDb.close();
super.dispose();
}
@override
Widget build(BuildContext context) { 

return ListView.builder(
itemCount: listData.length,
itemBuilder: (context, index){ 

return InkWell(
child:Container(child:Text(listData[index]['title']));
onTap:(){ 

// 创建要存储本地的数据
var dataBase = { 

'step_listData': json.encode(listData[index]),
};
// 请求详情的参数
var params = { 
id:'xxx'};
var res = await api.request('https://xxx.xxxx/api', formData: params);
// 不为空的话，证明拿到了正常数据，将其存储到要存储的数据参数中
if(res != null){ 

dataBase['assets_listDetails'] = json.encode(res['data']);
}
// 进行本地缓存
var db_res = await _stepTaskDb.insert(StepTasks(stepListType:'process', stepListData:dataBase['step_listData'], stepDataDetails:dataBase['assets_listDetails']));
},
onLongPress: (){ 

// 只在获取了本地存储的情况下，才能够通过id删除数据
_stepTaskDb.delete(v['_id']);
},
);
},
);
}
}

以上代码暂且只介绍了本地化操作的 增删查操作、至于修改操作，则和增操作大体类似，通过传入的本地数据id，来将新的数据替换掉旧的数据即可

例子：

var res = await _stepTaskDb.update(StepTasks(id:v['id'], stepListType:'process', stepListData:dataBase['listData'], stepDataDetails:dataBase['listDetails']));

目前为止，应该将最基本的增删改查操作介绍完了，并且附上了例子，如果不出大问题的话，大家应该可以达到本地化数据的操作，有问题请下方留言联系我~