Flutter数据存储入门：简单教程详解

概述

Flutter数据存储入门旨在帮助开发者了解和掌握Flutter应用中的数据存储技术。本文详细介绍了SharedPreferences、SQLite数据库和文件存储三种主要的数据存储方式，并通过示例代码讲解了它们的基本操作方法。通过学习，开发者可以灵活选择最适合的数据存储方案，提升应用的用户体验和功能丰富度。

引入与概述

什么是Flutter数据存储

Flutter数据存储是指在Flutter应用程序中将数据保存到设备中，以便于后续使用或检索。Flutter提供了多种数据存储方式，包括SharedPreferences、SQLite数据库和文件存储。这些存储方式允许开发者根据具体需求灵活选择最适合的数据存储方案。

数据存储的重要性

数据存储在Flutter应用程序开发中具有重要地位。它可以确保应用程序在用户重新启动后仍能保持状态，从而提供更流畅的用户体验。此外，数据存储对于实现复杂的功能，例如用户偏好设置、登录状态、本地缓存等来说是必不可少的。因此，掌握数据存储技术可以帮助开发者创建更丰富、更实用的应用程序。

学习目标

本教程旨在帮助Flutter开发者入门Flutter数据存储技术。通过本文的学习，您将能够：

• 了解Flutter中常用的数据存储方式
• 掌握SharedPreferences的基本使用方法
• 学会SQLite数据库的基本操作
• 掌握文件存储的基本技巧

存储类型介绍

Shared Preferences简介

Shared Preferences 是 Flutter 中最常用的数据存储方式之一，适用于存储少量的键值对数据。这些数据通常用于存储用户偏好设置、登录状态等。Shared Preferences 使用简单，且无需配置任何数据库。这种方式非常适合存储少量、简单的数据。

SQLite数据库简介

SQLite 是一个轻量级、易于使用的数据库系统，非常适合在移动应用中使用。在 Flutter 中，我们可以通过 sqflite 包来实现 SQLite 数据库的创建、操作和管理。SQLite 适用于存储结构化的数据，特别适合需要保存大量记录和关系数据的应用。

文件存储简介

文件存储是指将数据保存为文件，这种方式适用于需要保存较大文件（如图片、视频等）或需要持久化存储的应用场景。在 Flutter 中，我们可以使用 dart:io 库来实现文件的读写操作。文件存储是一个灵活且强大的数据存储方式，可用于多种类型的文件操作。

Shared Preferences 实践

Shared Preferences 安装与配置

首先，我们需要在 Flutter 项目中安装 shared_preferences 包。可以在 pubspec.yaml 文件中添加如下依赖：

dependencies:
  flutter:
    sdk: flutter
  shared_preferences: ^2.0.6

然后运行 flutter pub get 命令来安装依赖。

基本数据类型和复杂数据类型的存储

基本数据类型的存储

在 Flutter 中，可以使用 SharedPreferences 类来保存基本的数据类型，如 int, double, bool, String。下面是一个示例代码，展示了如何存储和读取这些数据类型：

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

void main() async {
  runApp(MaterialApp(
    home: Scaffold(
      appBar: AppBar(
        title: Text('SharedPref Example'),
      ),
      body: Center(
        child: RaisedButton(
          onPressed: () async {
            SharedPreferences prefs = await SharedPreferences.getInstance();
            prefs.setInt('intKey', 123);
            prefs.setDouble('doubleKey', 123.45);
            prefs.setBool('boolKey', true);
            prefs.setString('stringKey', 'hello');
          },
          child: Text('Store Data'),
        ),
      ),
    ),
  ));
}

在这个示例中，我们使用 SharedPreferences 类的实例来存储不同类型的数据。

复杂数据类型的存储

对于复杂数据类型，如 Map 和 List，可以将其序列化为字符串，然后存储。以下示例展示了如何存储和读取 Map 和 List：

import 'dart:convert';
import 'package:flutter/material.dart';
import 'package:shared_preferences/shared_preferences.dart';

