【UWP】使用 LiteDB 存儲數據

来源:https://www.cnblogs.com/h82258652/archive/2020/01/20/12217910.html
-Advertisement-
Play Games

序言： 在 UWP 中，常見的存儲數據方式基本上就兩種。第一種方案是 UWP 框架提供的 ApplicationData Settings 這一系列的方法，適用於存放比較輕量的數據，例如存個 Boolean 類型的設置項這種是最適合不過的了。另一種方案是用 Sqlite 這種資料庫，適合存放數據量大 ...


序言：

在 UWP 中，常見的存儲數據方式基本上就兩種。第一種方案是 UWP 框架提供的 ApplicationData Settings 這一系列的方法，適用於存放比較輕量的數據，例如存個 Boolean 類型的設置項這種是最適合不過的了。另一種方案是用 Sqlite 這種資料庫，適合存放數據量大或者結構複雜，又或者需要根據條件查詢的場合，例如開發個寶可夢數據查詢，或者 Jav 圖書館（咳咳）。

場景分析：

在某些場合，我們很可能是要持久化一個複雜的對象的，例如通過 OAuth 授權成功獲取到的用戶信息，有可能就類似下麵的結構：

{
    "id": 1,
    "name": "Justin Liu",
    "gender": 2,
    "location": {
        "name": "Melbourne",
        "name_cn": "墨爾本"
    }
}

又或者做一個 RSS 閱讀器，弄個後臺服務提前先把數據拉下來，那肯定也要存放起來吧。這相當於要把一個以時間排序為依據的列表進行持久化。

ApplicationData Settings 方案

在以上兩種場合，用 ApplicationData Settings 解決起來可能是比較快速的。以第一種情況來說，又可以細分兩種存儲方案。

A 方案，分欄位存放：

ApplicationData.Current.LocalSettings.Values["user.id"] = user.Id;
ApplicationData.Current.LocalSettings.Values["user.name"] = user.Name;
ApplicationData.Current.LocalSettings.Values["user.gender"] = user.Gender;
ApplicationData.Current.LocalSettings.Values["user.location.name"] = user.Location.Name;
ApplicationData.Current.LocalSettings.Values["user.location.name_cn"] = user.Location.NameCn;

當然調用 ApplicationData.Current.LocalSettings.CreateContainer 拿個 Container 來存也是可以。（或者說這樣更好一點）

這樣存儲的話，可以按需更新，也可以按需載入，例如我只需要用戶的名字那就只載入名字好了。

但這方案缺點也不少，一個是假如上面的 Gender 是一個枚舉，那這段代碼就炸了。ApplicationData Settings 是不能直接存儲枚舉類型的，需要處理一下（一般轉數值存，不建議轉字元串存）。另一個如果欄位多的話，代碼行數也跟著變多，就很容易就會寫錯。但實際上如果欄位少的話，這方案是相當合適的。

B 方案，序列化存放：

ApplicationData.Current.LocalSettings.Values["user"] = JsonConvert.SerializeObject(user);

說起序列化，那第一時間肯定是想到 JSON 了。這方案解決了 A 方案的痛點，但按需載入、按需更新就無法實現了。這個方案勝在泛用，包括 Windows Community Toolkit 也是這麼做的。但在我看來，這個方案只滿足了需求，但不夠優秀。一是依賴了 JSON.net（或是別的 JSON 庫），另一個是序列化和反序列化的性能，特別是對象較大的時候。

小結：

這僅僅只是考慮到上面 user 這種結構的存放，如果是 rss 那種的結構，存放的話， A 方案幾乎做不了，B 方案倒是能做。但假如做個查詢（例如查詢某一天時間範圍內的），ApplicationData Settings 方案是解決不了的（當然你說全部載入到記憶體再查詢也行，但這就跟用 EF 全部載入出來再分頁一樣搞笑）。

Sqlite 方案

