Flutter數(shù)據(jù)庫的使用方法

更新時間：2021年05月08日 09:34:37 作者：如此風景

這篇文章主要介紹了Flutter數(shù)據(jù)庫的使用方法，文中通過示例代碼介紹的非常詳細，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

說明

Flutter原生是沒有支持數(shù)據(jù)庫操作的，它使用SQLlit插件來使應(yīng)用具有使用數(shù)據(jù)庫的能力。其實就是Flutter通過插件來與原生系統(tǒng)溝通，來進行數(shù)據(jù)庫操作。

平臺支持

FLutter的SQLite插件支持IOS，安卓，和MacOS平臺
如果要對Linux / Windows / DartVM進行支持請使用sqflite_common_ffi
不支持web平臺
數(shù)據(jù)庫操作在安卓或ios的后臺執(zhí)行

使用案例

notepad_sqflite 可以在iOS / Android / Windows / linux / Mac上運行的簡單的記事本應(yīng)用

簡單使用

添加依賴

為了使用 SQLite 數(shù)據(jù)庫，首先需要導(dǎo)入 sqflite 和 path 這兩個 package

sqflite 提供了豐富的類和方法，以便你能便捷實用 SQLite 數(shù)據(jù)庫。
path 提供了大量方法，以便你能正確的定義數(shù)據(jù)庫在磁盤上的存儲位置。

dependencies:
  sqflite: ^1.3.0
  path:版本號

使用

導(dǎo)入 sqflite.dart

import 'dart:async';

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

打開數(shù)據(jù)庫
SQLite數(shù)據(jù)庫就是文件系統(tǒng)中的文件。如果是相對路徑，則該路徑是getDatabasesPath()所獲得的路徑，該路徑關(guān)聯(lián)的是Android上的默認數(shù)據(jù)庫目錄和iOS上的documents目錄。

var db = await openDatabase('my_db.db');

許多時候我們使用數(shù)據(jù)庫時不需要手動關(guān)閉它，因為數(shù)據(jù)庫會在程序關(guān)閉時被關(guān)閉。如果你想自動釋放資源，可以使用如下方式：

await db.close();

執(zhí)行原始的SQL查詢

使用getDatabasesPath()獲取數(shù)據(jù)庫位置

使用 sqflite package 里的 getDatabasesPath 方法并配合 path package里的 join 方法定義數(shù)據(jù)庫的路徑。使用path包中的join方法是確保各個平臺路徑正確性的最佳實踐。

var databasesPath = await getDatabasesPath();
String path = join(databasesPath, 'demo.db');

打開數(shù)據(jù)庫

Database database = await openDatabase(path, version: 1,
    onCreate: (Database db, int version) async {
  // 創(chuàng)建數(shù)據(jù)庫時創(chuàng)建表
  await db.execute(
      'CREATE TABLE Test (id INTEGER PRIMARY KEY, name TEXT, value INTEGER, num REAL)');
});

增

在事務(wù)中向表中插入幾條數(shù)據(jù)

await database.transaction((txn) async {
  int id1 = await txn.rawInsert(
      'INSERT INTO Test(name, value, num) VALUES("some name", 1234, 456.789)');
  print('inserted1: $id1');
  int id2 = await txn.rawInsert(
      'INSERT INTO Test(name, value, num) VALUES(?, ?, ?)',
      ['another name', 12345678, 3.1416]);
  print('inserted2: $id2');
});

刪

刪除表中的一條數(shù)據(jù)

count = await database
    .rawDelete('DELETE FROM Test WHERE name = ?', ['another name']);

改

修改表中的數(shù)據(jù)

int count = await database.rawUpdate('UPDATE Test SET name = ?, value = ? WHERE name = ?',
    ['updated name', '9876', 'some name']);
print('updated: $count');

查

查詢表中的數(shù)據(jù)

// Get the records
List<Map> list = await database.rawQuery('SELECT * FROM Test');
List<Map> expectedList = [
  {'name': 'updated name', 'id': 1, 'value': 9876, 'num': 456.789},
  {'name': 'another name', 'id': 2, 'value': 12345678, 'num': 3.1416}
];
print(list);
print(expectedList);

查詢表中存儲數(shù)據(jù)的總條數(shù)

count = Sqflite.firstIntValue(await database.rawQuery('SELECT COUNT(*) FROM Test'));

關(guān)閉數(shù)據(jù)庫

await database.close();

刪除數(shù)據(jù)庫

await deleteDatabase(path);

使用SQL助手

創(chuàng)建表中的字段及關(guān)聯(lián)類

//字段
final String tableTodo = 'todo';
final String columnId = '_id';
final String columnTitle = 'title';
final String columnDone = 'done';

//對應(yīng)類
class Todo {
  int id;
  String title;
  bool done;