void main() async {
  runApp(MaterialApp(
    home: Scaffold(
      appBar: AppBar(
        title: Text('SharedPref Example'),
      ),
      body: Center(
        child: RaisedButton(
          onPressed: () async {
            SharedPreferences prefs = await SharedPreferences.getInstance();
            Map<String, dynamic> map = {'key': 'value'};
            List<String> list = ['item1', 'item2'];
            prefs.setString('mapKey', json.encode(map));
            prefs.setStringList('listKey', list);
          },
          child: Text('Store Complex Data'),
        ),
      ),
    ),
  ));
}

在这个示例中，我们使用 json.encode 将 Map 序列化为字符串，然后使用 prefs.setString 存储。对于 List，我们直接使用 prefs.setStringList 存储。

数据读取与删除

读取存储的数据：

import 'dart:convert';
import 'package:flutter/material.dart';
import 'package:shared_preferences/shared_preferences.dart';

void main() async {
  runApp(MaterialApp(
    home: Scaffold(
      appBar: AppBar(
        title: Text('SharedPref Example'),
      ),
      body: Center(
        child: RaisedButton(
          onPressed: () async {
            SharedPreferences prefs = await SharedPreferences.getInstance();
            int intVal = prefs.getInt('intKey');
            double doubleVal = prefs.getDouble('doubleKey');
            bool boolVal = prefs.getBool('boolKey');
            String stringVal = prefs.getString('stringKey');
            Map<String, dynamic> map = json.decode(prefs.getString('mapKey'));
            List<String> list = prefs.getStringList('listKey');
            print('int: $intVal, double: $doubleVal, bool: $boolVal, string: $stringVal, map: $map, list: $list');
          },
          child: Text('Read Data'),
        ),
      ),
    ),
  ));
}

删除数据：

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

void main() async {
  runApp(MaterialApp(
    home: Scaffold(
      appBar: AppBar(
        title: Text('SharedPref Example'),
      ),
      body: Center(
        child: RaisedButton(
          onPressed: () async {
            SharedPreferences prefs = await SharedPreferences.getInstance();
            prefs.remove('intKey');
            prefs.remove('doubleKey');
            prefs.remove('boolKey');
            prefs.remove('stringKey');
            prefs.remove('mapKey');
            prefs.remove('listKey');
          },
          child: Text('Delete Data'),
        ),
      ),
    ),
  ));
}

在这个示例中，我们使用 prefs.remove 方法来删除存储的数据。

SQLite数据库实践

SQLite数据库安装与配置

首先，在 pubspec.yaml 文件中添加 sqflite 和 path_provider 的依赖：

dependencies:
  flutter:
    sdk: flutter
  sqflite: ^2.0.0+3
  path_provider: ^2.0.5

然后运行 flutter pub get 命令来安装依赖。

数据库表的创建与操作

创建数据库表：

import 'package:flutter/material.dart';
import 'package:sqflite/sqflite.dart';
import 'package:path/path.dart';
import 'package:path_provider/path_provider.dart';

Future<void> createDatabase() async {
  final databasePath = await getApplicationDocumentsDirectory();
  final path = join(databasePath.path, 'test.db');
  await deleteDatabase(path); // 用于删除现有数据库
  final db = await openDatabase(path, version: 1, onCreate: (db, version) {
    db.execute('''
      CREATE TABLE test (
        id INTEGER PRIMARY KEY AUTOINCREMENT,
        title TEXT NOT NULL,
        description TEXT NOT NULL
      )
    ''');
  });
  print('Database created');
}

void main() {
  runApp(MaterialApp(
    home: Scaffold(
      appBar: AppBar(
        title: Text('SQLite Example'),
      ),
      body: Center(
        child: RaisedButton(
          onPressed: () async {
            await createDatabase();
          },
          child: Text('Create DB'),
        ),
      ),
    ),
  ));
}