Sqlite 方案其實也可以細分兩種，一種是直接擼 sql，另一種是用 ef core 這種 orm 框架。擼 sql 這種方案說實話我是沒實行過，因為相當的不 awesome，我自己也很多年沒寫過一行 sql 了（雖然我平時上班是乾後端工作的）。這裡主要說說 ef core 的方案。

新建一個 .net standard 的項目：

Snipaste_2020-01-20_11-07-07

Article.cs 如下：

public class Article
{
    public int Id { get; set; }

    public string Title { get; set; }

    public string Content { get; set; }

    public DateTime PublishTime { get; set; }
}

ApplicationDbContext.cs 如下：

public class ApplicationDbContext : DbContext
{
    public ApplicationDbContext()
    {
    }

    public DbSet<Article> Articles { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        base.OnConfiguring(optionsBuilder);

        optionsBuilder.UseSqlite("Data Source=articles.db");
    }
}

並且項目引用 Microsoft.EntityFrameworkCore.Sqlite 包，註意是用 2.2.6 版本的，3.x 的 UWP 用會炸！

然後創建資料庫遷移：

Snipaste_2020-01-20_11-07-07

接下來 UWP 項目引用該 .net standard 庫，修改 App.xaml.cs 的代碼：

public App()
{
    using (var context = new ApplicationDbContext())
    {
        context.Database.Migrate();
    }

    this.InitializeComponent();
    this.Suspending += OnSuspending;
}

這樣啟動程式的時候就會執行資料庫遷移了，接下來程式代碼里就可以使用了。

因為主題並不是 Sqlite，這裡我就僅僅以 demo 級的態度代碼來舉例子，而且園子里也有大牛寫過相關更詳細的博文。

小結：

Sqlite 方案看似很好，但我認為缺點也是有的。一個是該方案太重了，關係型資料庫意味著就是有數據表，像我只是要存個 user 的信息的話，come on，能 easy 一點嗎？另一個就是 ef core 對 UWP 的支持度，上面我也說了，3.x 的是會炸掉的。PS 一句，微軟對 UWP 目前不是很上心，System.Text.Json 這個包，4.7.0 版本在 UWP 上要用就得寫 rd.xml，但 4.6.0 就不需要。總結一點，Sqlite 方案就是把牛刀，而我們目前是要殺雞。

分析：

那有沒有介於 ApplicationData Settings 和 Sqlite 之間的方案呢？Sqlite 是關係型資料庫，嗯，意味著 sql。說到 sql，就想到 nosql，就想到 MongoDb、Redis 這些玩意。事實上，由於這些 nosql 資料庫都是 schema less 的，也就是不存在表結構，增刪欄位就沒有說改動表結構這麼一說，因此是相當適合用在一些非關鍵性數據的存儲當中的。但是 MongoDb、Redis 這些玩意都是需要一個 server 端，而 UWP 肯定不可能帶個 server 的，那麼有沒有類似於 Sqlite 這種單文件無 server 的，而且 UWP 能用的呢，當然最好的話還是用 .net 開發的。我找了一下，還真被我找著了，接下來就是本文的主角 —— LiteDB。

正文：

LiteDB 官方主頁：https://www.litedb.org/

Github：https://github.com/mbdavid/LiteDB

在我們的 UWP 項目中添加 LiteDB 的引用。（註意本文使用 5.0.0-rc 版本，因為需要對應下文的 LiteDB Studio 使用）

以插入數據為例：

var dbPath = Path.Combine(ApplicationData.Current.LocalFolder.Path, "MyArticles.db");
using (var db = new LiteDatabase(dbPath))
{
    var articles = db.GetCollection<Article>();
    
    var article = new Article
    {
        Title = "test title",
        Content = "test content",
        PublishTime = DateTime.Now
    };

    articles.Insert(article);
}

資料庫路徑需要設定一下，放在 UWP 的用戶數據文件夾下麵。否則會放到 Appx 文件夾，而這個路徑是沒有寫入許可權的。

