首页手记 Flutter数据存储教程：新手入门指南

Flutter数据存储教程：新手入门指南

标签：

数据库移动开发

概述

本文提供了详细的flutter数据存储教程，涵盖了SharedPreferences、SQLite数据库、Hive以及文件系统存储等多种数据存储方式。文章还介绍了数据存储的最佳实践和常见问题解决方案，帮助开发者更好地理解和应用Flutter中的数据存储技术。flutter数据存储教程从基础到高级应用，为读者提供了全面的指导。

引入Flutter数据存储

在开发Flutter应用时，数据存储是一个关键功能，它允许应用存储用户数据、配置信息、状态等。数据存储对于任何应用都至关重要，因为它确保了应用的持久性和用户数据的安全性。在移动应用开发中，数据存储的需求多种多样，例如存储用户偏好设置、登录状态、应用设置等。

本地数据存储介绍

本地数据存储是指在设备本地存储数据，这种存储方式通常包括SharedPreferences和SQLite数据库两种方式。

使用SharedPreferences

SharedPreferences是一种轻量级的键值对存储方案，适用于存储少量简单的数据，例如用户偏好设置、登录状态等。它具有简单易用和快速读写的特性。

概念介绍：
SharedPreferences允许你以键值对的形式存储和读取数据。键必须是String类型，而值可以是String、int、double、bool或null。

示例代码：
首先，在pubspec.yaml文件中添加依赖：

dependencies:
  flutter:
    sdk: flutter
  shared_preferences: ^2.0.8

接下来，创建一个简单的示例应用，存储和读取用户偏好设置：

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

void main() async {
  runApp(MaterialApp(
    home: MyApp(),
  ));
}

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _data = '未设置';

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

  _loadData() async {
    SharedPreferences prefs = await SharedPreferences.getInstance();
    String data = prefs.getString('data') ?? '未设置';
    setState(() {
      _data = data;
    });
  }

  _saveData(String data) async {
    SharedPreferences prefs = await SharedPreferences.getInstance();
    await prefs.setString('data', data);
    _loadData();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('SharedPreferences示例'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(_data),
            TextField(
              onChanged: (value) {
                _saveData(value);
              },
            ),
          ],
        ),
      ),
    );
  }
}

SQLite数据库的基础操作

对于更复杂的数据存储需求，可以使用SQLite数据库。SQLite是一个轻量级的关系型数据库，可以存储大量的数据，并且支持各种复杂的数据操作。

概念介绍：
SQLite数据库允许你创建表、插入数据、查询数据以及更新和删除数据。在Flutter中使用SQLite数据库，你需要引入sqflite插件。

示例代码：
首先，在pubspec.yaml文件中添加依赖：

dependencies:
  flutter:
    sdk: flutter
  sqflite: ^2.0.1+3

接下来，创建一个简单的示例应用，用于创建一个数据库表，并进行数据操作：

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

class DatabaseHelper {
  static final DatabaseHelper _databaseHelper = DatabaseHelper._internal();
  static Database _database;

  factory DatabaseHelper() => _databaseHelper;

  DatabaseHelper._internal();

  Future<Database> get database async {
    if (_database != null) return _database;
    _database = await _initDatabase();
    return _database;
  }

  Future<Database> _initDatabase() async {
    String path = await getDatabasesPath();
    return await openDatabase(
      join(path, 'example.db'),
      version: 1,
      onCreate: _onCreate,
    );
  }

  Future _onCreate(Database db, int version) async {
    await db.execute('''
      CREATE TABLE users (
        id INTEGER PRIMARY KEY,
        name TEXT,
        age INTEGER
      )
    ''');
  }

  Future<int> insertUser(Map<String, dynamic> user) async {
    Database db = await database;
    return await db.insert('users', user);
  }

  Future<List<Map<String, dynamic>>> getUsers() async {
    Database db = await database;
    return await db.query('users');
  }

  Future<int> updateUser(Map<String, dynamic> user) async {
    Database db = await database;
    return await db.update('users', user, where: 'id = ?', whereArgs: [user['id']]);
  }

  Future<int> deleteUser(int id) async {
    Database db = await database;
    return await db.delete('users', where: 'id = ?', whereArgs: [id]);
  }
}

