Flutter笔记: 在Flutter应用中使用SQLite数据库

简介: Flutter笔记: 在Flutter应用中使用SQLite数据库

Flutter笔记在Flutter应用中使用SQLite数据库(基于sqflite)


1. 概述

SQLite是一种轻量级的嵌入式关系型数据库管理系统,而在Flutter中,我们可以通过使用 sqflite 模块方便地进行SQLite数据库的操作。本文将介绍如何在Flutter应用中使用 sqflite 来进行数据库操作。如果你对ORM(对象关系映射)有兴趣,可以参考以下文章:

在接下来的内容中,我们将深入了解如何使用 sqflite 在Flutter应用中创建、查询、更新和删除数据库记录,以及如何执行异步操作和处理数据库版本升级。

2. 安装和配置 sqflite

在使用 sqflite 之前,我们需要将其添加为Flutter应用的依赖项,并在代码中导入相应的模块。

2.1 添加依赖

打开你的Flutter应用的 pubspec.yaml 文件,并在 dependencies 部分添加 sqflite 依赖:

dependencies:
  sqflite: ^2.3.0

这将使用指定版本的 sqflite 库。你可以通过 pub.dev 查看最新版本。

保存 pubspec.yaml 文件后,运行以下命令来获取依赖:

flutter pub get

如果你想直接安装最新版本亦可以通过运行下面的命令:

flutter pub add sqflite

这将在 pubspec.yaml 文件中添加最新版本作为依赖,并隐式的运行一个 flutter pub get 命令。

2.2 导入模块

在你的Dart文件中,导入 sqflite 模块:

import 'package:sqflite/sqflite.dart';
import 'package:path/path.dart';
// 其他导入...

以上是在Flutter应用中添加和配置 sqflite 的步骤。在接下来的部分,我们将深入研究如何使用 sqflite 进行数据库操作。

3. SQL 基础知识 和 SQLite 工具

3.1 创建表

在SQL中,我们使用CREATE TABLE语句来创建新的表。以下是创建表的示例代码:

CREATE TABLE my_table(
  id INTEGER PRIMARY KEY,
  name TEXT
);

在上面的SQL语句中,我们创建了一个名为my_table的表,它有两个字段:id和name。id字段是整数类型,并作为主键,name字段是文本类型。

3.2 插入数据

在上面的SQL语句中,我们使用INSERT INTO语句来插入新的数据。以下是插入数据的示例代码:

INSERT INTO my_table(id, name) VALUES(1, 'Jack');

在上面的SQL语句中,我们向my_table表插入了一条新的数据,id字段的值为1,name字段的值为’Jack’。

3.3 查询数据

在SQL中,我们使用SELECT语句来查询数据。以下是查询所有数据的示例代码:

SELECT * FROM my_table;

在上面的SQL语句中,我们查询了my_table表的所有数据。

3.4 更新数据

在SQL中,我们使用UPDATE语句来更新数据。以下是更新数据的示例代码:

UPDATE my_table SET name = 'Bob' WHERE id = 1;

在上面的SQL语句中,我们更新了my_table表中id字段为1的数据,将name字段的值改为’Bob’。

3.5 删除数据

在SQL中,我们使用DELETE FROM语句来删除数据。以下是删除数据的示例代码:

DELETE FROM my_table WHERE id = 1;

在上面的SQL语句中,我们删除了my_table表中id字段为1的数据。

3.6 数据库工具

SQLiteSpy 工具

SQLiteSpy 是一款免费的快速且紧凑的图形用户界面(GUI)工具,用于管理 SQLite 数据库,你可以自由地下载和使用。它的设计目标是使得 SQLite 数据库的开发和维护变得更加简单和轻松。SQLiteSpy 提供了丰富的功能,包括数据库结构查看、SQL 查询编辑器、数据导入/导出等。它还支持 SQLite 的所有数据类型,包括 BLOB。

下载地址:https://download.csdn.net/download/qq_28550263/88545032

在 Windows 上调试运行 Flutter 时,数据库文件位置在 项目根目录.dart_tool\sqflite_common_ffi\databases

Android Studio

可以可以在插件市场搜索一个你喜欢的SQLite插件:

然后打开 设备文件浏览器

然后在应用下找到数据库文件。

如果使用 Floor 的话,数据库时自动创建的。假设你的应用的包名是 my_app,那么你的应用的数据库文件应该位于 /data/data/com.example.my_app/databases/ 目录下。

