介紹
SqlSugar是一款 老牌 .NET 開源ORM框架,並且在第一時間相容.NET5,由果糖大資料科技團隊維護和更新 ,Github star數僅次於EF 和 Dapper
優點: 簡單易用、功能齊全、高效能、輕量級、服務齊全、有專業技術支援一天18小時服務
支援資料庫:MySql、SqlServer、Sqlite、Oracle 、 postgresql、達夢、人大金倉
1、功能升級:高階儲存
該功能滿足各種複雜的增、刪、改 儲存 ,還適合匯入資料驗證
以前的程式碼
var x = Db.Storageable(list2) .SplitUpdate(it => it.Any(y=>y.Id==it.Item.Id))//資料庫存在更新 .SplitInsert(it => true ) .ToStorage();//其餘插入 x.AsInsertable.ExecuteCommand(); //執行插入 x.AsUpdateable.ExecuteCommand(); //執行更新
現在的程式碼
var x = Db.Storageable(list2) .SplitUpdate(it => it.Any())//資料庫存在更新 .SplitInsert(it => true ) .ToStorage();//其餘插入 x.AsInsertable.ExecuteCommand(); //執行插入 x.AsUpdateable.ExecuteCommand(); //執行更新
更簡潔的寫法
var x = Db.Storageable(list2).Saveable().ToStorage();//其餘插入 x.AsInsertable.ExecuteCommand(); //執行插入 x.AsUpdateable.ExecuteCommand(); //執行更新
從上面的程式碼可以看出Storageable已經完全取代了Db.Saveable功能,並且比db.saveable功能有更強的效能、支援多主鍵、支援拆分資料和驗證
例項用例
專案實踐
var x = Db.Storageable(list2) .SplitError(it => string.IsNullOrEmpty(it.Item.Name), "名稱不能為空") .SplitError(it => it.Item.Create<DateTime.Now.AddYears(-1),"不是今年的資料") .Saveable()//比以前少了很多程式碼 .ToStorage(); //插成功資料插入和更新
x.AsInsertable.ExecuteCommand(); x.AsUpdateable.ExecuteCommand();
//輸出結果
Console.WriteLine(" 插入 {0} 更新{1} 錯誤資料{2} 不計算資料{3} 刪除資料{4},總共{5}" , x.InsertList.Count, x.UpdateList.Count, x.ErrorList.Count, x.IgnoreList.Count, x.DeleteList.Count, x.TotalList.Count );
foreach (var item in x.ErrorList) { Console.WriteLine("id等於"+item.Item.Id+" : "+item.StorageMessage); }
執行程式碼輸出結果:
2、新功能:呼叫實體方法
當我們在插入或者更新的時候 有些值需要賦值比如使用者ID 建立人 建立時間等
public static void Insert2() { db.Insertable(new UnitInsertMethod() { Name = "1" }).CallEntityMethod(it=>it.Create()).ExecuteCommand(); db.Updateable(new UnitInsertMethod() { Name = "1" }).CallEntityMethod(it => it.modify("admint")).ExecuteCommand(); } public class UnitInsertMethod { [SqlSugar.SugarColumn(IsPrimaryKey = true, IsIdentity = true)] public int Id { get; set; } public string Name { get; set; } public DateTime Time { get; set; } [SqlSugar.SugarColumn(IsNullable =true)] public string UserId { get; set; } public void Create() { this.Time = DateTime.Now; this.UserId = "1"; } public void modify(string a) { this.Time = DateTime.Now; this.UserId = a; } }
當然你們也可以將CallEntityMehod封裝到倉儲,將公用屬性封裝到基類 ,這樣就不需要每次都寫一遍
3、新功能: 多對多 跳過中間表查詢
隨著EF CORE6支援多對多中間表查詢
SqlSugar也支援了多對多查詢和EF的區別的 SQLSUGAR沒有任何配置,對實體名稱沒有任何依賴
想用的時候就用Mapper來指定他們的關係,對老表的支援度非常友好
var list9= Db.Queryable<TableA>() .Mapper<TableA, TableB, ABMap>(it => ManyToMany.Config(it.Aid, it.Bid)).ToList(); //list9[0].ChildList 就會有值
實體結構非常清晰
public class TableA{ [SugarColumn(IsPrimaryKey =true,IsIdentity =true)] public int id { get; set; } public string Name { get; set; } [SugarColumn(IsIgnore =true)] public List<TableB> Childlist { get; set; } } //中間表 public class ABMap{ public int Aid { get; set; } public int Bid { get; set; } } public class TableB { [SugarColumn(IsPrimaryKey = true, IsIdentity = true)] public int id { get; set; } public string Name { get; set; } }
後續還打算支援無限級別Mapper功能,已經在計劃中了
4、新功能:上級查詢
之前版本支援了查詢所有的下級
var tree = db.Queryable<Tree>().ToTree(it=>it.Child,it=>it.ParentId,0); //第三個引數為0代表 parent為0是第一級 //實體 public class Tree { [SqlSugar.SugarColumn(IsPrimaryKey =true)] public int Id { get; set; } public string Name { get; set; } public int ParentId { get; set; } [SqlSugar.SugarColumn(IsIgnore = true)] public List<Tree> Child { get; set; } }
但是有很多使用者需要儲存當前節點的Path,所以SqlSugar又提供了一個獲取所有上級節點的方式
db.Queryable<Tree>().ToParentList(it=>it.Parent,11);//獲取主鍵為11的所有上級物件
5、新功能: CodeFirst禁止刪除列 和禁止更新
禁止刪列
實體中的列刪除那麼資料庫也會刪除當前列(SQLITE除外) ,設定成下面的寫法 就不會自動刪除列了
[SugarTable("Custom","客戶",IsDisabledDelete =true)] public class Custom { public int Id { get; set; } public string Name { get; set; } }
禁止所有更新表操作
這樣設定後會大大提高CodeFirst的執行效能,無論你的實體如何修改,都 不會修改資料庫中的表,新增可以
[SugarTable("Custom","客戶",IsDisabledUpdateAll = =true)] public class Custom { public int Id { get; set; } public string Name { get; set; } }
6、SqlSugar.IOC
版本支援:
.NET CORE 3.1
.NET5
SqlSugarCore 5.0.2.6 +
安裝
NUGET :SqlSugar.IOC
注入SqlSugar例項
public void ConfigureServices(IServiceCollection services) { services.AddSqlSugar(new IocConfig() { ConnectionString = "server=.;uid=sa;pwd=haosql;database=SQLSUGAR4XTEST", DbType = IocDbType.SqlServer, IsAutoCloseConnection = true//自動釋放 }); }
用法非常簡單
DbScoped.Sugar等同於Scoped生命週期的SqlSugarClient
public List<UserOrgMapping> GetMapping() { List<UserOrgMapping> result=DbScoped.Sugar.Queryable<UserOrgMapping>().ToList(); DbScoped.Sugar.Deleteable<Student>().In(1).ExecuteCommand(); return result; }
更多用法可以參考:http://www.donet5.com/Doc/10
SqlSugar感謝大家一直支援和使用,後續還會根據使用者的真實需求進行更新和創新
如何安裝5.0.2.7
原始碼下載:
https://github.com/donet5/SqlSugar 沒點關注的點一波關注