Flutter数据持久化

贺公子之数据科学与艺术

发布于 2025-12-18 08:50:45

200

数据持久化方法

在Flutter中，数据持久化主要通过文件、SharedPreferences和数据库三种方式实现。以下分别介绍这三种方法的具体实现和应用场景。

文件存储

文件存储适用于大量有序数据的持久化，如图片、文本等。Flutter提供了临时目录和文档目录两种存储路径选择。

临时目录用于存放不重要的临时缓存数据，应用重启后可能被清除。文档目录用于存放重要数据，仅在应用删除时清除。

文件读写操作需在异步环境下进行，并处理可能的异常。以下示例展示了文件读写的基本操作：

// 获取文件路径
Future<File> get _localFile async {
  final directory = await getApplicationDocumentsDirectory();
  final path = directory.path;
  return File('$path/content.txt');
}

// 写入文件
Future<File> writeContent(String content) async {
  final file = await _localFile;
  return file.writeAsString(content);
}

// 读取文件
Future<String> readContent() async {
  try {
    final file = await _localFile;
    String contents = await file.readAsString();
    return contents;
  } catch (e) {
    return "";
  }
}

SharedPreferences

SharedPreferences适用于少量键值对数据的持久化，如用户偏好设置或简单计数。其底层在iOS使用NSUserDefaults，在Android使用SharedPreferences。

以下示例展示了如何使用SharedPreferences存储计数器数据：

// 读取计数器值
Future<int> _loadCounter() async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  int counter = (prefs.getInt('counter') ?? 0);
  return counter;
}

// 递增计数器值
Future<void> _incrementCounter() async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  int counter = (prefs.getInt('counter') ?? 0) + 1;
  prefs.setInt('counter', counter);
}

数据库存储

数据库适用于大量结构化数据的持久化，特别是需要频繁更新的场景。Flutter推荐使用sqflite插件操作SQLite数据库。

以下示例展示了如何创建数据库表并操作Student对象：

// 定义Student类
class Student {
  String id;
  String name;
  int score;

  Student({this.id, this.name, this.score});

  // JSON转对象
  factory Student.fromJson(Map<String, dynamic> json) {
    return Student(
      id: json['id'],
      name: json['name'],
      score: json['score'],
    );
  }

  // 对象转JSON
  Map<String, dynamic> toJson() {
    return {'id': id, 'name': name, 'score': score};
  }
}

// 创建数据库
final Future<Database> database = openDatabase(
  join(await getDatabasesPath(), 'students_database.db'),
  onCreate: (db, version) {
    db.execute(
      'CREATE TABLE students(id TEXT PRIMARY KEY, name TEXT, score INTEGER)',
    );
  },
  version: 1,
);