void main() async {
  runApp(MaterialApp(
    home: MyApp(),
  ));
}

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  List<Map<String, dynamic>> _users = [];
  final TextEditingController _nameController = TextEditingController();
  final TextEditingController _ageController = TextEditingController();

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

  _fetchUsers() async {
    DatabaseHelper dbHelper = DatabaseHelper();
    List<Map<String, dynamic>> users = await dbHelper.getUsers();
    setState(() {
      _users = users;
    });
  }

  _saveUser() async {
    if (_nameController.text.isEmpty || _ageController.text.isEmpty) return;

    Map<String, dynamic> user = {
      'name': _nameController.text,
      'age': int.parse(_ageController.text),
    };

    DatabaseHelper dbHelper = DatabaseHelper();
    await dbHelper.insertUser(user);
    _fetchUsers();
    _nameController.clear();
    _ageController.clear();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('SQLite示例'),
      ),
      body: Padding(
        padding: EdgeInsets.all(16.0),
        child: Column(
          children: <Widget>[
            TextField(
              controller: _nameController,
              decoration: InputDecoration(labelText: '姓名'),
            ),
            TextField(
              controller: _ageController,
              decoration: InputDecoration(labelText: '年龄'),
            ),
            SizedBox(height: 16.0),
            ElevatedButton(
              onPressed: _saveUser,
              child: Text('保存用户'),
            ),
            SizedBox(height: 16.0),
            Expanded(
              child: ListView.builder(
                itemCount: _users.length,
                itemBuilder: (context, index) {
                  return ListTile(
                    title: Text('姓名: ${_users[index]['name']}'),
                    subtitle: Text('年龄: ${_users[index]['age']}'),
                  );
                },
              ),
            ),
          ],
        ),
      ),
    );
  }
}

使用Flutter插件进行数据存储

除了内置的SharedPreferences和SQLite，Flutter还提供了一些第三方插件，例如Hive。

Hive插件简介

Hive是一个轻量级的NoSQL数据库，可以在Flutter应用中方便地进行数据存储。它支持Key-Value存储以及复杂的数据模式（例如列表和映射）。Hive的特性包括高效的数据存储、跨平台支持和简单的API接口。

示例代码：
首先，在pubspec.yaml文件中添加依赖：

dependencies:
  flutter:
    sdk: flutter
  hive: ^2.0.4
  hive_flutter: ^1.0.0

接下来，创建一个简单的示例应用，使用Hive存储用户信息：

import 'package:flutter/material.dart';
import 'package:hive/hive.dart';
import 'package:hive_flutter/hive_flutter.dart';

void main() async {
  await Hive.initFlutter();
  await Hive.openBox('users');
  runApp(MaterialApp(
    home: MyApp(),
  ));
}

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final TextEditingController _nameController = TextEditingController();
  final TextEditingController _ageController = TextEditingController();
  Box<dynamic> _box;

  @override
  void initState() {
    super.initState();
    _box = Hive.box('users');
  }

  _saveUser() async {
    if (_nameController.text.isEmpty || _ageController.text.isEmpty) return;

    String name = _nameController.text;
    int age = int.parse(_ageController.text);

    // 将用户信息存储到Hive
    _box.put(name, age);
    _nameController.clear();
    _ageController.clear();
  }

  _fetchUsers() {
    List<dynamic> keys = _box.keys;
    List<Map<String, dynamic>> users = [];

    for (String key in keys) {
      users.add({'name': key, 'age': _box.get(key)});
    }

    return users;
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Hive示例'),
      ),
      body: Padding(
        padding: EdgeInsets.all(16.0),
        child: Column(
          children: <Widget>[
            TextField(
              controller: _nameController,
              decoration: InputDecoration(labelText: '姓名'),
            ),
            TextField(
              controller: _ageController,
              decoration: InputDecoration(labelText: '年龄'),
            ),
            SizedBox(height: 16.0),
            ElevatedButton(
              onPressed: _saveUser,
              child: Text('保存用户'),
            ),
            SizedBox(height: 16.0),
            Expanded(
              child: ListView.builder(
                itemCount: _fetchUsers().length,
                itemBuilder: (context, index) {
                  Map<String, dynamic> user = _fetchUsers()[index];
                  return ListTile(
                    title: Text('姓名: ${user['name']}'),
                    subtitle: Text('年龄: ${user['age']}'),
                  );
                },
              ),
            ),
          ],
        ),
      ),
    );
  }
}

文件系统数据存储

文件系统数据存储允许你将数据存储在本地文件系统中，例如创建文件和文件夹、读写文件内容等。文件系统存储适用于需要持久化存储大量数据的应用，例如日志文件、配置文件、用户生成的内容等。

文件系统的简介

Flutter中提供了文件系统访问权限，允许你读写文件。dart:io库提供了对文件系统的基本操作，例如创建文件、读写文件内容、删除文件等。

示例代码：
首先，创建一个简单的示例应用，读写文件内容：

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