双击后,数据库插件将在新的标签中打开:

(此处演示的表是空的,但是可以看到表的各个字段)

4. 创建数据库

4.1 定义数据库路径

首先,我们需要定义数据库文件的路径。在 AndroidiOS 上,我们通常将数据库文件存储在设备的文件系统中。我们可以使用 path_provider 库来获取这些路径。

首先,添加 path_provider 依赖到你的 pubspec.yaml 文件:

dependencies:
  flutter:
    sdk: flutter
  sqflite: any
  path_provider: any

然后,导入path_provider和sqflite库,并定义一个函数来获取数据库路径:

import 'package:path_provider/path_provider.dart';
import 'package:sqflite/sqflite.dart';
import 'dart:io' as io;
import 'package:path/path.dart';
// 定义一个异步函数来获取数据库路径
Future<String> getDatabasePath(String dbName) async {
  // 获取应用的文档目录
  final directory = await getApplicationDocumentsDirectory();
  // 拼接路径
  final path = join(directory.path, dbName);
  return path;
}

作为对比,以前介绍过 Floor 库。Floor 是一个基于 SQLiteORM 框架,它在底层使用了 sqflite 库。但是,Floor 框架已经封装了数据库路径的获取和数据库的创建,所以在使用 Floor 框架时,你不需要显式地使用 path_provider 库来获取数据库路径。

当你使用 Floor 框架创建数据库时,只需要提供数据库的名称,Floor 框架会自动为你处理数据库路径的问题。例如:

final database = await $FloorAppDatabase
  .databaseBuilder('app_database.db')
  .build();

4.2 创建数据库表

有了数据库路径,我们就可以创建数据库和表了。我们可以定义一个函数来创建数据库和表:

Future<Database> createDatabase() async {
  // 获取数据库路径
  final path = await getDatabasePath('my_db.db');
  // 打开数据库
  final database = openDatabase(
    path,
    version: 1,
    // 当数据库第一次被创建时,执行创建表的操作
    onCreate: (db, version) {
      return db.execute(
        "CREATE TABLE my_table(id INTEGER PRIMARY KEY, name TEXT)",
      );
    },
  );
  return database;
}

在上述代码中,我们首先调用openDatabase函数并传入数据库路径。如果数据库文件不存在,openDatabase函数会创建一个新的数据库文件。然后,我们定义了一个onCreate回调函数,当数据库第一次被创建时,这个函数会被调用。在这个函数中,我们执行了一个SQL语句来创建一个新的表my_table。

5. 插入数据

5.1 创建数据模型

在插入数据之前,我们通常会创建一个数据模型来表示我们的数据。以下是一个简单的数据模型示例:

class MyData {
  final int id;
  final String name;
  // 构造函数
  MyData({required this.id, required this.name});
  // 将MyData对象转换为Map
  Map<String, dynamic> toMap() {
    return {
      'id': id,
      'name': name,
    };
  }
}

在上述代码中,我们定义了一个MyData类,它有两个字段:id和name。我们还定义了一个toMap方法,它将MyData对象转换为一个Map,这样我们就可以将它插入到数据库中。

5.2 插入数据记录

有了数据模型,我们就可以插入数据到数据库中了。以下是插入数据的示例代码:

Future<void> insertData(MyData data, Database db) async {
  try {
    // 插入数据到数据库
    await db.insert(
      'my_table',
      data.toMap(),
      // 如果插入的数据与已有数据冲突(例如,两个数据有相同的主键),则替换旧数据
      conflictAlgorithm: ConflictAlgorithm.replace,
    );
  } catch (e) {
    // 打印错误信息
    print('Failed to insert data: $e');
  }
}

在上述代码中,我们定义了一个insertData函数,它接受一个MyData对象和一个Database对象。我们调用db.insert方法来插入数据。我们传入表名my_table,以及通过data.toMap()得到的Map。如果插入的数据与已有数据冲突(例如,两个数据有相同的主键),我们选择替换旧数据,这是通过设置conflictAlgorithm为ConflictAlgorithm.replace实现的。

6. 查询数据

6.1 执行查询操作

在sqflite中,我们可以使用query方法来执行查询操作。以下是查询所有数据的示例代码:

Future<List<Map<String, dynamic>>> queryAll(Database db) async {
  // 查询所有数据
  return await db.query('my_table');
}

