Flutter使用sqflite處理數(shù)據(jù)表變更的方法詳解
前言
上一篇我們介紹了使用 sqflite
這個(gè)數(shù)據(jù)庫(kù)工具在 Flutter 的應(yīng)用中建立本地?cái)?shù)據(jù)庫(kù)的實(shí)例應(yīng)用。了解過(guò)數(shù)據(jù)庫(kù)的同學(xué)應(yīng)該會(huì)知道,數(shù)據(jù)表結(jié)構(gòu)是可能發(fā)生改變的。但是 App 的版本會(huì)有碎片化的存在,如果數(shù)據(jù)表結(jié)構(gòu)發(fā)生了改變,就需要對(duì)舊版本 App 的數(shù)據(jù)表結(jié)構(gòu)進(jìn)行同步,否則會(huì)導(dǎo)致程序運(yùn)行錯(cuò)誤。典型的例子就是數(shù)據(jù)表增加了字段,但是舊版 App的數(shù)據(jù)表沒(méi)有同步,這樣會(huì)導(dǎo)致程序讀不到對(duì)應(yīng)的字段而出錯(cuò)。 解決這種情況就需要使用數(shù)據(jù)表的版本管理。
sqflite 版本管理
我們使用 sqflite 創(chuàng)建數(shù)據(jù)庫(kù)的時(shí)候,有個(gè) version
參數(shù),就是用于定義當(dāng)前的數(shù)據(jù)庫(kù)版本。
Future<Database> _initDB(String filePath) async { final dbPath = await getDatabasesPath(); final path = join(dbPath, filePath); return await openDatabase(path, version: 1, onCreate: _createDB); }
同時(shí) sqflite
提供了一個(gè)方法來(lái)獲取當(dāng)前數(shù)據(jù)庫(kù)的版本。
var version = await db.getVersion();
有了這個(gè),我們就可以判斷當(dāng)前本地的數(shù)據(jù)庫(kù)版本是不是最新版本了。在 sqflite
中,提供了版本升級(jí)的處理方法,當(dāng)檢測(cè)到 version
參數(shù)比當(dāng)前的數(shù)據(jù)庫(kù)版本高時(shí),就可以執(zhí)行 onUpgrade
方法,在這個(gè)方法里可以處理數(shù)據(jù)表升級(jí)操作,比如增加/刪除字段,更改字段默認(rèn)值等。
var db = await openDatabase(path, version: latestVersion, onCreate: _createDB, onUpgrade: _updateDB);
備忘錄實(shí)例 - 增加標(biāo)簽
還是以我們上一篇的備忘錄為例,我們假設(shè)需要給備忘錄增加一個(gè)標(biāo)簽字段,界面如下所示。
這個(gè)時(shí)候我們就需要更改備忘錄數(shù)據(jù)表,增加一個(gè)標(biāo)簽字段。由于 SQLite 無(wú)法存儲(chǔ)數(shù)組,我們可以將多個(gè)標(biāo)簽轉(zhuǎn)換為特殊符號(hào)分隔的字符串,比如這里使用的是豎線“|”。增加數(shù)據(jù)表的字段的數(shù)據(jù)庫(kù)版本升級(jí)代碼如下。
Future<void> _updateDB(Database db, int oldVersion, int newVersion) async { try { await db.execute('ALTER TABLE memo ADD COLUMN tags TEXT'); } on DatabaseException catch (e) { if (e.isDuplicateColumnError()) { // 忽略該異常,該列已經(jīng)存在 } else { rethrow; } } await db.setVersion(newVersion); }
這里之所以捕獲異常,是因?yàn)樘砑幼侄尾僮鞑辉试S添加已有的字段,如果發(fā)生了重復(fù)字段異常處理我們忽略這個(gè)異常,已讓程序能夠正常運(yùn)行。 這里需要注意,在創(chuàng)建數(shù)據(jù)表的時(shí)候也需要更改SQL,增加 tags
字段(upgrade
方法只對(duì)舊版本的做升級(jí)處理,不會(huì)更改現(xiàn)有版本的數(shù)據(jù)表)。
Future<void> _createDB(Database db, int version) async { await db.execute(''' CREATE TABLE memo ( id INTEGER PRIMARY KEY AUTOINCREMENT, title TEXT, content TEXT, tags TEXT, created_time INTEGER, modified_time INTEGER ) '''); }
接下來(lái)是備忘錄的代碼實(shí)現(xiàn),我們用 InputChip
定義了一個(gè)標(biāo)簽組件,以支持能夠通過(guò)刪除圖標(biāo)刪掉標(biāo)簽。
class Tag extends StatelessWidget { final String text; final VoidCallback onDeleted; const Tag({Key? key, required this.text, required this.onDeleted}) : super(key: key); @override Widget build(BuildContext context) { return InputChip( label: Text(text), onDeleted: onDeleted, ); } }
在添加備忘錄的頁(yè)面中,在表單區(qū)增加了如下內(nèi)容,一個(gè) Wrap
組件來(lái)顯示多個(gè)標(biāo)簽,然后一個(gè)輸入框來(lái)添加標(biāo)簽。
Column( crossAxisAlignment: CrossAxisAlignment.start, children: [ Wrap( alignment: WrapAlignment.start, spacing: 4.0, runSpacing: 4.0, children: [ for (final tag in _tags) Tag( text: tag, onDeleted: () => _removeTag(tag), ) ], ), TextField( controller: _tagController, decoration: InputDecoration( labelText: '添加標(biāo)簽', suffixIcon: IconButton( icon: const Icon(Icons.add), onPressed: _addTag, ), ), onSubmitted: (_) => _addTag(), ), ], ),
當(dāng)添加標(biāo)簽時(shí),就往標(biāo)簽數(shù)組里增加標(biāo)簽字符串元素,刪除標(biāo)簽時(shí)就移除該標(biāo)簽。這里注意,為了避免標(biāo)簽重復(fù),添加標(biāo)簽時(shí)需要檢查當(dāng)前標(biāo)簽是否已經(jīng)存在。
void _addTag() { final newTag = _tagController.text.trim(); if (newTag.isNotEmpty && !_tags.contains(newTag)) { setState(() { _tags.add(newTag); _tagController.clear(); }); } }
之后就是更改我們的保存?zhèn)渫浀姆椒ā?/p>
Future<int> _saveMemo(BuildContext context) async { var createdTimestamp = DateTime.now().millisecondsSinceEpoch ~/ 1000; var modifiedTimestamp = createdTimestamp; var memoMap = { 'title': _title, 'content': _content, 'created_time': createdTimestamp, 'modified_time': modifiedTimestamp, 'tags': _tags.isNotEmpty ? _tags.join('|') : '', }; // 保存?zhèn)渫? var id = await insertMemo(memoMap); return id; }
運(yùn)行效果
運(yùn)行效果如下,完整代碼已經(jīng)上傳到:本地存儲(chǔ)相關(guān)代碼。
總結(jié)
本篇介紹了 Flutter 使用 sqflite
處理數(shù)據(jù)表變更的版本升級(jí)處理方法。當(dāng)我們使用數(shù)據(jù)庫(kù)在 App 里存儲(chǔ)本地結(jié)構(gòu)化數(shù)據(jù)的時(shí)候,不可避免會(huì)遇到新增字段、刪除字段等的處理嗎,這個(gè)時(shí)候就需要進(jìn)行數(shù)據(jù)庫(kù)版本升級(jí)操作。在 sqflite
中,會(huì)自動(dòng)根據(jù)本地的數(shù)據(jù)庫(kù)版本和當(dāng)前的數(shù)據(jù)庫(kù)版本進(jìn)行對(duì)比,如果本地版本低于當(dāng)前的數(shù)據(jù)庫(kù)版本就會(huì)調(diào)用 onUpgrade
方法處理版本升級(jí),比如字段變更,數(shù)據(jù)遷移等。 同時(shí),大家做本地?cái)?shù)據(jù)庫(kù)的時(shí)候,務(wù)必注意不同版本之間的兼容,一方面是盡可能地保持?jǐn)?shù)據(jù)表不變更,另一方面是做好不同版本的升級(jí)和數(shù)據(jù)遷移工作。
到此這篇關(guān)于Flutter使用sqflite處理數(shù)據(jù)表變更的方法詳解的文章就介紹到這了,更多相關(guān)Flutter sqflite處理數(shù)據(jù)表變更內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Android AlertDialog(對(duì)話框)實(shí)例詳解
Android在開(kāi)發(fā)中經(jīng)常會(huì)遇到有彈框的需求,經(jīng)常使用的有Dialog彈框,Window彈框,他們之間最本質(zhì)的區(qū)別是dialog是非阻塞式對(duì)話框,popupwindow是阻塞式對(duì)話框,這篇文章主要給大家介紹了關(guān)于Android AlertDialog(對(duì)話框)的相關(guān)資料,需要的朋友可以參考下2021-11-11Android List刪除重復(fù)數(shù)據(jù)
這篇文章主要介紹了Android List刪除重復(fù)數(shù)據(jù)的實(shí)例代碼,非常不錯(cuò),具有參考借鑒價(jià)值,需要的朋友參考下吧2017-06-06利用百度地圖Android sdk高仿微信發(fā)送位置功能及遇到的問(wèn)題
這篇文章給大家介紹了利用百度地圖Android sdk高仿微信發(fā)送位置功能,在實(shí)現(xiàn)此功能的時(shí)候遇到點(diǎn)小問(wèn)題,下面小編給大家列出來(lái),需要的朋友參考下吧2017-12-12Android入門(mén)教程之RecyclerView的具體使用詳解
RecyclerView是Android一個(gè)更強(qiáng)大的控件,其不僅可以實(shí)現(xiàn)和ListView同樣的效果,還有優(yōu)化了ListView中的各種不足。其可以實(shí)現(xiàn)數(shù)據(jù)縱向滾動(dòng),也可以實(shí)現(xiàn)橫向滾動(dòng)(ListView做不到橫向滾動(dòng))。接下來(lái)講解RecyclerView的用法2021-10-10Android一個(gè)類(lèi)實(shí)現(xiàn)錄音與播放實(shí)例
大家好,本篇文章主要講的是Android一個(gè)類(lèi)實(shí)現(xiàn)錄音與播放實(shí)例,感興趣的同學(xué)趕快來(lái)看一看吧,對(duì)你有幫助的話記得收藏一下2022-02-02Android Studio查看Android 5.x源碼的步驟詳解
Google為Android開(kāi)發(fā)者帶來(lái)Android Studio,用來(lái)取代Eclipse。從Android Studio出現(xiàn)起,整機(jī)開(kāi)發(fā)和Android源碼閱讀和編輯一定能用上它。這篇文章小編就帶大家學(xué)習(xí)下如何使用Android Studio查看Android 5.x源碼,有需要的可以參考借鑒。2016-09-09Android 使用ViewPager自動(dòng)滾動(dòng)循環(huán)輪播效果
本文主要給大家介紹viewpager自動(dòng)播放,循環(huán)滾動(dòng)的效果,對(duì)android viewpager滾動(dòng)相關(guān)知識(shí)感興趣的朋友可以參考下本篇文章2015-11-11詳解Android App卸載后跳轉(zhuǎn)到指定的反饋?lái)?yè)面的方法
這篇文章主要介紹了Android App卸載后跳轉(zhuǎn)到指定的反饋?lái)?yè)面的方法,關(guān)鍵點(diǎn)是相關(guān)線程要判斷在目錄被消除以前作出響應(yīng),需要的朋友可以參考下2016-04-04