db.GetCollection<Article>() 這一句相當於在該資料庫中創建了一個文檔（假如不存在），用 Sqlite 的概念來說就是創建了一個表。名字就叫 Article，當然也可以通過該方法的重載來設置名字。Id 我們不需要進行設定，這個跟 EF 是一樣的，預設是會自動遞增的。然後我們來看看我們的數據是否插入成功。下載 LiteDB Studio（我下載的是 0.9 版本）：

https://github.com/mbdavid/LiteDB.Studio/releases

下載之後打開我們的資料庫，資料庫的路徑可以給上面代碼打個斷點拿到 dbPath 的值。

打開的話是這個樣子：

Snipaste_2020-01-20_13-26-07

然後右鍵我們的 Article 選擇 Query

Snipaste_2020-01-20_13-27-08

可以看見出現了類似於我們熟悉的 sql 語句，然後點擊 Run 按鈕。

Snipaste_2020-01-20_13-28-01

可見我們剛纔插入進去的數據出現了。

 

回到需求這邊來，假設我們這個 Article 類某天多了個欄位，例如文章作者。修改 Article.cs：

public class Article
{
    public int Id { get; set; }

    public string Title { get; set; }

    public string Content { get; set; }

    public string Owner { get; set; }

    public DateTime PublishTime { get; set; }
}

修改我們的插入數據代碼：

var dbPath = Path.Combine(ApplicationData.Current.LocalFolder.Path, "MyArticles.db");
using (var db = new LiteDatabase(dbPath))
{
    var articles = db.GetCollection<Article>();
    
    var article = new Article
    {
        Title = "test title",
        Content = "test content",
        Owner = "Justin Liu",
        PublishTime = DateTime.Now
    };

    articles.Insert(article);
}

再次看看我們的 LiteDB Studio。

Snipaste_2020-01-20_13-47-48

可見數據是已經插入進去了，沒有任何的資料庫表遷移，相當優雅而且 easy。

 

要做查詢的話也簡單：

var dbPath = Path.Combine(ApplicationData.Current.LocalFolder.Path, "MyArticles.db");
using (var db = new LiteDatabase(dbPath))
{
    var articles = db.GetCollection<Article>();

    var list = articles
        .Find(temp => temp.PublishTime >= DateTime.Parse("2020-01-20 13:00:00"))
        .ToList();
}

Snipaste_2020-01-20_13-54-06

當然還有更多用法，這裡就不再介紹了，各位看官可以去看 LiteDB 官方的文檔，而且這玩意我覺得算是個較為成熟的東西了。

 

總結：

本文我覺得更偏向於與各位看官交流經驗吧，本文中 ApplicationData Settings 的 A、B 方案其實我項目也都有在使用。特別 A 方案，載入數據的時候需要特別嚴謹的邏輯，例如其中一個欄位沒有值該如何處理這種。B 方案則簡單 catch 個 JsonSerializationException 一般就沒問題了，有時候偷個懶還是挺方便的。而 Sqlite 的方案，說句實話，我目前並沒有在項目中用到（之前有一個但後來棄坑了，而且是 DbFirst 而不是本文 CodeFirst 的方式）。所以 Sqlite 方案，我在寫本文的時候才發現最新的 3.1.1（理論上 3.x 的都這樣）在 UWP 上壓根就用不了。

對於本文的主角，LiteDB。我是持樂觀態度的（雖然我還沒在我項目中用到，下個項目想個辦法用上^-^）。一般來說，客戶端存放的數據重要性肯定是不高的，重要的肯定都是存到服務端去了。也就是說，客戶端的數據更多情況是起到一種緩存一樣的作用。例如上面的，假如 user 沒數據了，那讓用戶重新授權一次就好了，這沒啥的。對於這些場景來說，關係型資料庫就太重了，而且資料庫遷移是有可能丟失數據的（這個 ef 創建遷移的時候有提示，但實際上代碼肯定要去留意的）。在服務端，如果某行數據缺失欄位的話，連上資料庫手動補一下就好了。但假如這資料庫是在客戶機器上，那就頭大了。用 LiteDB 這種 nosql 資料庫的話，因為沒有遷移，所以也不存在丟失數據的問題了。

