NET5 ORM 六大新功能 – SqlSugar 5.0.2.7

  • A+
所属分类:.NET技术
摘要

SqlSugar是一款 老牌 .NET 开源ORM框架,并且在第一时间兼容.NET5,由果糖大数据科技团队维护和更新 ,Github star数仅次于EF 和 Dapper


介绍 

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); }

执行代码输出结果:

 NET5 ORM   六大新功能 - SqlSugar 5.0.2.7

 NET5 ORM   六大新功能 - SqlSugar 5.0.2.7 

 

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

NET5 ORM   六大新功能 - SqlSugar 5.0.2.7

 

 

源码下载:

https://github.com/donet5/SqlSugar 没点关注的点一波关注