在上述代码中,我们定义了一个queryAll函数,它接受一个Database对象,并返回一个包含所有数据的列表。我们调用db.query方法并传入表名my_table来查询所有数据。

6.2 处理查询结果

查询结果是一个Map的列表,每个Map代表一条数据记录。我们可以将这些Map转换为我们的数据模型。以下是处理查询结果的示例代码:

Future<List<MyData>> getMyDataFromDB(Database db) async {
  // 获取所有数据
  final List<Map<String, dynamic>> maps = await queryAll(db);
  // 将Map转换为MyData对象
  return List.generate(maps.length, (i) {
    return MyData(
      id: maps[i]['id'],
      name: maps[i]['name'],
    );
  });
}

在上述代码中,我们定义了一个getMyDataFromDB函数,它接受一个Database对象,并返回一个MyData对象的列表。我们首先调用queryAll函数来获取所有数据,然后使用List.generate方法来生成一个MyData对象的列表。在生成列表的过程中,我们从每个Map中获取id和name字段,并创建一个新的MyData对象。

7. 更新数据

7.1 更新数据记录

在sqflite中,我们可以使用update方法来更新数据。以下是更新数据的示例代码:

Future<void> updateData(MyData data, Database db) async {
  // 更新数据
  await db.update(
    'my_table',
    data.toMap(),
    // 指定哪些记录应该被更新
    where: "id = ?",
    whereArgs: [data.id],
  );
}

在上述代码中,我们定义了一个updateData函数,它接受一个MyData对象和一个Database对象。我们调用db.update方法来更新数据。我们传入表名my_table,以及通过data.toMap()得到的Map。我们还指定了where和whereArgs参数,以确定哪些记录应该被更新。在这个例子中,我们更新id字段等于data.id的记录。

7.2 验证更新结果

为了验证数据是否已经被更新,我们可以再次查询数据,并检查数据是否符合预期。以下是验证更新结果的示例代码:

Future<void> verifyUpdate(MyData data, Database db) async {
  // 从数据库中获取所有数据
  List<MyData> dataList = await getMyDataFromDB(db);
  // 遍历数据列表
  for (var item in dataList) {
    // 如果找到id与待验证数据id相同的数据项
    if (item.id == data.id) {
      // 断言其name字段与待验证数据的name字段相同
      assert(item.name == data.name);
    }
  }
}

在上述代码中,我们定义了一个verifyUpdate函数,它接受一个MyData对象和一个Database对象。我们首先调用getMyDataFromDB函数来获取所有数据,然后遍历数据列表,找到id字段等于data.id的记录,并检查其name字段是否等于data.name。如果等于,那么说明更新操作成功。

8. 删除数据

8.1 删除数据记录

在sqflite中,我们可以使用delete方法来删除数据。以下是删除数据的示例代码:

Future<void> deleteData(int id, Database db) async {
  // 调用delete方法删除指定id的数据
  await db.delete(
    'my_table',
    // where子句用于指定要删除的数据
    where: "id = ?",
    whereArgs: [id],
  );
}

在上述代码中,我们定义了一个deleteData函数,它接受一个id和一个Database对象。我们调用db.delete方法来删除数据。我们传入表名my_table,并指定where和whereArgs参数,以确定哪些记录应该被删除。在这个例子中,我们删除id字段等于给定id的记录。

8.2 验证删除结果

为了验证数据是否已经被删除,我们可以再次查询数据,并检查数据是否符合预期。以下是验证删除结果的示例代码:

Future<void> verifyDelete(int id, Database db) async {
  // 从数据库中获取所有数据
  List<MyData> dataList = await getMyDataFromDB(db);
  // 遍历数据列表
  for (var item in dataList) {
    // 断言每个数据项的id都不等于已删除的数据id
    assert(item.id != id);
  }
}

在上述代码中,我们定义了一个verifyDelete函数,它接受一个id和一个Database对象。我们首先调用getMyDataFromDB函数来获取所有数据,然后遍历数据列表,检查每个记录的id字段是否不等于给定的id。如果所有记录的id字段都不等于给定的id,那么说明删除操作成功。

9. 数据库版本升级

随着应用的发展,我们可能需要修改数据库的结构,例如添加新的表或修改现有的表。这就需要升级数据库版本。在sqflite中,我们可以在打开数据库时指定版本号,并提供一个onUpgrade回调函数来处理数据库升级。

