Flutter数据库工具插件database_utils的使用

database_utils 是一个用于在 Flutter 应用中操作数据库的工具插件。它通常用于简化数据库操作，例如执行 SQL 查询、插入、更新和删除数据等。以下是如何在 Flutter 项目中使用 database_utils 插件的基本步骤。

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 database_utils 插件的依赖。

dependencies:
  flutter:
    sdk: flutter
  database_utils: ^1.0.0  # 请替换为最新的版本号

然后运行 flutter pub get 来获取依赖。

2. 初始化数据库

在使用 database_utils 之前，你需要初始化数据库。通常，你可以在应用的 main 函数中完成这项工作。

import 'package:database_utils/database_utils.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化数据库
  await DatabaseUtils.initialize(
    databaseName: 'my_database.db',
    version: 1,
    onCreate: (db, version) async {
      // 创建表
      await db.execute('''
        CREATE TABLE users (
          id INTEGER PRIMARY KEY AUTOINCREMENT,
          name TEXT,
          age INTEGER
        )
      ''');
    },
    onUpgrade: (db, oldVersion, newVersion) async {
      // 数据库升级逻辑
    },
  );
  
  runApp(MyApp());
}

3. 执行数据库操作

你可以使用 DatabaseUtils 提供的各种方法来执行数据库操作，例如插入、查询、更新和删除数据。

插入数据

void insertUser() async {
  final db = await DatabaseUtils.database;
  await db.insert(
    'users',
    {
      'name': 'John Doe',
      'age': 30,
    },
  );
}

查询数据

void queryUsers() async {
  final db = await DatabaseUtils.database;
  final List<Map<String, dynamic>> users = await db.query('users');
  
  for (var user in users) {
    print('User: ${user['name']}, Age: ${user['age']}');
  }
}

更新数据

void updateUser(int id) async {
  final db = await DatabaseUtils.database;
  await db.update(
    'users',
    {
      'name': 'Jane Doe',
      'age': 25,
    },
    where: 'id = ?',
    whereArgs: [id],
  );
}

删除数据

void deleteUser(int id) async {
  final db = await DatabaseUtils.database;
  await db.delete(
    'users',
    where: 'id = ?',
    whereArgs: [id],
  );
}

4. 关闭数据库

在应用退出时，建议关闭数据库连接以释放资源。

void closeDatabase() async {
  await DatabaseUtils.close();
}

5. 完整示例

以下是一个完整的示例，展示了如何在 Flutter 应用中使用 database_utils 插件。

import 'package:flutter/material.dart';
import 'package:database_utils/database_utils.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  await DatabaseUtils.initialize(
    databaseName: 'my_database.db',
    version: 1,
    onCreate: (db, version) async {
      await db.execute('''
        CREATE TABLE users (
          id INTEGER PRIMARY KEY AUTOINCREMENT,
          name TEXT,
          age INTEGER
        )
      ''');
    },
  );
  
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Database Utils Example'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              ElevatedButton(
                onPressed: insertUser,
                child: Text('Insert User'),
              ),
              ElevatedButton(
                onPressed: queryUsers,
                child: Text('Query Users'),
              ),
              ElevatedButton(
                onPressed: () => updateUser(1),
                child: Text('Update User'),
              ),
              ElevatedButton(
                onPressed: () => deleteUser(1),
                child: Text('Delete User'),
              ),
            ],
          ),
        ),
      ),
    );
  }

  void insertUser() async {
    final db = await DatabaseUtils.database;
    await db.insert(
      'users',
      {
        'name': 'John Doe',
        'age': 30,
      },
    );
  }

  void queryUsers() async {
    final db = await DatabaseUtils.database;
    final List<Map<String, dynamic>> users = await db.query('users');
    
    for (var user in users) {
      print('User: ${user['name']}, Age: ${user['age']}');
    }
  }

  void updateUser(int id) async {
    final db = await DatabaseUtils.database;
    await db.update(
      'users',
      {
        'name': 'Jane Doe',
        'age': 25,
      },
      where: 'id = ?',
      whereArgs: [id],
    );
  }

  void deleteUser(int id) async {
    final db = await DatabaseUtils.database;
    await db.delete(
      'users',
      where: 'id = ?',
      whereArgs: [id],
    );
  }
}