【從零開始學 Flutter 程式設計】Sqflite 資料庫存取
【從零開始學 Flutter 程式設計】線上教學課程目錄 使用 Dart 程式語言，開發 Android 和 iOS APP 應用程式。
Sqflite 資料庫存取
當你需要大量資料存在手機端，可以採用 SQLite 資料庫，而 Flutter 會透過 sqflite 這個套件來處理 SQLite 資料庫。
新增加入 sqflite 和 path 套件
最新版號，可以連結至 pub.dev 進行查詢:
- sqflite: https://pub.dev/packages/sqflite
- path: https://pub.dev/packages/path
dependencies:
flutter:
sdk: flutter
sqflite: ^1.1.6
path: ^1.6.2
加入位置實際範例
定義數據模型
定義一個狗狗的數據模型，裡面共有三個資料欄位，分別是：
- id：識別欄位，唯一值為整數資料類型
- name：存放狗狗名字為字串資料類型
- age：存放狗狗年齡，為整數資料類型。
class Dog {
final int id;
final String name;
final int age;
Dog({this.id, this.name, this.age});
}
開啟資料庫
openDatabase 開啟資料庫，搭配 path 套件的 join 方法來確保多平台運行正常。不會因平台差異導致開啟位置錯誤。
final database = openDatabase(
join(await getDatabasesPath(), 'doggie_database.db'),);
Create，建立資料表
SQLite 常用資料類型介紹
| 資料名稱 | 資料類型 |
|---|---|
| TEXT | 文字資料 |
| INTEGER | 整數資料 |
final Future<Database> database = openDatabase(
join(await getDatabasesPath(), 'doggie_database.db'),
onCreate: (db, version) {
// 執行 CREATE TABLE 的 SQLite 語法，來建立資料表。
// 設定 id 為整數 PRIMARY KEY 主鍵值
return db.execute(
"CREATE TABLE dogs(id INTEGER PRIMARY KEY, name TEXT, age INTEGER)",
);
},
//設定版本號碼，提供資料庫升版或降版使用
version: 1,
);
insert，插入一筆資料
數據模型，加入轉 Map 方法
將狗狗的數據模型，加入轉 Map 方法，方便等一下執行插入語法
class Dog {
final int id;
final String name;
final int age;
Dog({this.id, this.name, this.age});
Map<String, dynamic> toMap() {
return {
'id': id,
'name': name,
'age': age,
};
}
}
定義插入方法
Future<void> insertDog(Dog dog) async {
//引用資料庫
final Database db = await database;
// 插入狗狗資料庫語法
await db.insert(
'dogs',
dog.toMap(),
//當資料發生衝突，定義將會採用 replace 覆蓋之前的資料
conflictAlgorithm: ConflictAlgorithm.replace,
);
}
建立一筆狗狗數據資料
final fido = Dog(
id: 0,
name: 'Fido',
age: 35,
);
執行插入語法
await insertDog(fido);
Query，查詢資料
自定義一個查詢方法
Future<List<Dog>> dogs() async {
//引用資料庫
final Database db = await database;
// 查詢狗狗資料庫語法
final List<Map<String, dynamic>> maps = await db.query('dogs');
//將 List
return List.generate(maps.length, (i) {
return Dog(
id: maps[i]['id'],
name: maps[i]['name'],
age: maps[i]['age'],
);
});
}
執行查詢語法，獲取資料後印出
print(await dogs());
Update，更新資料
Future<void> updateDog(Dog dog) async {
//引用資料庫
final db = await database;
// 查詢狗狗資料庫語法
await db.update(
'dogs',
dog.toMap(),
//確定給定的狗狗id是否匹配
where: "id = ?",
//通過 whereArg 傳遞狗狗的 id 可以防止 SQL 注入
//注意 不要使用 where: "id = ${dog.id}"
whereArgs: [dog.id],
);
}
更新數據
//更新年齡資料
fido = Dog(
id: fido.id,
name: fido.name,
age: fido.age + 7,
);
//執行更新語法
await updateDog(fido);
//印出更新後的資料
print(await dogs());
Delete，刪除資料
Future<void> deleteDog(int id) async {
//引用資料庫
final db = await database;
//刪除語法
await db.delete(
'dogs',
where: "id = ?",
whereArgs: [id],
);
}
刪除數據
//執行刪除語法
await deleteDog(fido.id);
//印出刪除後的資料
print(await dogs());
完整程式碼
import 'dart:async';
import 'package:path/path.dart';
import 'package:sqflite/sqflite.dart';
void main() async {
final database = openDatabase(
join(await getDatabasesPath(), 'doggie_database.db'),
onCreate: (db, version) {
return db.execute(
"CREATE TABLE dogs(id INTEGER PRIMARY KEY, name TEXT, age INTEGER)",
);
},
version: 1,
);
Future<void> insertDog(Dog dog) async {
final Database db = await database;
await db.insert(
'dogs',
dog.toMap(),
conflictAlgorithm: ConflictAlgorithm.replace,
);
}
Future<List<Dog>> dogs() async {
final Database db = await database;
final List<Map<String, dynamic>> maps = await db.query('dogs');
return List.generate(maps.length, (i) {
return Dog(
id: maps[i]['id'],
name: maps[i]['name'],
age: maps[i]['age'],
);
});
}
Future<void> updateDog(Dog dog) async {
final db = await database;
await db.update(
'dogs',
dog.toMap(),
where: "id = ?",
whereArgs: [dog.id],
);
}
Future<void> deleteDog(int id) async {
final db = await database;
await db.delete(
'dogs',
where: "id = ?",
whereArgs: [id],
);
}
var fido = Dog(
id: 0,
name: 'Fido',
age: 35,
);
await insertDog(fido);
print(await dogs());
fido = Dog(
id: fido.id,
name: fido.name,
age: fido.age + 7,
);
await updateDog(fido);
print(await dogs());
await deleteDog(fido.id);
print(await dogs());
}
class Dog {
final int id;
final String name;
final int age;
Dog({this.id, this.name, this.age});
Map<String, dynamic> toMap() {
return {
'id': id,
'name': name,
'age': age,
};
}
@override
String toString() {
return 'Dog{id: $id, name: $name, age: $age}';
}
}
執行畫面
參考資料
Persist data with SQLite
https://flutter.dev/docs/cookbook/persistence/sqlite
https://flutter.dev/docs/cookbook/persistence/sqlite
那這次的課程就介紹到這邊囉～
順帶一提，KT 線上教室，臉書粉絲團，會不定期發佈相關資訊，不想錯過最新資訊，不要忘記來按讚，加追蹤喔！也歡迎大家將這套課程分享給更多人喔。
我們下次再見囉！！！掰掰～
