如何在Flutter中使用SQFlite進行數據庫查詢

Question

如何使用SQFlite插件在Flutter中查詢來自SQLite數據庫的數據？

我最近一直在努力學習這個，所以我在下面添加我的答案作為一種幫助我學習的方法，並且作為未來其他人的快速參考。

Answer 1

添加依賴項

打開pubspec.yaml並在依賴項部分中添加以下行：

sqflite: ^1.0.0
path_provider: ^0.4.1

sqflite當然是SQFlite插件， path_provider將幫助我們獲取Android和iPhone上的用戶目錄。 您可以在此處查看最新版本號： sqflite和path_provider 。

創建一個數據庫助手類

我在單例類中保留了對數據庫的全局引用。 這將防止並發問題和數據泄漏。 您還可以在此處添加輔助方法（如查詢）以訪問數據庫。

創建一個名為database_helper.dart的新文件並粘貼以下代碼：

import 'dart:io' show Directory;
import 'package:path/path.dart' show join;
import 'package:sqflite/sqflite.dart';
import 'package:path_provider/path_provider.dart' show getApplicationDocumentsDirectory;

class DatabaseHelper {

  static final _databaseName = "MyDatabase.db";
  static final _databaseVersion = 1;

  static final table = 'my_table';

  static final columnId = '_id';
  static final columnName = 'name';
  static final columnAge = 'age';

  // make this a singleton class
  DatabaseHelper._privateConstructor();
  static final DatabaseHelper instance = DatabaseHelper._privateConstructor();

  // only have a single app-wide reference to the database
  static Database _database;
  Future<Database> get database async {
    if (_database != null) return _database;
    // lazily instantiate the db the first time it is accessed
    _database = await _initDatabase();
    return _database;
  }

  // this opens the database (and creates it if it doesn't exist)
  _initDatabase() async {
    Directory documentsDirectory = await getApplicationDocumentsDirectory();
    String path = join(documentsDirectory.path, _databaseName);
    return await openDatabase(path,
        version: _databaseVersion,
        onCreate: _onCreate);
  }

  // SQL code to create the database table
  Future _onCreate(Database db, int version) async {
    await db.execute('''
          CREATE TABLE $table (
            $columnId INTEGER PRIMARY KEY,
            $columnName TEXT NOT NULL,
            $columnAge INTEGER NOT NULL
          )
          ''');

    // prepopulate a few rows (consider using a transaction)
    await db.rawInsert('INSERT INTO $table ($columnName, $columnAge) VALUES("Bob", 23)');
    await db.rawInsert('INSERT INTO $table ($columnName, $columnAge) VALUES("Mary", 32)');
    await db.rawInsert('INSERT INTO $table ($columnName, $columnAge) VALUES("Susan", 12)');
  }
}

請注意，在創建數據庫時，我預先填充了幾行。 這樣我們就可以在下面的查詢示例中使用。

查詢數據

我們將使用異步方法來執行查詢，因為數據庫操作可能很昂貴。

獲取所有行

要執行SELECT *並返回表中的所有內容，只需傳入表名即可。

  _query() async {

    // get a reference to the database
    Database db = await DatabaseHelper.instance.database;

    // get all rows
    List<Map> result = await db.query(DatabaseHelper.table);

    // print the results
    result.forEach((row) => print(row));
    // {_id: 1, name: Bob, age: 23}
    // {_id: 2, name: Mary, age: 32}
    // {_id: 3, name: Susan, age: 12}
  }

獲得一行

我們可以為where參數傳遞一個參數，以選擇符合我們條件的特定行。 在此示例中，我們將查詢ID為1的行。

  _query() async {

    // get a reference to the database
    Database db = await DatabaseHelper.instance.database;

    // get single row
    List<String> columnsToSelect = [
      DatabaseHelper.columnId,
      DatabaseHelper.columnName,
      DatabaseHelper.columnAge,
    ];
    String whereString = '${DatabaseHelper.columnId} = ?';
    int rowId = 1;
    List<dynamic> whereArguments = [rowId];
    List<Map> result = await db.query(
        DatabaseHelper.table,
        columns: columnsToSelect,
        where: whereString,
        whereArgs: whereArguments);

    // print the results
    result.forEach((row) => print(row));
    // {_id: 1, name: Bob, age: 23}
  }

whereArguments列表中的項目取代了? 在whereString 。 在這種情況下，只有一個? 所以whereArguments只有一個項目。 如果有兩個? s（例如一個整數和一個字符串），那么你將在列表中有兩個項目。

原始查詢

如果您更喜歡SQL代碼本身的熟悉性或靈活性，則可以執行原始查詢。 在此示例中，我們將選擇name列為'Mary'任何行。

  _query() async {

    // get a reference to the database
    Database db = await DatabaseHelper.instance.database;

    // raw query
    List<Map> result = await db.rawQuery('SELECT * FROM my_table WHERE name=?', ['Mary']);

    // print the results
    result.forEach((row) => print(row));
    // {_id: 2, name: Mary, age: 32}
  }

一定要使用數據綁定? 字符串替換。 這將防止SQL注入攻擊。

筆記

• 如果您在另一個文件（如main.dart）中，則必須導入DatabaseHelper類和sqflite 。
• SQFlite插件使用Map<String, dynamic>將列名映射到每行中的數據。

補充代碼

為了方便您的復制和粘貼，這里是main.dart的布局代碼：

import 'package:flutter/material.dart';
// I called my project 'flutter_database_operations'. You can update for yours.
import 'package:flutter_database_operations/database_helper.dart';
import 'package:sqflite/sqflite.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'SQFlite Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatelessWidget {

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('sqflite'),
      ),
      body: RaisedButton(
        child: Text('query', style: TextStyle(fontSize: 20),),
        onPressed: () {_query();},
      ),
    );
  }

  _query() async {

    // get a reference to the database
    Database db = await DatabaseHelper.instance.database;

    // get all rows
    List<Map> result = await db.query(DatabaseHelper.table);

    // get single row
    //List<Map> result = await db.query(DatabaseHelper.table,
    //    columns: [DatabaseHelper.columnId, DatabaseHelper.columnName, DatabaseHelper.columnAge],
    //    where: '${DatabaseHelper.columnId} = ?',
    //    whereArgs: [1]);


    // raw query
    //List<Map> result = await db.rawQuery('SELECT * FROM my_table WHERE name=?', ['Mary']);

    // get each row in the result list and print it
    result.forEach((row) => print(row));
  }
}

繼續

• 這篇文章是我之前發表的一篇文章： Flutter中的簡單SQFlite數據庫示例 。 查看其他SQL操作和建議的帖子。