9.1 定义新的数据库版本

以下是定义新的数据库版本的示例代码:

Future<Database> createDatabase() async {
  // 获取数据库路径
  final path = await getDatabasePath('my_db.db');
  // 打开数据库,指定新的版本号
  final database = openDatabase(
    path,
    version: 2, // 新的版本号
    onCreate: (db, version) {
      return db.execute(
        "CREATE TABLE my_table(id INTEGER PRIMARY KEY, name TEXT)",
      );
    },
    // 当数据库版本升级时,执行数据库升级操作
    onUpgrade: (db, oldVersion, newVersion) {
      // 处理数据库升级...
    },
  );
  return database;
}

在上述代码中,我们在openDatabase函数中指定了新的版本号。我们还提供了一个onUpgrade回调函数,当数据库版本升级时,这个函数会被调用。

9.2 执行数据库升级操作

以下是执行数据库升级操作的示例代码:

Future<Database> createDatabase() async {
  try {
    // 获取数据库路径
    final path = await getDatabasePath('my_db.db');
    // 打开数据库,指定新的版本号
    final database = openDatabase(
      path,
      version: 2,
      onCreate: (db, version) {
        // 创建表
        return db.execute(
          "CREATE TABLE my_table(id INTEGER PRIMARY KEY, name TEXT)",
        );
      },
      // 当数据库版本升级时,执行数据库升级操作
      onUpgrade: (db, oldVersion, newVersion) {
        // 如果旧版本号小于2,为my_table表添加一个新的列age
        if (oldVersion < 2) {
          // 执行SQL语句,修改my_table表,添加新的列age
          db.execute("ALTER TABLE my_table ADD COLUMN age INTEGER");
        }
      },
    );
    // 返回数据库实例
    return database;
  } catch (e) {
    // 打印错误信息
    print('Failed to open database: $e');
    // 抛出异常
    throw e;
  }
}

在上述代码中,我们在onUpgrade回调函数中执行了一个SQL语句来修改my_table表,添加了一个新的列age。我们只在旧版本号小于2时执行这个操作,这是因为如果用户已经在版本2或更高版本的数据库中,那么age列已经存在,无需再次添加。

