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 没点关注的点一波关注
