C# 数据操作系列 |
您所在的位置：网站首页 › saveable什么意思 › C# 数据操作系列 |
C# 数据操作系列
|
0. 前言
继上一篇，以及上上篇，我们对SqlSugar有了一个大概的认识，但是这并不完美，因为那些都是理论知识，无法描述我们工程开发中实际情况。而这一篇，将带领小伙伴们一起试着写一个能在工程中使用的模板类。 1. 创建一个ClientSqlSugar在操作的时候需要一个Client，用来管理数据库连接，并操作数据库。所以我们写一个DbContext用来创建Client： public class DefaultContext { public SqlSugarClient Client { get; } public DefaultContext(string connectionString, DbType dbType) { Client = new SqlSugarClient(new ConnectionConfig { ConnectionString = connectionString,//"Data Source=./demo.db", DbType = dbType, IsAutoCloseConnection = true, InitKeyType = InitKeyType.Attribute }); Client.CodeFirst.InitTables(typeof(Dept), typeof(Person), typeof(Employee)); Client.Aop.OnLogExecuting = (sql, paramters) => { Console.WriteLine(sql); }; } public SimpleClient CreateClient() where T : class, new() { return Client.GetSimpleClient(); } }SqlSugar 提供了一个SimpleClient，这里面有很多可以直接拿来用的方法，而且这个是一个泛型类。也就是说我们可以使用它对单个实体类进行操作，这在开发中很重要。 2. 插入数据对于一个程序而言，数据就像是血液一样重要。对于ORM框架，插入是一切来源的基础。所以我们先来看看SqlSugar的插入是怎样的吧： 2.1 简单的插入模式 public bool Insert(T insertObj); public bool InsertRange(T[] insertObjs); public bool InsertRange(List insertObjs);这是SqlSugar在SimpleClient里提供的两个默认插入方法，一个是插入单个实体对象，一个是插入一组对象。 默认情况下，SqlSugar插入并不会将主键返回给数据。如果后续操作需要当前数据的主键，则可以调用另外一个方法： public int InsertReturnIdentity(T insertObj);通过这个方法可以获取一个默认的int类型主键值。 2.2 高级玩法SqlSugar还有一种插入模式，通过AsInsertable返回一个 IInsertable泛型接口： public IInsertable AsInsertable(T insertObj); public IInsertable AsInsertable(T[] insertObjs); public IInsertable AsInsertable(List insertObjs);这种模式与SimpleClient的普通插入模式不同，它并不会直接执行插入动作，需要手动调用并执行插入动作： int ExecuteCommand();执行动作，然后返回受影响的行数。 bool ExecuteCommandIdentityIntoEntity();执行动作，然后将主键插入实体对象，返回插入结果。执行完成后，主键数据保存到实体示例中。 long ExecuteReturnBigIdentity(); int ExecuteReturnIdentity();执行动作，然后返回主键值，不会更新实体。 有一点值得特别注意： 所有会返回主键的插入都只针对单个数据，如果一次插入多个数据，并不会返回主键信息也无法将主键信息更新入实体中。 以上都是全列插入，SqlSugar还提供了只插入部分列和忽略某些列两种模式： IInsertable InsertColumns(Expression columns);// 满足条件的插入，其他列则不插入 IInsertable InsertColumns(params string[] columns);//插入指定列名 IInsertable IgnoreColumns(Expression columns);// 忽略满足条件的列，插入其他列 IInsertable IgnoreColumns(params string[] columns);// 忽略这几个列 IInsertable IgnoreColumns(bool ignoreNullColumn, bool isOffIdentity = false);//指定是否忽略Null列，并是否强制插入主键 3. 更新或插入介绍完插入，那么来介绍一下更新。正所谓，没有更新数据就是一滩死水，有了更新数据才有了变化。所以，就让我们来看看如何优雅的更新数据吧： 3.1 简单模式先来两个最简单的： public bool Update(T updateObj); public bool UpdateRange(T[] updateObjs); public bool UpdateRange(List updateObjs);传入实体，直接更新到数据库中，需要注意的是这种更新模式只需要保证主键有值，且与之对应即可。 public bool Update(Expression columns, Expression whereExpression);这是另一种条件更新，会更新满足whereExpression的所有元素，更新示例： personClient.Update(p=>new Person { Age = 1 }, p=>p.Id == 1);columns需要返回一个要更新的对象的属性列，也就是在columns中设置需要更新的内容。 3.2 高级模式同样，通过AsUpdateable开启高级模式： public IUpdateable AsUpdateable(T[] updateObjs); public IUpdateable AsUpdateable(T updateObj); public IUpdateable AsUpdateable(List updateObjs);然后可以针对这些今天更多的操作： int ExecuteCommand();返回命令执行影响的行数 bool ExecuteCommandHasChange();返回是否有变化，也就是影响行数是否大于0。 只更新某些列： IUpdateable SetColumns(Expression columns);更新示例： personClient.AsUpdateable(d).SetColumns(t=>t.Age ==2).ExecuteCommand();传入一个lambda表达式，使数据满足lambda表达式。要求lambda表达式只能用 == 来判断列是否等于某个值。 IUpdateable SetColumns(Expression columns); IUpdateable UpdateColumns(params string[] columns); IUpdateable UpdateColumns(Expression columns);传入要更新的实际列名。其中 object 用来接一个匿名对象，其中属性名字就是要更新的值。 不更新某些列 IUpdateable IgnoreColumns(params string[] columns);// 忽略传入的列名 IUpdateable IgnoreColumns(Expression columns);// 用匿名对象表示要忽略的列名 IUpdateable IgnoreColumns(bool ignoreAllNullColumns, bool isOffIdentity = false, bool ignoreAllDefaultValue = false);// 设置是否忽略Null列，是否强制更新主键，是否忽略所有默认值列 条件更新 IUpdateable Where(Expression expression); IUpdateable Where(string fieldName, string conditionalType, object fieldValue); IUpdateable Where(string whereSql, object parameters = null); IUpdateable WhereColumns(Expression columns); IUpdateable WhereColumns(string columnName); IUpdateable WhereColumns(string[] columnNames);来，简单猜一猜这几个是什么意思呢？ 可以说很简单明了的几种条件设置模式，lambda表示筛选更新数据，字段值判断条件更新。 其中 conditionType的值，推荐使用 ConditionalType枚举的值。 3.3 更新或插入在实际开发中可能会遇到插入或更新是走的一个方法，所以我们就要寻找一个可以直接更新或插入的方法。SqlSugar为此提供了解决方案： ISaveable Saveable(T saveObject) where T : class, new(); ISaveable Saveable(List saveObjects) where T : class, new();不过这个方法是在SugarClient里，我们可以通过： public ISqlSugarClient AsSugarClient();在SimpleClient中获得 与之关联的SugarClient对象。 关于更新或插入判断标准是，主键是否有值。如果主键有值且在数据库中存在该条记录，则执行更新，否则执行插入。 4. 删除删除在实际开发过程中是一个非常重要的功能点，所以如何快速有效的删除数据也是一件很重要的事。那么，就来看看如何执行删除吧： public bool Delete(Expression whereExpression); public bool Delete(T deleteObj); public bool DeleteById([Dynamic] dynamic id); public bool DeleteByIds([Dynamic(new[] { false, true })] dynamic[] ids);删除没有其他需要注意的地方，第一个是条件删除，所有满足条件的都要删除。第二个删除单个对象，后面两个根据主键删除对象。 悄悄吐槽一下，主键的地方用object会比较好一点，因为动态对象会增加一次装箱拆箱的过程。 当然了，删除也有AsDeleteable方法。IDeleteable接口特别提供了根据sql语句删除的方法，除此之外没有别的需要注意的地方了。 5. 查询一个好的ORM框架，至少五分功力在查询上，如何更快更准的查询成为了现在开发对ORM框架的要求。同时简单易用更是程序员对ORM的期望。 那么我们来看看SqlSugar在查询上的功力吧： public bool IsAny(Expression whereExpression);// 查询是否存在符合条件的数据 public int Count(Expression whereExpression);// 获取满足条件的数量 public T GetById([Dynamic] dynamic id);//根据主键获取一个实例 public bool IsAny(Expression whereExpression);//返回满足条件的一个对象 public List GetList();// 以List的形式返回所有数据 public List GetList(Expression whereExpression);//返回符合条件的所有数据分页获取数据： public List GetPageList(Expression whereExpression, PageModel page); public List GetPageList(Expression whereExpression, PageModel page, Expression orderByExpression = null, OrderByType orderByType = OrderByType.Asc); public List GetPageList(List conditionalList, PageModel page); public List GetPageList(List conditionalList, PageModel page, Expression orderByExpression = null, OrderByType orderByType = OrderByType.Asc);其中IConditionModel是一个空的接口，用来定义规范查询规范，实际上使用的是类： public class ConditionalModel: IConditionalModel { public ConditionalModel() { this.ConditionalType = ConditionalType.Equal; } public string FieldName { get; set; } public string FieldValue { get; set; } public ConditionalType ConditionalType { get; set; } public Func FieldValueConvertFunc { get; set; } }那么，我们看一下 ConditionType，定义了各种判断依据： public enum ConditionalType { Equal=0, Like=1, GreaterThan =2, GreaterThanOrEqual = 3, LessThan=4, LessThanOrEqual = 5, In=6, NotIn=7, LikeLeft=8, LikeRight=9, NoEqual=10, IsNullOrEmpty=11, IsNot=12, NoLike = 13, }那么我们简单看一下 使用IConditionModel进行分页是怎样的效果： var list = personClient.GetPageList(new List { new ConditionalModel { FieldName = "Age", FieldValue = "3", ConditionalType = ConditionalType.LessThan } }, pageModel);生成如下SQL语句： SELECT COUNT(1) FROM (SELECT `Id`,`Name`,`Age` FROM `Person` WHERE Age < @ConditionalAge0 ) CountTable SELECT `Id`,`Name`,`Age` FROM `Person` WHERE Age < @ConditionalAge0 LIMIT 0,2可以看出两者并没有区别，只不过是不同的查询习惯。 6. 总结按照之前的习惯，到目前应该可以结束了。但是SqlSugar还有一些很重要的地方没有介绍，所以就加个下期预告 下一篇将为大家分析SqlSugar的一些更高级的内容，查询的高级模式、事务以及批量操作 好，总结一下这一篇，我们在这一篇看到了SqlSugar在增删改查上的亮点，可以说更贴合实际业务需求开发。嗯，悄悄给个赞。 再有三篇的内容《C# 数据操作系列》就要完结了。从下一系列开始，就要步入工作中最重要的技术栈了：Asp.net Core。这是可以写入简历的。嗯，没错。下一系列计划以实战的形式介绍asp.net core的知识点和设置。 更多内容烦请关注我的博客《高先生小屋》
|
【本文地址】