目录
相关文章
|
3月前
|
开发框架 前端开发 Android开发
Flutter 与原生模块(Android 和 iOS)之间的通信机制,包括方法调用、事件传递等,分析了通信的必要性、主要方式、数据传递、性能优化及错误处理,并通过实际案例展示了其应用效果,展望了未来的发展趋势
本文深入探讨了 Flutter 与原生模块(Android 和 iOS)之间的通信机制,包括方法调用、事件传递等,分析了通信的必要性、主要方式、数据传递、性能优化及错误处理,并通过实际案例展示了其应用效果,展望了未来的发展趋势。这对于实现高效的跨平台移动应用开发具有重要指导意义。
334 4
|
9天前
|
前端开发 安全 开发工具
【11】flutter进行了聊天页面的开发-增加了即时通讯聊天的整体页面和组件-切换-朋友-陌生人-vip开通详细页面-即时通讯sdk准备-直播sdk准备-即时通讯有无UI集成的区别介绍-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
【11】flutter进行了聊天页面的开发-增加了即时通讯聊天的整体页面和组件-切换-朋友-陌生人-vip开通详细页面-即时通讯sdk准备-直播sdk准备-即时通讯有无UI集成的区别介绍-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
137 90
【11】flutter进行了聊天页面的开发-增加了即时通讯聊天的整体页面和组件-切换-朋友-陌生人-vip开通详细页面-即时通讯sdk准备-直播sdk准备-即时通讯有无UI集成的区别介绍-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
|
3月前
|
缓存 监控 前端开发
优化 Flutter 应用启动速度的策略,涵盖理解启动过程、资源加载优化、减少初始化工作、界面布局优化、异步初始化、预加载关键数据、性能监控与分析等方面
本文探讨了优化 Flutter 应用启动速度的策略,涵盖理解启动过程、资源加载优化、减少初始化工作、界面布局优化、异步初始化、预加载关键数据、性能监控与分析等方面,并通过案例分析展示了具体措施和效果,强调了持续优化的重要性及未来优化方向。
114 10
|
14天前
|
前端开发 Java Shell
【08】flutter完成屏幕适配-重建Android,增加GetX路由,屏幕适配,基础导航栏-多版本SDK以及gradle造成的关于fvm的使用(flutter version manage)-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
【08】flutter完成屏幕适配-重建Android,增加GetX路由,屏幕适配,基础导航栏-多版本SDK以及gradle造成的关于fvm的使用(flutter version manage)-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
115 20
【08】flutter完成屏幕适配-重建Android,增加GetX路由,屏幕适配,基础导航栏-多版本SDK以及gradle造成的关于fvm的使用(flutter version manage)-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
|
12天前
|
Dart 前端开发 Android开发
【09】flutter首页进行了完善-采用android studio 进行真机调试开发-增加了直播间列表和短视频人物列表-增加了用户中心-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
【09】flutter首页进行了完善-采用android studio 进行真机调试开发-增加了直播间列表和短视频人物列表-增加了用户中心-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
35 4
【09】flutter首页进行了完善-采用android studio 进行真机调试开发-增加了直播间列表和短视频人物列表-增加了用户中心-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
|
28天前
|
缓存 NoSQL JavaScript
Vue.js应用结合Redis数据库:实践与优化
将Vue.js应用与Redis结合,可以实现高效的数据管理和快速响应的用户体验。通过合理的实践步骤和优化策略,可以充分发挥两者的优势,提高应用的性能和可靠性。希望本文能为您在实际开发中提供有价值的参考。
55 11
|
2月前
|
人工智能 容灾 关系型数据库
【AI应用启航workshop】构建高可用数据库、拥抱AI智能问数
12月25日(周三)14:00-16:30参与线上闭门会,阿里云诚邀您一同开启AI应用实践之旅!
|
2月前
|
关系型数据库 MySQL 数据库
Python处理数据库:MySQL与SQLite详解 | python小知识
本文详细介绍了如何使用Python操作MySQL和SQLite数据库,包括安装必要的库、连接数据库、执行增删改查等基本操作,适合初学者快速上手。
375 15
|
3月前
|
传感器 前端开发 Android开发
在 Flutter 开发中,插件开发与集成至关重要,它能扩展应用功能,满足复杂业务需求
在 Flutter 开发中,插件开发与集成至关重要,它能扩展应用功能,满足复杂业务需求。本文深入探讨了插件开发的基本概念、流程、集成方法、常见类型及开发实例,如相机插件的开发步骤,同时强调了版本兼容性、性能优化等注意事项,并展望了插件开发的未来趋势。
67 2
|
24天前
|
关系型数据库 MySQL 数据库连接
数据库连接工具连接mysql提示:“Host ‘172.23.0.1‘ is not allowed to connect to this MySQL server“
docker-compose部署mysql8服务后,连接时提示不允许连接问题解决

热门文章

最新文章

  • 1
    【11】flutter进行了聊天页面的开发-增加了即时通讯聊天的整体页面和组件-切换-朋友-陌生人-vip开通详细页面-即时通讯sdk准备-直播sdk准备-即时通讯有无UI集成的区别介绍-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
  • 2
    【05】flutter完成注册页面完善样式bug-增加自定义可复用组件widgets-严格规划文件和目录结构-规范入口文件-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草央千澈
  • 3
    【08】flutter完成屏幕适配-重建Android,增加GetX路由,屏幕适配,基础导航栏-多版本SDK以及gradle造成的关于fvm的使用(flutter version manage)-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
  • 4
    当flutter react native 等混开框架-并且用vscode-idea等编译器无法打包apk,打包安卓不成功怎么办-直接用android studio如何打包安卓apk -重要-优雅草卓伊凡
  • 5
    【07】flutter完成主页-完成底部菜单栏并且做自定义组件-完整短视频仿抖音上下滑动页面-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草央千澈
  • 6
    【04】flutter补打包流程的签名过程-APP安卓调试配置-结构化项目目录-完善注册相关页面-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程
  • 7
    零基础构建即时通讯开源项目OpenIM移动端-Flutter篇
  • 8
    flutter3-dart3-dymall原创仿抖音(直播+短视频+聊天)商城app系统模板
  • 9
    【09】flutter首页进行了完善-采用android studio 进行真机调试开发-增加了直播间列表和短视频人物列表-增加了用户中心-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
  • 10
    【06】flutter完成注册页面-密码登录-手机短信验证-找回密码相关页面-并且实现静态跳转打包demo做演示-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草央千澈