flutter用mysql数据库 flutter数据库框架

转载

mob6454cc73e9a6 2023-12-20 07:03:41

文章标签 flutter用mysql数据库 flutter 数据库 ide 文章分类 MySQL 数据库

前言

Flutter 目前比较好用的 sqlite 数据库 orm 框架就是drift (以前叫作moor)，由于dart语言不支持反射，这个框架使用了dart代码生成器，自动生成代码。这个数据库框架的优点是支持全平台使用，此框架通过使用datr语言的 ffi 功能（相当于JAVA的jni）来调用 sqlite 动态库实现数据库操作，
Web平台是通过 wasm（浏览器可以运行的二进制文件，可由C、C++、rust、go 等语言编译而来）来调用sqlite, Web平台的sqlite数据库文件则通过 indexed db 虚拟文件系统保存。

官方文档

https://drift.simonbinder.eu/docs/platforms/

一.基本使用

先导入包

dependencies:
  drift: ^2.4.2
  sqlite3_flutter_libs: ^0.5.0
  #sqlcipher_flutter_libs: ^0.5.1
  path_provider: ^2.0.0
  path: ^1.8.2

dev_dependencies:
  drift_dev: ^2.4.1
  build_runner: ^2.3.3

对每个包的说明

drift: 这是定义大多数 api 的核心包。
sqlite3_flutter_libs: 提供 sqlite 动态库，如果要加密数据库，请使用sqlcipher_flutter_libs。
sqlcipher_flutter_libs: 提供 sqlcipher (加密版sqlite)
动态库，如果要加密数据库请添加此依赖，并移除sqlite3_flutter_libs依赖（共存会冲突）。
path_provider 和 path：用于寻找合适的位置来存放数据库。由 Flutter 和 Dart 团队维护。
drift_dev：drift自动生成代码工具、不会包含在最终应用程序中。
build_runner: 代码生成的通用工具，由 Dart 团队维护。

使用方式一：通过drift文件，编写数据库sql语句创建表和字段

创建一个名为student的drift文件 “student.drift”，并在文件中写入以下代码：创建一个学生表

CREATE TABLE student (
    id INT NOT NULL PRIMARY KEY AUTOINCREMENT,
    name TEXT
);

flutter用mysql数据库 flutter数据库框架_ide

创建文件db_manager.dart

import 'package:drift/drift.dart';
import 'dart:io';
import 'package:drift/native.dart';
import 'package:path_provider/path_provider.dart';
import 'package:path/path.dart' as p;
part 'db_manager.g.dart';//这里会报错，不过没关系，执行 flutter pub run build_runner build
@DriftDatabase(
  include: {'student.drift'},//引入表文件，多张表只需在这里添加即可
)
class DBManager extends _$DBManager {
  DBManager() : super(_openConnection());
  @override
  int get schemaVersion => 1;
}
LazyDatabase _openConnection() {
  return LazyDatabase(() async {
    final dbFolder = await getApplicationDocumentsDirectory();
    final file = File(p.join(dbFolder.path, 'test.db'));//数据库名字
    return NativeDatabase(file);
  });
}

编写增删改查方法

Future<List<StudentData>> getStudent() async {
    return await select(student).get();
  }

  Future<int> saveStudent(StudentCompanion companion) async {
    return await into(student).insert(companion);
  }

  Future<int> deleteEmployee(int id) async {
    return (delete(student)
      ..where(student.id.equals(id) as Expression<bool> Function(Student tbl)))
        .go();
  }

  Future<int> deleteAllEmployee() async {
    return await delete(student).go();
  }

  Future<int> updateEmployee(StudentCompanion companion) async {
    return await update(student).write(StudentCompanion(
        name: Value(companion.name as String?)
    ));
  }

运行下面代码，点击一下添加一条数据

import 'package:flutter/material.dart';
import 'package:flutter_lib/db/db_manager.dart';
import 'package:drift/drift.dart' as d;
DBManager? dbManager;
void main(){
  dbManager=DBManager();
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  // This widget is the root of your application.
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: Scaffold(
        body: Center(
          child: IconButton(
            icon: const Icon(Icons.thumb_up),
            onPressed: () => {
              dbManager!.saveStudent(
                const StudentCompanion(
                  name: d.Value("添加一条数据"),
                ),
              )
            },
          ),
        ),
      ),
    );
  }
}

可以看到生成了一个名为test的数据库

flutter用mysql数据库 flutter数据库框架_数据库_02

导出数据库文件，可以看到有张表student

flutter用mysql数据库 flutter数据库框架_ide_03

使用方式二：通过继承Table类，生成表和字段

创建employee.dart文件，写入以下代码

class Employee extends Table{
  IntColumn get id => integer().autoIncrement()();
  TextColumn get title => text().withLength(min: 6, max: 32)();
  TextColumn get content => text().named('body')();
  IntColumn get category => integer().nullable()();
}

创建db_manager.dart文件，写入以下代码

import 'package:drift/drift.dart';
import 'dart:io';
import 'package:drift/native.dart';
import 'package:flutter_lib/db/employee.dart';
import 'package:path_provider/path_provider.dart';
import 'package:path/path.dart' as p;

part 'db_manager.g.dart';//这里会报错，不过没关系，执行 flutter pub run build_runner build

@DriftDatabase(tables: [Employee])
class AppDatabase extends _$AppDatabase{
  AppDatabase() : super(_openConnection());

  @override
  int get schemaVersion => 1;
  //插入一条数据
  Future<int> saveEmployee(EmployeeData companion) async {
    return await into(employee).insert(companion);
  }
}

