Flutter数据库的使用方法

让我来为你详细讲解 Flutter 数据库的使用方法。

什么是 Flutter 数据库?

Flutter 数据库是 Flutter 开发中用来存储和管理数据的工具。Flutter 数据库有多种类型，包括轻量级的 key-value 数据库和基于关系的数据库（如 SQLite）。

如何使用 SQLite 数据库？

以下是在 Flutter 中使用 SQLite 数据库的步骤：

步骤1：添加 SQLite 依赖

在你的 pubspec.yaml 文件中，添加 sqflite 依赖项：

dependencies:
  flutter:
    sdk: flutter
  sqflite: ^1.2.2

步骤 2：在你的 Dart 代码中导入 sqflite 包

import 'package:sqflite/sqflite.dart';

步骤 3：创建数据库表

final String createTableQuery = '''
   CREATE TABLE contacts (
     id INTEGER PRIMARY KEY,
     name TEXT,
     phoneNumber TEXT,
   )
''';

步骤 4：打开数据库连接

final Future<Database> database = openDatabase(
  // Set the path to the database. Note: Using the `path` package is recommended!
  join(await getDatabasesPath(), 'contacts_database.db'),
  onCreate: (db, version) {
    // Create the contacts table
    return db.execute(createTableQuery);
  },
  version: 1,
);

步骤 5：插入数据

Future<void> insertContact(Contact contact) async {
  // Get a reference to the database
  final Database db = await database;

  // Insert the contact into the correct table
  await db.insert(
    'contacts',
    contact.toMap(),
    conflictAlgorithm: ConflictAlgorithm.replace,
  );
}

步骤 6：查询数据

Future<List<Contact>> getContacts() async {
  // Get a reference to the database
  final Database db = await database;

  // Query the table for all the contacts
  final List<Map<String, dynamic>> maps = await db.query('contacts');

  // Convert the List<Map<String, dynamic>> into a List<Contact>
  return List.generate(maps.length, (i) {
    return Contact(
      id: maps[i]['id'],
      name: maps[i]['name'],
      phoneNumber: maps[i]['phoneNumber'],
    );
  });
}

一个示例说明

现在，让我们使用一个示例来说明上述代码。我们假设您正在构建一个通讯录应用，并且希望使用 SQLite 数据库存储联系人。以下是联系人类的定义：

class Contact {
  int id;
  String name;
  String phoneNumber;

  Contact({this.id, this.name, this.phoneNumber});

  Map<String, dynamic> toMap() {
    return {
      'id': id,
      'name': name,
      'phoneNumber': phoneNumber,
    };
  }
}

然后我们可以将以下代码添加到组件中以创建数据库和表，并将联系人信息插入到表中：

void _submitForm() async {
  final Contact contact = Contact(
    name: _nameController.text,
    phoneNumber: _phoneController.text,
  );

  // Insert the contact into the database
  await insertContact(contact);

  // Clear the text fields
  _nameController.clear();
  _phoneController.clear();

  // Refresh the contact list
  setState(() {
    _contacts = await getContacts();
  });
}

接下来，您可以使用以下代码从表格中获取联系人信息，并将它们以列表的形式显示：

class ContactList extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return FutureBuilder<List<Contact>>(
      future: getContacts(),
      builder: (BuildContext context, AsyncSnapshot<List<Contact>> snapshot) {
        if (!snapshot.hasData) {
          return CircularProgressIndicator();
        }

        final List<Contact> contacts = snapshot.data;
        return ListView.builder(
          itemCount: contacts.length,
          itemBuilder: (context, index) {
            return ListTile(
              title: Text(contacts[index].name),
              subtitle: Text(contacts[index].phoneNumber),
            );
          },
        );
      },
    );
  }
}

另一个示例

以下是另一个使用 Flutter 数据库的示例，但这次是使用 Firebase 的 Cloud Firestore 数据库。在此示例中，我们假设您正在构建一个简单的任务管理器应用程序，并使用 Cloud Firestore 数据库存储任务。

步骤 1：添加 Firebase Core 和 Cloud Firestore 依赖项

在 pubspec.yaml 文件中，添加以下依赖项：

dependencies:
  flutter:
    sdk: flutter
  firebase_core: ^1.3.0
  cloud_firestore: ^2.4.0

步骤 2：在您的 Dart 代码中导入 Firebase 包

import 'package:firebase_core/firebase_core.dart';
import 'package:cloud_firestore/cloud_firestore.dart';

步骤 3：初始化 Firebase

在 main() 函数中初始化 Firebase：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();

  runApp(MyApp());
}

步骤 4：创建任务类

class Task {
  String id;
  String name;
  bool isComplete;

  Task({this.id, this.name, this.isComplete});

  Map<String, dynamic> toMap() {
    return {
      'id': id,
      'name': name,
      'isComplete': isComplete,
    };
  }
}

步骤 5：将任务添加到数据库

Future<void> addTask(Task task) async {
  // Get a reference to the firestore database
  final firestore = FirebaseFirestore.instance;

  // Add the task to the tasks collection
  final taskCollection = firestore.collection('tasks');
  await taskCollection.add(task.toMap());
}

步骤 6：获取所有任务

Stream<List<Task>> getTasks() {
  // Get a reference to the firestore database
  final firestore = FirebaseFirestore.instance;

  // Get a reference to the tasks collection
  final taskCollection = firestore.collection('tasks');

  // Listen for changes to the tasks collection
  return taskCollection.snapshots().map((snapshot) {
    // Convert the QuerySnapshot into a List<Task>
    return snapshot.docs.map((doc) {
      return Task(
        id: doc.id,
        name: doc['name'],
        isComplete: doc['isComplete'],
      );
    }).toList();
  });
}

步骤 7：将任务标记为已完成

Future<void> markTaskComplete(Task task) async {
  // Get a reference to the firestore database
  final firestore = FirebaseFirestore.instance;

  // Get a reference to the task document
  final taskDocument = firestore.collection('tasks').doc(task.id);

  // Update the isComplete field of the task document
  await taskDocument.update({'isComplete': true});
}