SuncodeSoftware.SuperSDK.Data 2.2.0

SuperSDK.Data

数据访问层，提供统一的数据持久化接口。

🎯 核心功能

• ✅ Entity Framework Core 集成
• ✅ SQLite 数据库支持
• ✅ SQLCipher 加密字段支持
• ✅ CRUD 统一操作接口
• ✅ 事务管理
• ✅ 加密字段自动处理

📦 依赖

• SuperSDK.Core (MessageBus 日志集成)
• Microsoft.EntityFrameworkCore.Sqlite
• Microsoft.Data.Sqlite.Core

🚀 快速开始

1. 定义实体模型

using SuperSDK.Data;
using System.ComponentModel.DataAnnotations;

public class TestConfig : IEntity, IDatabaseEntity, ITableEntity
{
    [Key]
    public string Id { get; set; } = Guid.NewGuid().ToString();
    
    [Required]
    public string ConfigName { get; set; } = "";
    
    public string ConfigValue { get; set; } = "";
    
    // 指定数据库名（与项目名一致）
    public string DatabaseName => "YourProjectName";
    
    // 指定表名（与类名一致）
    public string TableName => "TestConfig";
}

2. 初始化数据库

using SuperSDK.Data;

// 注册实体
DbContextFactory.RegisterEntity<TestConfig>();

// 初始化数据库
DbContextFactory.Initialize();

3. CRUD 操作

using SuperSDK.Data;

// 插入
var config = new TestConfig 
{ 
    ConfigName = "AppTheme", 
    ConfigValue = "Dark" 
};
EntityStore.Insert(config);

// 查询所有
var allConfigs = EntityStore.GetAll<TestConfig>();

// 条件查询
var darkConfigs = EntityStore.Find<TestConfig>(c => c.ConfigValue == "Dark");

// 更新
config.ConfigValue = "Light";
EntityStore.Update(config);

// 删除
EntityStore.Delete(config);

🔐 加密字段

对于需要加密存储的敏感数据：

public class UserProfile : IEntity, IEncryptedEntity, IDatabaseEntity, ITableEntity
{
    [Key]
    public string Id { get; set; } = Guid.NewGuid().ToString();
    
    public string Username { get; set; } = "";
    
    // 加密字段 - 自动存储在 secure.db 中
    [Encrypted]
    public string Password { get; set; } = "";
    
    [Encrypted]
    public List<string> ApiKeys { get; set; } = new();
    
    public string DatabaseName => "YourProjectName";
    public string TableName => "UserProfile";
}

// 初始化加密数据库
EncryptedFieldManager.Initialize(
    "Data/secure.db", 
    "YourSecurePassword123!"
);

加密字段自动处理：

• 插入/更新时自动加密并保存到 secure.db
• 查询时自动解密并填充到实体属性
• 删除时自动清理加密数据

🔧 高级功能

事务操作

using (var tx = EntityStore.BeginTransaction<TestConfig>())
{
    tx.Add(config1);
    tx.Add(config2);
    tx.Update(config3);
    tx.Commit(); // 或 tx.Rollback()
}

分页查询

var result = EntityStore.GetPaged<TestConfig>(
    pageIndex: 0,
    pageSize: 20,
    orderBy: c => c.ConfigName,
    isDescending: false
);

Console.WriteLine($"Total: {result.TotalCount}, Pages: {result.TotalPages}");
foreach (var item in result.Data)
{
    Console.WriteLine(item.ConfigName);
}

📂 数据库文件位置

[ApplicationDirectory]/Data/
├── YourProjectName.db    # 主数据库（明文字段）
└── secure.db             # 加密数据库（加密字段，AES-256）

📝 License

MIT License - See LICENSE file for details