.NETCore 下支持分表分庫、讀寫分離的通用 Repository

首先聲明這篇文章不是標題黨，我說的這個類庫是 FreeSql.Repository，它做爲擴展庫現實了通用倉儲層功能，接口規範參考 abp vnext 定義，實現了基礎的倉儲層（CURD）。

安裝

dotnet add package FreeSql.Repository

可用於：.net framework 4.6+、.net core 2.1+

定義

var fsql = new FreeSql.FreeSqlBuilder()
    .UseConnectionString(FreeSql.DataType.Sqlite, @"Data Source=|DataDirectory|\document.db;Pooling=true;Max Pool Size=10")
    .UseLogger(loggerFactory.CreateLogger<IFreeSql>())
    .UseAutoSyncStructure(true) //自動遷移實體的結構到數據庫
    .Build();

過濾與驗證

假設咱們有User(用戶)、Topic(主題)兩個實體，在某領域類中定義了兩個倉儲：

var userRepository = fsql.GetGuidRepository<User>();
var topicRepository = fsql.GetGuidRepository<Topic>();

開發過程當中，我總會擔憂 topicRepository 的數據安全問題，即有可能查詢或操做到其餘用戶的主題。所以在v0.0.7版本進行了改進，增長了 filter lambad 表達式參數。

var userRepository = fsql.GetGuidRepository<User>(a => a.Id == 1);
var topicRepository = fsql.GetGuidRepository<Topic>(a => a.UserId == 1);

• 在查詢/修改/刪除時附加此條件，從而達到不會修改其餘用戶的數據；
• 在添加時，使用表達式驗證數據的合法性，若不合法則拋出異常；

有朋友說這個功能像 abp 的租戶，但這是更小單位的過濾+驗證，確保數據安全。

有朋友說這個功能省事，但我以爲是省心。

分表與分庫

GuidRepository 做爲分存式倉儲將實現了分表與分庫（不支持跨服務器分庫）的封裝類。

var logRepository = fsql.GetGuidRepository<Log>(null, oldname => $"{oldname}_{DateTime.Now.ToString("YYYYMM")}");

上面咱們獲得一個日誌倉儲實例按年月分表，使用它 CURD 最終會操做 Log_201903 表。

注意：雖然 FreeSql 支持 CodeFirst 遷移，但不提供遷移分表，開發環境中仍然能夠遷移 Log 表。

讀寫分離

FreeSql 支持數據庫讀寫分離，本功能是客戶端的讀寫分離行爲，數據庫服務器該怎麼配置仍然那樣配置，不受本功能影響，爲了方便描術後面講到的【讀寫分離】都是指客戶端的功能支持。

各類數據庫的讀寫方案不一，數據庫端開啓讀寫分離功能後，讀寫分離的實現大體分爲如下幾種：

一、nginx代理，配置繁瑣且容易出錯；

二、中件間，如MySql可使用MyCat，可是其餘數據庫怎麼辦？

三、在client端支持；

FreeSql 實現了第3種方案，支持一個【主庫】多個【從庫】，【從庫】的查詢策略爲隨機方式。

若某【從庫】發生故障，將切換到其餘可用【從庫】，若已所有不可用則使用【主庫】查詢。

出現故障【從庫】被隔離起來間隔性的檢查可用狀態，以待恢復。以 mysql 爲例：

var connstr = "Data Source=127.0.0.1;Port=3306;User ID=root;Password=root;" + 
    "Initial Catalog=cccddd;Charset=utf8;SslMode=none;Max pool size=10";

IFreeSql fsql = new FreeSql.FreeSqlBuilder()
    .UseConnectionString(FreeSql.DataType.MySql, connstr)
    .UseSlave("connectionString1", "connectionString2") //使用從數據庫，支持多個
    .Build();

select.Where(a => a.Id == 1).ToOne(); //讀【從庫】（默認）
select.Master().WhereId(a => a.Id == 1).ToOne(); //強制讀【主庫】

其餘特性

• [x] 支持 CodeFirst 遷移；
• [x] 支持 DbFirst 從數據庫導入實體類，支持三種模板生成器；
• [x] 採用 ExpressionTree 高性能讀取數據；
• [x] 支持深刻的類型映射，好比pgsql的數組類型；
• [x] 支持豐富的表達式函數；
• [x] 支持導航屬性查詢，和延時加載；
• [x] 支持同步/異步數據庫操做方法，豐富多彩的鏈式查詢方法；
• [x] 支持讀寫分離、分表分庫；
• [x] 支持多種數據庫，MySql/SqlServer/PostgreSQL/Oracle/Sqlite；

結束語

這個點我還沒吃晚飯，對今天更新的 v0.1.11 做兩個小時的測試。以爲好請獻上寶貴一星，謝謝支持！

github: https://github.com/2881099/FreeSql