在这个示例中，我们使用 sqflite 库创建了一个简单的 SQLite 数据库，并在其中创建了一个表 test。

数据的增删查改操作

插入数据：

Future<void> insertData(Database db) async {
  Map<String, dynamic> user = {
    'title': 'Flutter',
    'description': 'Flutter is a UI toolkit',
  };
  await db.insert('test', user);
  print('Data inserted');
}

void main() {
  runApp(MaterialApp(
    home: Scaffold(
      appBar: AppBar(
        title: Text('SQLite Example'),
      ),
      body: Center(
        child: RaisedButton(
          onPressed: () async {
            final databasePath = await getApplicationDocumentsDirectory();
            final path = join(databasePath.path, 'test.db');
            final db = await openDatabase(path, version: 1);
            await insertData(db);
          },
          child: Text('Insert Data'),
        ),
      ),
    ),
  ));
}

查询数据：

Future<void> queryData(Database db) async {
  final List<Map<String, dynamic>> maps = await db.query('test');
  for (Map<String, dynamic> map in maps) {
    print(map);
  }
}

void main() {
  runApp(MaterialApp(
    home: Scaffold(
      appBar: AppBar(
        title: Text('SQLite Example'),
      ),
      body: Center(
        child: RaisedButton(
          onPressed: () async {
            final databasePath = await getApplicationDocumentsDirectory();
            final path = join(databasePath.path, 'test.db');
            final db = await openDatabase(path, version: 1);
            await queryData(db);
          },
          child: Text('Query Data'),
        ),
      ),
    ),
  ));
}

删除数据：

Future<void> deleteData(Database db) async {
  await db.delete('test');
  print('Data deleted');
}

void main() {
  runApp(MaterialApp(
    home: Scaffold(
      appBar: AppBar(
        title: Text('SQLite Example'),
      ),
      body: Center(
        child: RaisedButton(
          onPressed: () async {
            final databasePath = await getApplicationDocumentsDirectory();
            final path = join(databasePath.path, 'test.db');
            final db = await openDatabase(path, version: 1);
            await deleteData(db);
          },
          child: Text('Delete Data'),
        ),
      ),
    ),
  ));
}

更新数据：

Future<void> updateData(Database db) async {
  await db.update(
    'test',
    {'description': 'Flutter is a UI toolkit for mobile apps'},
    where: 'id = ?',
    whereArgs: [1],
  );
  print('Data updated');
}

void main() {
  runApp(MaterialApp(
    home: Scaffold(
      appBar: AppBar(
        title: Text('SQLite Example'),
      ),
      body: Center(
        child: RaisedButton(
          onPressed: () async {
            final databasePath = await getApplicationDocumentsDirectory();
            final path = join(databasePath.path, 'test.db');
            final db = await openDatabase(path, version: 1);
            await updateData(db);
          },
          child: Text('Update Data'),
        ),
      ),
    ),
  ));
}

文件存储实践

文件存储介绍

文件存储是指将数据保存为文件，这种方式适合需要持久化存储的应用场景。在 Flutter 中，可以使用 dart:io 库来处理文件读写操作。文件存储适用于保存较大文件或复杂数据结构，如图片、视频等。

如何将数据保存到文件中

保存数据到文件：

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

void main() {
  runApp(MaterialApp(
    home: Scaffold(
      appBar: AppBar(
        title: Text('File Example'),
      ),
      body: Center(
        child: RaisedButton(
          onPressed: () async {
            final file = File('${(await getApplicationDocumentsDirectory()).path}/test.txt');
            await file.writeAsString('Hello, World!');
            print('File saved');
          },
          child: Text('Save File'),
        ),
      ),
    ),
  ));
}

在这个示例中，我们使用 dart:io 库中的 File 类来创建和写入文件。

从文件中读取数据

读取文件数据：

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

