1. 程式人生 > >基於Dapper的開源Lambda擴充套件,且支援分庫分表自動生成實體之基礎介紹

基於Dapper的開源Lambda擴充套件,且支援分庫分表自動生成實體之基礎介紹

LnskyDB

LnskyDB是基於Dapper的Lambda擴充套件,支援按時間分庫分表,也可以自定義分庫分表方法.而且可以T4生成實體類免去手寫實體類的煩惱.

文件地址: https://liningit.github.io/LnskyDB/

開源地址: https://github.com/liningit/LnskyDB

nuget地址: https://www.nuget.org/packages/LnskyDB/
前面我們介紹了LnskyDB的增刪改查操作,接下來我們結束幾個基礎類.倉儲及實體類還有T4如何生成實體

倉儲

倉儲的獲取有兩種方式一種是呼叫RepositoryFactory.Create<T>()

方法建立,還有一種是建立倉儲類繼承Repository<T>.如果需要介面也可以建立介面繼承IRepository<T>.
倉儲中的CommandTimeout可以設定查詢超時時間

實體類

建立實體類需繼承BaseDBModel,並且實現裡面的抽象方法

1.主鍵配置

GetDBModel_PKCols()返回表的主鍵名稱,必須. 示例:

private static ImmutableList<string> _DBModel_PKCols = ImmutableList.Create("SysNo");
public override ImmutableList<string> GetDBModel_PKCols() => _DBModel_PKCols; 

2.自增列配置

GetDBModel_IncrementCol(); SetIncrementValue(int value)返回表的自增列,以及設定自增列值,如有自增列則必須. 示例:

public override string GetDBModel_IncrementCol() => "Id";
public override void SetIncrementValue(int value)
{
    Id = value;
}

3.庫名錶名配置

GetDBModel_TableName() GetDBModel_DBName()返回表名及庫名,必須.如果是分庫分表則後面待{0}.示例:

public override string GetDBModel_TableName() => "Purify_ProductSaleByDay{0}";
public override string GetDBModel_DBName() => "Lnsky{0}";

4.分庫分表配置

GetShuffledModel()SetShuffledData(object obj)返回分庫分表物件,及實現設定分庫分表值.示例:

public override ShuffledModel GetShuffledModel()
{
    if (DBModel_ShuffledTempDate == DateTime.MinValue)
    {
        throw new NoShuffledException(GetDBModel_TableName(), "分庫分表時間,ShuffledTempDate");
    }
    return ShuffledByDbTable(DBModel_ShuffledTempDate);
}
DateTime _DBModel_ShuffledTempDate;
[JsonIgnore]
public DateTime DBModel_ShuffledTempDate { get { return StatisticalDate != DateTime.MinValue ? StatisticalDate : _DBModel_ShuffledTempDate; } set { _DBModel_ShuffledTempDate = value; } }

public override void SetShuffledData(object obj) { DBModel_ShuffledTempDate = (DateTime)obj; }

T4模版生成

專案'LnskyDB.Demo'中的T4目錄下有T4自動生成實體類的程式碼.大家可以根據自己的實際情況進行修改配置
'DbHelper.ttinclude'中的'Config.DbConfigs'是用來編寫生成配置的

  1. ConnectionString表示連線字串
  2. Database是表示資料庫實際名稱
  3. DatabaseName是表示儲存在'appsettings.json'中的名稱
  4. TableNames表示要生成那些表表示全部Name_表示字首是Name_的
  5. ExcludeTableName表示要排除那些表
  6. ShuffledConfigs表示分庫分表配置儲存表名,ShuffledConfig的鍵值對形式
  7. ShuffledConfig分庫分表具體配置ShuffledData根據那一列分庫分表,MinShuffledTempDate表示最小值

'Entity.tt'是生成實體,倉儲及倉儲介面的實際程式碼.大家可以根據自己專案的實際情況修