最後再說一句，本文只提供了思路，但實際還是要看場景來分析。反正不管黑貓還是白貓，抓到老鼠就是好貓嘛。


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • python通過wakeonlan喚醒內網電腦開機
    首先需要pip3 install wakeonlan 然後在電腦需要你的網卡支持網路喚醒電腦。 然後在主板BIOS開啟支持喚醒。 在系統網卡屬性里選上“允許電腦關閉此設備以節約電源”，“允許此設備喚醒電腦” 然後以下就是python代碼，非常簡單。from wakeonlan import s ...
  • C#_Excel數據讀取與寫入_自定義解析封裝類_支持設置標題行位置&使用excel表達式收集數據&單元格映射&標題映射&模板文件的參數數據替換
    本篇博客園是被任務所逼，而已有的使用nopi技術的文檔技術經驗又不支持我需要的應對各種複雜需求的苛刻要求，只能自己造輪子封裝了，由於需要應對很多總類型的數據採集需求，因此有了本篇博客的代碼封裝，下麵一點點介紹吧： 收集excel你有沒有遇到過一下痛點： 1-需要收集指定行標題位置的數據，我的標題行不 ...
  • C#_.net core 3.0自定義讀取.csv文件數據_解決首行不是標題的問題_Linqtocsv改進
    linqtocsv文件有不太好的地方就是：無法設置標題的行數，預設首行就是標題，這不是很尷尬嗎？ 並不是所有的csv文件嚴格寫的首行是標題，下麵全是數據，我接受的任務就是讀取很多.csv報表數據，裡面就有很多前幾行是說明性內容，下麵才是標題和數據。為了更好的解決這個問題，自己寫吧... 本博客沒有照 ...
  • C#設計模式學習筆記：(8)裝飾模式
    本筆記摘抄自：https://www.cnblogs.com/PatrickLiu/p/7723225.html，記錄一下學習過程以備後續查用。 一、引言 今天我們要講結構型設計模式的第三個模式--裝飾模式。當第一次看到這個名稱時想到的是另外一個詞語“裝修”，個人觀點談談對“裝修”的理解吧，請大家 ...
  • 【5min+】傳說中的孿生兄弟？ Memory and Span
    在上一篇文章：《閃電光速拳？ .NetCore 中的Span》中我們提到了在.net core 2.x 所新增的一個類型：Span。但是您會發現它無法用在我們項目的某些地方，它獨特的 ref結構 使它沒有辦法跨線程使用、更沒有辦法使用Lambda表達式。所以，這個時候如果我們又想跨線程操作數據又想獲... ...
  • 定時器_在.net core3.0 webapi中添加自定義定時器功能
    前言：想在.net framework環境使用自定義定時器的話，參考我的另一篇文章：https://www.cnblogs.com/lxhbky/p/10242839.html 想在.net core中使用定時器功能，需要藉助一個服務介面：IHostedService, 繼承並實現對應方法，最後再s ...
  • 開源導入導出庫Magicodes.IE 導出教程
    要點 導出特性 如何導出Excel表頭 如何導出數據、如何進行數據的切割、如何使用篩選器 導出特性 ExporterAttribute + Name ： 名稱(當前Sheet 名稱) + HeaderFontSize ：頭部字體大小 + FontSize ：正文字體大小 + MaxRowNumber ...
  • 150行代碼打造.net core生產力工具，你值得擁有
    你是否在初學 .net core時，被依賴註入所折磨？ 你是否在開發過程中，為了註入依賴而不停的在Startup中增加註入代碼，而感到麻煩？ 你是否考慮過或尋找過能輕鬆實現自動註入的組件？ 如果有，那請歡迎繼續往下看。 或許你是被我這標題給吸引過來的，請不要懷疑自己的眼睛，如果你真的遇到過以上的問題 ...
