NET5 ORM 六大新功能 - SqlSugar 5.0.2.7

介紹 

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 沒點關注的點一波關注