常用第三方库：sqflite数据库应用

原创已于 2025-04-27 21:15:26 修改 · 1.3k 阅读

15 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#flutter #开发语言 #android #ios

于 2025-04-27 21:12:29 首次发布

Flutter开发系统化学习指南专栏收录该内容

26 篇文章

订阅专栏

常用第三方库：sqflite数据库应用

一、基础概念

1.1 什么是sqflite？

sqflite是Flutter官方推荐的SQLite数据库插件，它提供了在Flutter应用中使用SQLite数据库的能力。SQLite是一个轻量级的、嵌入式的关系型数据库，特别适合移动应用场景。

1.2 主要特性

支持标准的SQL操作
支持事务和批量操作
支持数据库版本管理和升级
线程安全
支持Android和iOS平台

1.3 基本使用流程

添加依赖

dependencies:
  sqflite: ^2.3.0
  path: ^1.8.3

初始化数据库

final database = await openDatabase(
  join(await getDatabasesPath(), 'my_db.db'),
  onCreate: (db, version) {
    return db.execute(
      'CREATE TABLE tasks(id INTEGER PRIMARY KEY, title TEXT, description TEXT)',
    );
  },
  version: 1,
);

二、实战案例：待办事项管理系统

2.1 数据库设计

// 任务表结构
class Task {
  final int id;
  final String title;
  final String description;
  final bool isCompleted;
  final DateTime createdAt;

  Task({
    required this.id,
    required this.title,
    required this.description,
    this.isCompleted = false,
    required this.createdAt,
  });

  Map<String, dynamic> toMap() {
    return {
      'id': id,
      'title': title,
      'description': description,
      'isCompleted': isCompleted ? 1 : 0,
      'createdAt': createdAt.toIso8601String(),
    };
  }

  factory Task.fromMap(Map<String, dynamic> map) {
    return Task(
      id: map['id'],
      title: map['title'],
      description: map['description'],
      isCompleted: map['isCompleted'] == 1,
      createdAt: DateTime.parse(map['createdAt']),
    );
  }
}

2.2 数据库操作封装

class DatabaseHelper {
  static final DatabaseHelper instance = DatabaseHelper._init();
  static Database? _database;

  DatabaseHelper._init();

  Future<Database> get database async {
    if (_database != null) return _database!;
    _database = await _initDB('tasks.db');
    return _database!;
  }

  Future<Database> _initDB(String filePath) async {
    final dbPath = await getDatabasesPath();
    final path = join(dbPath, filePath);

    return await openDatabase(
      path,
      version: 1,
      onCreate: _createDB,
    );
  }

  Future<void> _createDB(Database db, int version) async {
    await db.execute('''
      CREATE TABLE tasks (
        id INTEGER PRIMARY KEY AUTOINCREMENT,
        title TEXT NOT NULL,
        description TEXT,
        isCompleted INTEGER NOT NULL,
        createdAt TEXT NOT NULL
      )
    ''');
  }

  // 增加任务
  Future<int> insertTask(Task task) async {
    final db = await database;
    return await db.insert('tasks', task.toMap());
  }

  // 查询所有任务
  Future<List<Task>> getAllTasks() async {
    final db = await database;
    final List<Map<String, dynamic>> maps = await db.query('tasks');
    return List.generate(maps.length, (i) => Task.fromMap(maps[i]));
  }

  // 更新任务
  Future<int> updateTask(Task task) async {
    final db = await database;
    return await db.update(
      'tasks',
      task.toMap(),
      where: 'id = ?',
      whereArgs: [task.id],
    );
  }

  // 删除任务
  Future<int> deleteTask(int id) async {
    final db = await database;
    return await db.delete(
      'tasks',
      where: 'id = ?',
      whereArgs: [id],
    );
  }
}

2.3 在UI中使用数据库

class TaskListScreen extends StatefulWidget {
  @override
  _TaskListScreenState createState() => _TaskListScreenState();
}

class _TaskListScreenState extends State<TaskListScreen> {
  final dbHelper = DatabaseHelper.instance;
  List<Task> tasks = [];

  @override
  void initState() {
    super.initState();
    _refreshTasks();
  }

  Future<void> _refreshTasks() async {
    final tasks = await dbHelper.getAllTasks();
    setState(() {
      this.tasks = tasks;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('待办事项')),
      body: ListView.builder(
        itemCount: tasks.length,
        itemBuilder: (context, index) {
          final task = tasks[index];
          return ListTile(
            title: Text(task.title),
            subtitle: Text(task.description),
            trailing: Checkbox(
              value: task.isCompleted,
              onChanged: (bool? value) async {
                final updatedTask = Task(
                  id: task.id,
                  title: task.title,
                  description: task.description,
                  isCompleted: value ?? false,
                  createdAt: task.createdAt,
                );
                await dbHelper.updateTask(updatedTask);
                _refreshTasks();
              },
            ),
          );
        },
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () => _showAddTaskDialog(context),
        child: Icon(Icons.add),
      ),
    );
  }
}

三、性能优化与最佳实践

3.1 数据库性能优化

使用事务处理批量操作

Future<void> batchInsertTasks(List<Task> tasks) async {
  final db = await database;
  await db.transaction((txn) async {
    for (var task in tasks) {
      await txn.insert('tasks', task.toMap());
    }
  });
}

合理使用索引

CREATE INDEX idx_created_at ON tasks(createdAt);

避免频繁的数据库操作

使用缓存机制
批量处理数据
延迟加载

3.2 数据库升级

Future<Database> _initDB(String filePath) async {
  final dbPath = await getDatabasesPath();
  final path = join(dbPath, filePath);

  return await openDatabase(
    path,
    version: 2, // 增加版本号
    onCreate: _createDB,
    onUpgrade: _onUpgrade,
  );
}

Future<void> _onUpgrade(Database db, int oldVersion, int newVersion) async {
  if (oldVersion < 2) {
    await db.execute('ALTER TABLE tasks ADD COLUMN priority INTEGER DEFAULT 0');
  }
}

3.3 安全性考虑

参数化查询防止SQL注入

Future<List<Task>> searchTasks(String keyword) async {
  final db = await database;
  final List<Map<String, dynamic>> maps = await db.query(
    'tasks',
    where: 'title LIKE ?',
    whereArgs: ['%$keyword%'],
  );
  return List.generate(maps.length, (i) => Task.fromMap(maps[i]));
}

数据加密

使用加密插件如sqlite_cipher
敏感数据加密存储

四、常见问题与解决方案

4.1 并发访问

使用单例模式管理数据库连接
合理使用事务
避免长时间占用数据库连接

4.2 内存管理

及时关闭数据库连接
避免大量数据一次性加载
使用分页加载

4.3 错误处理

Future<void> safeOperation() async {
  try {
    await database.transaction((txn) async {
      // 数据库操作
    });
  } catch (e) {
    print('数据库操作错误: $e');
    // 错误处理逻辑
  }
}