void main() async {
  runApp(MaterialApp(
    home: MyApp(),
  ));
}

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final TextEditingController _textController = TextEditingController();
  String _content = '';

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('文件系统示例'),
      ),
      body: Padding(
        padding: EdgeInsets.all(16.0),
        child: Column(
          children: <Widget>[
            TextField(
              controller: _textController,
              decoration: InputDecoration(labelText: '文件内容'),
            ),
            SizedBox(height: 16.0),
            ElevatedButton(
              onPressed: _writeToFile,
              child: Text('写入文件'),
            ),
            SizedBox(height: 16.0),
            ElevatedButton(
              onPressed: _readFromFile,
              child: Text('读取文件'),
            ),
            SizedBox(height: 16.0),
            Text(_content),
          ],
        ),
      ),
    );
  }

  _writeToFile() async {
    String content = _textController.text;
    File file = File('data.txt');
    if (!await file.exists()) {
      file.createSync();
    }
    file.writeAsStringSync(content);
    _readFromFile();
  }

  _readFromFile() async {
    File file = File('data.txt');
    if (await file.exists()) {
      String content = await file.readAsString();
      setState(() {
        _content = content;
      });
    } else {
      setState(() {
        _content = '文件不存在';
      });
    }
  }
}

数据存储的最佳实践

数据存储是应用开发中的重要环节，除了选择合适的数据存储方式外，还需要考虑数据的安全性和性能。

数据安全性和隐私保护的基本概念

在存储用户数据时，需要考虑数据的安全性和隐私保护。对于敏感数据，应该使用加密方式进行存储。此外，还需要确保数据仅在需要时才被访问，例如通过权限控制来限制数据的访问范围。

示例代码：
下面是一个简单的示例，演示如何使用AES加密来保护存储的数据：

import 'dart:convert';
import 'dart:typed_data';
import 'package:encrypt/encrypt.dart' as encrypt;

void main() {
  // 创建一个密钥
  String key = "0a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p";
  List<int> keyBytes = utf8.encode(key);
  if (keyBytes.length != 16) throw Exception("Invalid key length");
  var key = encrypt.Key.fromLength(16);

  // 创建一个初始化向量
  var iv = encrypt.IV.fromLength(16);

  // 创建一个加密器
  var encrypter = encrypt.Encrypter(encrypt.AES(key));

  // 加密数据
  String plainText = "Hello, World!";
  var encrypted = encrypter.encrypt(plainText, iv: iv);
  print("Encrypted: ${encrypted.cipherText}");

  // 解密数据
  var decrypted = encrypter.decrypt(encrypted, iv: iv);
  print("Decrypted: $decrypted");
}

数据存储的性能优化技巧

性能优化对于大型数据集尤为重要。例如，可以使用索引来加速数据查询，避免不必要的数据读写操作，以及使用缓存来减少数据库访问的次数。

示例代码：
下面是一个简单的示例，演示如何使用SQLite数据库创建索引来加速数据查询：

import 'package:sqflite/sqflite.dart';
import 'dart:io';

class DatabaseHelper {
  static final DatabaseHelper _databaseHelper = DatabaseHelper._internal();
  static Database _database;

  factory DatabaseHelper() => _databaseHelper;

  DatabaseHelper._internal();

  Future<Database> get database async {
    if (_database != null) return _database;
    _database = await _initDatabase();
    return _database;
  }

  Future<Database> _initDatabase() async {
    String path = await getDatabasesPath();
    return await openDatabase(
      join(path, 'example.db'),
      version: 1,
      onCreate: _onCreate,
    );
  }

  Future _onCreate(Database db, int version) async {
    await db.execute('''
      CREATE TABLE users (
        id INTEGER PRIMARY KEY,
        name TEXT,
        age INTEGER
      )
    ''');
    await db.execute('''
      CREATE INDEX idx_name ON users(name)
    ''');
  }

  Future<int> insertUser(Map<String, dynamic> user) async {
    Database db = await database;
    return await db.insert('users', user);
  }

  Future<List<Map<String, dynamic>>> getUsersByName(String name) async {
    Database db = await database;
    return await db.query('users', where: 'name = ?', whereArgs: [name]);
  }
}

