- A+
介绍
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 没点关注的点一波关注