前言

上一篇我們介紹了使用 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)文章希望大家以后多多支持腳本之家！

最新評(píng)論