void main() async {
  runApp(MaterialApp(
    home: MyApp(),
  ));
}

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  List<Map<String, dynamic>> _users = [];
  final TextEditingController _nameController = TextEditingController();

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

  _fetchUsers() async {
    DatabaseHelper dbHelper = DatabaseHelper();
    List<Map<String, dynamic>> users = await dbHelper.getUsersByName(_nameController.text);
    setState(() {
      _users = users;
    });
  }

  _saveUser() async {
    if (_nameController.text.isEmpty) return;

    Map<String, dynamic> user = {
      'name': _nameController.text,
      'age': 25,
    };

    DatabaseHelper dbHelper = DatabaseHelper();
    await dbHelper.insertUser(user);
    _fetchUsers();
    _nameController.clear();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('SQLite索引示例'),
      ),
      body: Padding(
        padding: EdgeInsets.all(16.0),
        child: Column(
          children: <Widget>[
            TextField(
              controller: _nameController,
              decoration: InputDecoration(labelText: '姓名'),
            ),
            SizedBox(height: 16.0),
            ElevatedButton(
              onPressed: _saveUser,
              child: Text('保存用户'),
            ),
            SizedBox(height: 16.0),
            Expanded(
              child: ListView.builder(
                itemCount: _users.length,
                itemBuilder: (context, index) {
                  return ListTile(
                    title: Text('姓名: ${_users[index]['name']}'),
                    subtitle: Text('年龄: ${_users[index]['age']}'),
                  );
                },
              ),
            ),
          ],
        ),
      ),
    );
  }
}

常见问题与解决方案

在数据存储过程中，经常会遇到各种问题，包括数据丢失、性能问题、数据损坏等。了解这些问题的常见原因和解决方案可以帮助开发者更好地维护应用的稳定性和可靠性。

常见的数据存储错误及解决方法

数据丢失： 数据丢失通常是由异常写入或数据库崩溃引起的。确保在写入数据时捕获异常，并定期备份数据。
性能问题： 性能问题是由于数据库操作不当或索引不正确引起的。使用索引优化查询性能，并避免不必要的读写操作。
数据损坏： 数据损坏可能是由不正确的数据格式或编码引起的。确保数据的正确格式和编码，并在写入数据前进行验证。

示例代码：
下面是一个简单的示例，演示如何捕获异常并在写入数据时进行错误处理：

import 'package:sqflite/sqflite.dart';
import 'dart:io';

class DatabaseHelper {
  static final DatabaseHelper _databaseHelper = DatabaseHelper._internal();
  static Database _database;

  factory DatabaseHelper() => _databaseHelper;

  DatabaseHelper._internal();

  Future<Database> get database async {
    if (_database != null) return _database;
    _database = await _initDatabase();
    return _database;
  }

  Future<Database> _initDatabase() async {
    String path = await getDatabasesPath();
    return await openDatabase(
      join(path, 'example.db'),
      version: 1,
      onCreate: _onCreate,
    );
  }

  Future _onCreate(Database db, int version) async {
    await db.execute('''
      CREATE TABLE users (
        id INTEGER PRIMARY KEY,
        name TEXT,
        age INTEGER
      )
    ''');
  }

  Future<int> insertUser(Map<String, dynamic> user) async {
    Database db = await database;
    try {
      return await db.insert('users', user);
    } catch (e) {
      print("Error inserting user: $e");
      return -1;
    }
  }
}

void main() async {
  runApp(MaterialApp(
    home: MyApp(),
  ));
}

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final TextEditingController _nameController = TextEditingController();
  final TextEditingController _ageController = TextEditingController();

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

  _saveUser() async {
    if (_nameController.text.isEmpty || _ageController.text.isEmpty) return;

    Map<String, dynamic> user = {
      'name': _nameController.text,
      'age': int.parse(_ageController.text),
    };

    DatabaseHelper dbHelper = DatabaseHelper();
    int result = await dbHelper.insertUser(user);
    if (result != -1) {
      print("User saved successfully");
    } else {
      print("Failed to save user");
    }
    _nameController.clear();
    _ageController.clear();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('SQLite异常示例'),
      ),
      body: Padding(
        padding: EdgeInsets.all(16.0),
        child: Column(
          children: <Widget>[
            TextField(
              controller: _nameController,
              decoration: InputDecoration(labelText: '姓名'),
            ),
            TextField(
              controller: _ageController,
              decoration: InputDecoration(labelText: '年龄'),
            ),
            SizedBox(height: 16.0),
            ElevatedButton(
              onPressed: _saveUser,
              child: Text('保存用户'),
            ),
          ],
        ),
      ),
    );
  }
}

数据库迁移和数据版本控制

在应用开发过程中，数据库结构可能会发生变化，例如添加新的字段或修改字段类型。为了确保应用的兼容性和稳定性，需要进行数据库迁移和数据版本控制。

示例代码：
下面是一个简单的示例，演示如何通过版本控制进行数据库迁移：

import 'package:sqflite/sqflite.dart';
import 'dart:io';