一周排行
    -Advertisement-
    Play Games
  • Dapr Outbox 執行流程
    Dapr Outbox 是1.12中的功能。 本文只介紹Dapr Outbox 執行流程，Dapr Outbox基本用法請閱讀官方文檔 。本文中appID=order-processor，topic=orders 本文前提知識：熟悉Dapr狀態管理、Dapr發佈訂閱和Outbox 模式。 Outbo ...
  • Advanced .Net Debugging 7：托管堆與垃圾收集
    引言 在前幾章我們深度講解了單元測試和集成測試的基礎知識，這一章我們來講解一下代碼覆蓋率,代碼覆蓋率是單元測試運行的度量值,覆蓋率通常以百分比表示，用於衡量代碼被測試覆蓋的程度，幫助開發人員評估測試用例的質量和代碼的健壯性。常見的覆蓋率包括語句覆蓋率（Line Coverage）、分支覆蓋率（Bra ...
  • C#S7.NET實現西門子PLCDB塊數據採集的完整步驟
    前言 本文介紹瞭如何使用S7.NET庫實現對西門子PLC DB塊數據的讀寫，記錄了使用電腦模擬，模擬PLC，自至完成測試的詳細流程，並重點介紹了在這個過程中的易錯點，供參考。 用到的軟體： 1.Windows環境下鏈路層網路訪問的行業標準工具（WinPcap_4_1_3.exe）下載鏈接：http ...
  • WPF控制項：密碼框綁定MVVM
    從依賴倒置原則（Dependency Inversion Principle, DIP）到控制反轉（Inversion of Control, IoC）再到依賴註入（Dependency Injection, DI）的演進過程，我們可以理解為一種逐步抽象和解耦的設計思想。這種思想在C#等面向對象的編 ...
  • Python中的私有屬性與私有方法
    關於Python中的私有屬性和私有方法 Python對於類的成員沒有嚴格的訪問控制限制，這與其他面相對對象語言有區別。關於私有屬性和私有方法，有如下要點： 1、通常我們約定，兩個下劃線開頭的屬性是私有的（private）。其他為公共的（public）； 2、類內部可以訪問私有屬性（方法）； 3、類外 ...
  • C++ 訪問說明符詳解：封裝數據，控制訪問，提升安全性
    C++ 訪問說明符 訪問說明符是 C++ 中控制類成員（屬性和方法）可訪問性的關鍵字。它們用於封裝類數據並保護其免受意外修改或濫用。 三種訪問說明符： public：允許從類外部的任何地方訪問成員。 private：僅允許在類內部訪問成員。 protected：允許在類內部及其派生類中訪問成員。 示 ...
  • static_cast與dynamic_cast到底是什麼？
    寫這個隨筆說一下C++的static_cast和dynamic_cast用在子類與父類的指針轉換時的一些事宜。首先，【static_cast，dynamic_cast】【父類指針，子類指針】，兩兩一組，共有4種組合：用 static_cast 父類轉子類、用 static_cast 子類轉父類、使用 ...
  • C語言數據結構：雙向鏈表的增刪操作
    /******************************************************************************************************** * * * 設計雙向鏈表的介面 * * * * Copyright (c) 2023-2 ...
  • @ComponentScan註解的實現，Spring掃描包的過程
    相信接觸過spring做開發的小伙伴們一定使用過@ComponentScan註解 @ComponentScan("com.wangm.lifecycle") public class AppConfig { } @ComponentScan指定basePackage，將包下的類按照一定規則註冊成Be ...
  • opensips開啟python支持
    操作系統 ：CentOS 7.6_x64 opensips版本： 2.4.9 python版本：2.7.5 python作為腳本語言，使用起來很方便，查了下opensips的文檔，支持使用python腳本寫邏輯代碼。今天整理下CentOS7環境下opensips2.4.9的python模塊筆記及使用 ...
所有分類