LazyDatabase _openConnection() {
  return LazyDatabase(() async {
    final dbFolder = await getApplicationDocumentsDirectory();
    final file = File(p.join(dbFolder.path, 'test.db'));
    return NativeDatabase(file);
    //return NativeDatabase.createInBackground(file);
  });
}

NativeDatabase.createInBackground(file)

用于在后台线程中创建一个数据库文件并返回一个数据库实例。它的主要作用是异步创建数据库文件，以避免在主线程中执行耗时的数据库创建操作，从而确保应用的响应性能。

二.初始化数据库

适合全局调用的方式如下，注意全局调用虽然方便，但也会带来不必要的开销。如果数据库使用场景不是很复杂，也可不必全局调用。

方式一：

AppDatabase? dbManager;
void main(){
  dbManager=AppDatabase();
  runApp(const MyApp());
}

方式二：使用provider库

创建db_manager.dart文件

@DriftDatabase(tables: [Employee])
class AppDatabase extends _$AppDatabase{
  AppDatabase(QueryExecutor e) : super(e);

  @override
  int get schemaVersion => 1;
}

编写DatabaseProvider

import 'package:flutter/material.dart';
import 'package:provider/provider.dart';
import 'package:drift/native.dart';

class DatabaseProvider extends StatelessWidget {
  final Widget child;
  DatabaseProvider({required this.child});

  @override
  Widget build(BuildContext context) {
    final database = AppDatabase(QueryExecutor.native(Isolate())..open('app_database.db'));

    return Provider<AppDatabase>(
      create: (_) => database,
      dispose: (_, db) => db.close(),
      child: child,
    );
  }
}

在顶层view中初始化

void main() {
  runApp(
    DatabaseProvider(
      child: MyApp(),
    ),
  );
}

程序中调用

final database = Provider.of<AppDatabase>(context);

三.实现一个简单的demo

demo功能如下图所示，实现数据库数据添加和删除

flutter用mysql数据库 flutter数据库框架_数据库_04

import 'dart:async';

import 'package:drift/drift.dart';
import 'package:flutter/material.dart';
import 'package:flutter_demo/db/db_manager.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  // This widget is the root of your application.
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const HomePage(),
    );
  }
}

class HomePage extends StatefulWidget {
  const HomePage({super.key});

  @override
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  final database = AppDatabase();
  final _tasksController = StreamController<List<EmployeeData>>();
  late StreamSubscription<List<EmployeeData>> _tasksSubscription;
  int count = 0;

  @override
  void initState() {
    super.initState();
    //监听数据库数据变化
    _tasksSubscription =
        database.select(database.employee).watch().listen((tasks) {
          _tasksController.add(tasks);
        });
  }

  @override
  void dispose() {
    _tasksSubscription.cancel();
    _tasksController.close();
    super.dispose();
  }
  //添加数据
  void addTask(String title) async {
    final task = EmployeeCompanion(
        title: Value(title),
        content: const Value('内容')
    );

    await database.into(database.employee).insert(task);
  }
  //删除数据
  void releaseTask(task) async{
    await database.delete(database.employee).delete(task);

  }

  // 封装 StreamBuilder 方法
  Widget buildTaskList(BuildContext context,
      AsyncSnapshot<List<EmployeeData>> snapshot) {
    if (snapshot.hasData) {
      final tasks = snapshot.data;
      return ListView.builder(
        itemCount: tasks?.length,
        itemBuilder: (context, index) {
          final task = tasks![index];
          return ListTile(
            title: Text(task.title),
            trailing: ElevatedButton(
              onPressed: () {
                releaseTask(task);
              },
              child: const Text('删除数据'),
            ),
          );
        },
      );
    } else if (snapshot.hasError) {
      return Text('Error: ${snapshot.error}');
    } else {
      return const CircularProgressIndicator();
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
        appBar: AppBar(
          title: const Text('数据库'),
        ),
        body: StreamBuilder<List<EmployeeData>>(
          stream: _tasksController.stream,
          builder: buildTaskList, // 使用封装的方法
        ),
        floatingActionButton: FloatingActionButton(
          onPressed: () {
            count++;
            addTask('添加第$count条数据');
          }, // 悬浮按钮上的图标
          backgroundColor: Colors.blue,
          child: const Icon(Icons.add), // 悬浮按钮的背景颜色
        )
    );
  }


}

四.数据库升级

如果表中需要添加字段，那么数据库需要升级，假如数据库版本从1升级到2，代码如下所示：

//表中添加新字段 dueDate 
class Employee extends Table{
  IntColumn get id => integer().autoIncrement()();
  TextColumn get title => text().withLength(min: 3, max: 32)();
  TextColumn get content => text().named('body')();
  IntColumn get category => integer().nullable()();
  DateTimeColumn get dueDate =>
      dateTime().nullable()(); // new, added column in v2
}

数据库管理修改如下：

@override
  int get schemaVersion => 2;
  @override
  MigrationStrategy get migration {
    return MigrationStrategy(
      onCreate: (Migrator m) async {
        await m.createAll();
      },
      onUpgrade: (Migrator m, int from, int to) async {
        if (from < 2) {
          // we added the dueDate property in the change from version 1 to
          // version 2
          await m.addColumn(employee, employee.dueDate);
        }
      },
    );
  }

本文章为转载内容，我们尊重原作者对文章享有的著作权。如有内容错误或侵权问题，欢迎原作者联系我们进行内容更正或删除文章。