class DatabaseHelper {
  static final DatabaseHelper _databaseHelper = DatabaseHelper._internal();
  static Database _database;

  factory DatabaseHelper() => _databaseHelper;

  DatabaseHelper._internal();

  Future<Database> get database async {
    if (_database != null) return _database;
    _database = await _initDatabase();
    return _database;
  }

  Future<Database> _initDatabase() async {
    String path = await getDatabasesPath();
    return await openDatabase(
      join(path, 'example.db'),
      version: 2,
      onCreate: _onCreate,
      onUpgrade: _onUpgrade,
    );
  }

  Future _onCreate(Database db, int version) async {
    await db.execute('''
      CREATE TABLE users (
        id INTEGER PRIMARY KEY,
        name TEXT,
        age INTEGER
      )
    ''');
  }

  Future _onUpgrade(Database db, int oldVersion, int newVersion) async {
    if (oldVersion < 2) {
      await db.execute('''
        ALTER TABLE users ADD COLUMN email TEXT
      ''');
    }
  }
}

void main() async {
  runApp(MaterialApp(
    home: MyApp(),
  ));
}

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final TextEditingController _nameController = TextEditingController();
  final TextEditingController _ageController = TextEditingController();
  final TextEditingController _emailController = TextEditingController();

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

  _saveUser() async {
    if (_nameController.text.isEmpty || _ageController.text.isEmpty || _emailController.text.isEmpty) return;

    Map<String, dynamic> user = {
      'name': _nameController.text,
      'age': int.parse(_ageController.text),
      'email': _emailController.text,
    };

    DatabaseHelper dbHelper = DatabaseHelper();
    int result = await dbHelper.insertUser(user);
    if (result != -1) {
      print("User saved successfully");
    } else {
      print("Failed to save user");
    }
    _nameController.clear();
    _ageController.clear();
    _emailController.clear();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('SQLite数据库迁移示例'),
      ),
      body: Padding(
        padding: EdgeInsets.all(16.0),
        child: Column(
          children: <Widget>[
            TextField(
              controller: _nameController,
              decoration: InputDecoration(labelText: '姓名'),
            ),
            TextField(
              controller: _ageController,
              decoration: InputDecoration(labelText: '年龄'),
            ),
            TextField(
              controller: _emailController,
              decoration: InputDecoration(labelText: '邮箱'),
            ),
            SizedBox(height: 16.0),
            ElevatedButton(
              onPressed: _saveUser,
              child: Text('保存用户'),
            ),
          ],
        ),
      ),
    );
  }
}

以上是关于Flutter数据存储的详细指南，涵盖了从基础知识到高级应用的各种场景。希望你能够通过这些示例代码和解释，更好地理解和应用Flutter中的数据存储技术。

点击查看更多内容

为 TA 点赞

若觉得本文不错，就分享一下吧！

评论

评论

共同学习，写下你的评论

评论加载中...

展开查看更多评论

作者其他优质文章

正在加载中

Qyouu

手记
篇

粉丝

88

获赞与收藏

414

关注作者，订阅最新文章

阅读免费教程

ThinkPHP 入门教程

28个小节 12401 124

PyCharm 编辑器教程

37个小节 26448 405

后端通用面试教程

41个小节 31204 346

推荐

评论

收藏

共同学习，写下你的评论



感谢您的支持，我会继续努力的～

扫码打赏，你说多少就多少

赞赏金额会直接到老师账户

支付方式

打开微信扫一扫，即可进行扫码打赏哦

今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与放弃机会

点击
抽奖

慕课手记新用户专享福利

恭喜你，你的运气太好了，居然抽中了 100个积分！

恭喜你，抽中了价值元的专栏！

太棒了，直接落到你账户里！

积分商城里的罗技鼠标、机械键盘、
Kindle 阅读器、小米平衡车
Apple iPad （10.2英寸）、大额优惠券
在等着你去兑换了噢

作者：

免费赠送

兑换码：1111222211 复制

优惠券可用于购买实战课、体系课
无门槛使用

先去看看，有什么好东西马上兑换我爱学习，选课去


热搜

最近搜索清空

Flutter数据存储教程：新手入门指南

引入Flutter数据存储

本地数据存储介绍

使用SharedPreferences

SQLite数据库的基础操作

使用Flutter插件进行数据存储

Hive插件简介

文件系统数据存储

文件系统的简介

数据存储的最佳实践

数据安全性和隐私保护的基本概念

数据存储的性能优化技巧

常见问题与解决方案

常见的数据存储错误及解决方法

数据库迁移和数据版本控制

阅读免费教程