benxu.AppPlatform.Storage.LiteDB 3.2.7

benxu.AppPlatform.Storage.LiteDB

LiteDB 本地儲存實作 - 提供 Offline-first 的本地資料庫功能。

特色

• 輕量級 NoSQL 資料庫
• 支援 Key-Value 和 Collection 儲存模式
• 執行緒安全
• 自動序列化/反序列化
• 支援加密
• 封裝連線字串和檔案路徑

安裝

dotnet add package benxu.AppPlatform.Storage.LiteDB

使用範例

註冊服務

using benxu.AppPlatform.Storage.LiteDB.Extensions;

// 使用預設設定
builder.Services.AddLiteDBStorage();

// 或自訂設定
builder.Services.AddLiteDBStorage(new LiteDBOptions
{
 DatabaseName = "myapp.db",
 EnableEncryption = true,
 EncryptionPassword = "your-password"
});

Key-Value 儲存

public class MyService
{
 private readonly ILocalStorage _storage;

 public MyService(ILocalStorage storage)
 {
 _storage = storage;
 }

 public async Task SaveUserSettingsAsync(UserSettings settings)
 {
 var result = await _storage.SaveAsync("user_settings", settings);
 if (result.IsSuccess)
 {
 Console.WriteLine("設定已儲存");
 }
 }

 public async Task<UserSettings?> LoadUserSettingsAsync()
 {
 var result = await _storage.GetAsync<UserSettings>("user_settings");
 return result.IsSuccess ? result.Data : null;
 }
}

Collection 儲存

// 儲存
await _storage.SaveCollectionAsync("todos", new TodoItem
{
 Id = 1,
 Title = "學習 MAUI"
});

// 查詢
var result = await _storage.QueryCollectionAsync<TodoItem>(
 "todos",
 item => item.IsCompleted == false
);

// 取得所有
var allTodos = await _storage.GetAllFromCollectionAsync<TodoItem>("todos");

設定選項

public class LiteDBOptions
{
 public string DatabaseName { get; set; } = "appplatform.db";
 public ConnectionType ConnectionMode { get; set; } = ConnectionType.Shared;
 public bool EnableEncryption { get; set; }
 public string? EncryptionPassword { get; set; }
 public long InitialSize { get; set; }
 public bool EnableLogging { get; set; }
}

資料位置

資料庫檔案會儲存在平台的 LocalApplicationData 目錄：

• Windows: %LOCALAPPDATA%
• macOS: ~/Library/Application Support
• Android: /data/data/{package}/files
• iOS: ~/Library

授權

MIT License - Copyright (c) 2025 benxu