  //把當前類中轉(zhuǎn)換成Map，以供外部使用
  Map<String, Object?> toMap() {
    var map = <String, Object?>{
      columnTitle: title,
      columnDone: done == true ? 1 : 0
    };
    if (id != null) {
      map[columnId] = id;
    }
    return map;
  }
  //無參構(gòu)造
  Todo();
  
  //把map類型的數(shù)據(jù)轉(zhuǎn)換成當前類對象的構(gòu)造函數(shù)。
  Todo.fromMap(Map<String, Object?> map) {
    id = map[columnId];
    title = map[columnTitle];
    done = map[columnDone] == 1;
  }
}

使用上面的類進行創(chuàng)建刪除數(shù)據(jù)庫以及數(shù)據(jù)的增刪改查操作。

class TodoProvider {
  Database db;

  Future open(String path) async {
    db = await openDatabase(path, version: 1,
        onCreate: (Database db, int version) async {
      await db.execute('''
  create table $tableTodo ( 
  $columnId integer primary key autoincrement, 
  $columnTitle text not null,
  $columnDone integer not null)
                        ''');
    });
  }

  //向表中插入一條數(shù)據(jù)，如果已經(jīng)插入過了，則替換之前的。
  Future<Todo> insert(Todo todo) async {
    todo.id = await db.insert(tableTodo, todo.toMap()，conflictAlgorithm: ConflictAlgorithm.replace,);
    return todo;
  }

  Future<Todo> getTodo(int id) async {
    List<Map> maps = await db.query(tableTodo,
        columns: [columnId, columnDone, columnTitle],
        where: '$columnId = ?',
        whereArgs: [id]);
    if (maps.length > 0) {
      return Todo.fromMap(maps.first);
    }
    return null;
  }

  Future<int> delete(int id) async {
    return await db.delete(tableTodo, where: '$columnId = ?', whereArgs: [id]);
  }

  Future<int> update(Todo todo) async {
    return await db.update(tableTodo, todo.toMap(),
        where: '$columnId = ?', whereArgs: [todo.id]);
  }

  Future close() async => db.close();
}

=查詢表中的所有數(shù)據(jù)

List<Map<String, Object?>> records = await db.query('my_table');

獲取結(jié)果中的第一條數(shù)據(jù)

Map<String, Object?> mapRead = records.first;

上面查詢結(jié)果的列表中Map為只讀數(shù)據(jù)，修改此數(shù)據(jù)會拋出異常

mapRead['my_column'] = 1;
// Crash... `mapRead` is read-only

創(chuàng)建map副本并修改其中的字段

// 根據(jù)上面的map創(chuàng)建一個map副本
Map<String, Object?> map = Map<String, Object?>.from(mapRead);
// 在內(nèi)存中修改此副本中存儲的字段值
map['my_column'] = 1;

把查詢出來的List< map>類型的數(shù)據(jù)轉(zhuǎn)換成List< Todo>類型,這樣我們就可以痛快的使用啦。

// Convert the List<Map<String, dynamic> into a List<Todo>.
  return List.generate(maps.length, (i) {
    return Todo(
      id: maps[i][columnId],
      title: maps[i][columnTitle],
      done: maps[i][columnDown],
    );
  });

批處理

您可以使用批處理來避免dart與原生之間頻繁的交互。

batch = db.batch();
batch.insert('Test', {'name': 'item'});
batch.update('Test', {'name': 'new_item'}, where: 'name = ?', whereArgs: ['item']);
batch.delete('Test', where: 'name = ?', whereArgs: ['item']);
results = await batch.commit();

獲取每個操作的結(jié)果是需要成本的（插入的Id以及更新和刪除的更改數(shù)）。如果您不關(guān)心操作的結(jié)果則可以執(zhí)行如下操作關(guān)閉結(jié)果的響應(yīng)

await batch.commit(noResult: true);

事務(wù)中使用批處理

在事務(wù)中進行批處理操作，當事務(wù)提交后才會提交批處理。

await database.transaction((txn) async {
  var batch = txn.batch();
  
  // ...
  
  // commit but the actual commit will happen when the transaction is committed
  // however the data is available in this transaction
  await batch.commit();
  
  //  ...
});

批處理異常忽略

默認情況下批處理中一旦出現(xiàn)錯誤就會停止（未執(zhí)行的語句則不會被執(zhí)行了），你可以忽略錯誤，以便后續(xù)操作的繼續(xù)執(zhí)行。

await batch.commit(continueOnError: true);

關(guān)于表名和列名

通常情況下我們應(yīng)該避免使用SQLite關(guān)鍵字來命名表名稱和列名稱。如：

"add","all","alter","and","as","autoincrement","between","case","check","collate",
"commit","constraint","create","default","deferrable","delete","distinct","drop",
"else","escape","except","exists","foreign","from","group","having","if","in","index",
"insert","intersect","into","is","isnull","join","limit","not","notnull","null","on",
"or","order","primary","references","select","set","table","then","to","transaction",
"union","unique","update","using","values","when","where"