void main() {
  runApp(MaterialApp(
    home: Scaffold(
      appBar: AppBar(
        title: Text('File Example'),
      ),
      body: Center(
        child: RaisedButton(
          onPressed: () async {
            final file = File('${(await getApplicationDocumentsDirectory()).path}/test.txt');
            final content = await file.readAsString();
            print('File content: $content');
          },
          child: Text('Read File'),
        ),
      ),
    ),
  ));
}

在这个示例中，我们使用 dart:io 库中的 File 类来读取文件内容。

文件存储应用场景示例

保存用户上传的图片：

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

void main() {
  runApp(MaterialApp(
    home: Scaffold(
      appBar: AppBar(
        title: Text('File Example'),
      ),
      body: Center(
        child: RaisedButton(
          onPressed: () async {
            final file = File('${(await getApplicationDocumentsDirectory()).path}/user_profile.jpg');
            final bytes = await File("profile.jpg").readAsBytes();
            await file.writeAsBytes(bytes);
            print('Profile image saved');
          },
          child: Text('Save Image'),
        ),
      ),
    ),
  ));
}

总结与扩展

小结

本文通过详细介绍 Flutter 中的三种主要数据存储方式：Shared Preferences、SQLite 和文件存储，帮助开发者了解如何在 Flutter 应用程序中管理数据。通过示例代码，读者可以掌握基本的数据读写操作，为开发更加复杂的应用程序打下坚实的基础。

推荐学习资源

为了进一步深入学习 Flutter 数据存储技术，可以参考以下资源：

• Flutter 官方文档：详细介绍 Flutter 的基本概念和技术细节。
• Flutter 官方教程：涵盖 Flutter 的各个方面，包括数据存储、网络请求、状态管理等。
• 慕课网教程：提供丰富的 Flutter 课程资源，适合各个水平的开发者。

实际应用场景举例

用户偏好设置的应用场景示例

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

void main() async {
  runApp(MaterialApp(
    home: Scaffold(
      appBar: AppBar(
        title: Text('SharedPref Example'),
      ),
      body: Center(
        child: RaisedButton(
          onPressed: () async {
            SharedPreferences prefs = await SharedPreferences.getInstance();
            prefs.setInt('fontSize', 14);
            prefs.setString('theme', 'dark');
          },
          child: Text('Set User Preferences'),
        ),
      ),
    ),
  ));
}

本地缓存的应用场景示例

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

void main() async {
  runApp(MaterialApp(
    home: Scaffold(
      appBar: AppBar(
        title: Text('SharedPref Example'),
      ),
      body: Center(
        child: RaisedButton(
          onPressed: () async {
            SharedPreferences prefs = await SharedPreferences.getInstance();
            prefs.setString('token', 'your-token');
          },
          child: Text('Save Token'),
        ),
      ),
    ),
  ));
}

应用日志的应用场景示例

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

void main() {
  runApp(MaterialApp(
    home: Scaffold(
      appBar: AppBar(
        title: Text('File Example'),
      ),
      body: Center(
        child: RaisedButton(
          onPressed: () async {
            final file = File('${(await getApplicationDocumentsDirectory()).path}/log.txt');
            await file.writeAsString('Log entry 1');
            print('Log entry saved');
          },
          child: Text('Save Log Entry'),
        ),
      ),
    ),
  ));
}

文件上传的应用场景示例

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

void main() {
  runApp(MaterialApp(
    home: Scaffold(
      appBar: AppBar(
        title: Text('File Example'),
      ),
      body: Center(
        child: RaisedButton(
          onPressed: () async {
            final file = File('${(await getApplicationDocumentsDirectory()).path}/user_profile.jpg');
            final bytes = await File("profile.jpg").readAsBytes();
            await file.writeAsBytes(bytes);
            print('Profile image saved');
          },
          child: Text('Save Profile Picture'),
        ),
      ),
    ),
  ));
}

总之，掌握 Flutter 中的数据存储技术是构建高效、功能丰富的移动应用的关键。希望本文能够帮助开发者更好地理解和使用这些技术。