专栏首页不做码农的开发者C# 数据操作系列 - 15 SqlSugar 增删改查详解

C# 数据操作系列 - 15 SqlSugar 增删改查详解

0. 前言

继上一篇,以及上上篇,我们对SqlSugar有了一个大概的认识,但是这并不完美,因为那些都是理论知识,无法描述我们工程开发中实际情况。而这一篇,将带领小伙伴们一起试着写一个能在工程中使用的模板类。

1. 创建一个Client

SqlSugar在操作的时候需要一个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<T> CreateClient<T>() where T : class, new()
    {
        return Client.GetSimpleClient<T>();
    }
}

SqlSugar 提供了一个SimpleClient,这里面有很多可以直接拿来用的方法,而且这个是一个泛型类。也就是说我们可以使用它对单个实体类进行操作,这在开发中很重要。

2. 插入数据

对于一个程序而言,数据就像是血液一样重要。对于ORM框架,插入是一切来源的基础。所以我们先来看看SqlSugar的插入是怎样的吧:

2.1 简单的插入模式

public bool Insert(T insertObj);
public bool InsertRange(T[] insertObjs);
public bool InsertRange(List<T> insertObjs);

这是SqlSugar在SimpleClient里提供的两个默认插入方法,一个是插入单个实体对象,一个是插入一组对象。

默认情况下,SqlSugar插入并不会将主键返回给数据。如果后续操作需要当前数据的主键,则可以调用另外一个方法:

public int InsertReturnIdentity(T insertObj);

通过这个方法可以获取一个默认的int类型主键值。

2.2 高级玩法

SqlSugar还有一种插入模式,通过AsInsertable返回一个 IInsertable泛型接口:

public IInsertable<T> AsInsertable(T insertObj);
public IInsertable<T> AsInsertable(T[] insertObjs);
public IInsertable<T> AsInsertable(List<T> insertObjs);

这种模式与SimpleClient的普通插入模式不同,它并不会直接执行插入动作,需要手动调用并执行插入动作:

int ExecuteCommand();

执行动作,然后返回受影响的行数。

bool ExecuteCommandIdentityIntoEntity();

执行动作,然后将主键插入实体对象,返回插入结果。执行完成后,主键数据保存到实体示例中。

long ExecuteReturnBigIdentity();
int ExecuteReturnIdentity();

执行动作,然后返回主键值,不会更新实体。

有一点值得特别注意:

所有会返回主键的插入都只针对单个数据,如果一次插入多个数据,并不会返回主键信息也无法将主键信息更新入实体中。

以上都是全列插入,SqlSugar还提供了只插入部分列和忽略某些列两种模式:

IInsertable<T> InsertColumns(Expression<Func<T, object>> columns);// 满足条件的插入,其他列则不插入
IInsertable<T> InsertColumns(params string[] columns);//插入指定列名
IInsertable<T> IgnoreColumns(Expression<Func<T, object>> columns);// 忽略满足条件的列,插入其他列
IInsertable<T> IgnoreColumns(params string[] columns);// 忽略这几个列
IInsertable<T> IgnoreColumns(bool ignoreNullColumn, bool isOffIdentity = false);//指定是否忽略Null列,并是否强制插入主键

3. 更新或插入

介绍完插入,那么来介绍一下更新。正所谓,没有更新数据就是一滩死水,有了更新数据才有了变化。所以,就让我们来看看如何优雅的更新数据吧:

3.1 简单模式

先来两个最简单的:

public bool Update(T updateObj);
public bool UpdateRange(T[] updateObjs);
public bool UpdateRange(List<T> updateObjs);

传入实体,直接更新到数据库中,需要注意的是这种更新模式只需要保证主键有值,且与之对应即可。

public bool Update(Expression<Func<T, T>> columns, Expression<Func<T, bool>> whereExpression);

这是另一种条件更新,会更新满足whereExpression的所有元素,更新示例:

personClient.Update(p=>new Person
{
    Age = 1
}, p=>p.Id == 1);

columns需要返回一个要更新的对象的属性列,也就是在columns中设置需要更新的内容。

3.2 高级模式

同样,通过AsUpdateable开启高级模式:

public IUpdateable<T> AsUpdateable(T[] updateObjs);
public IUpdateable<T> AsUpdateable(T updateObj);
public IUpdateable<T> AsUpdateable(List<T> updateObjs);

然后可以针对这些今天更多的操作:

int ExecuteCommand();

返回命令执行影响的行数

bool ExecuteCommandHasChange();

返回是否有变化,也就是影响行数是否大于0。

  • 只更新某些列:
IUpdateable<T> SetColumns(Expression<Func<T, bool>> columns);

更新示例:

personClient.AsUpdateable(d).SetColumns(t=>t.Age ==2).ExecuteCommand();

传入一个lambda表达式,使数据满足lambda表达式。要求lambda表达式只能用 == 来判断列是否等于某个值。

IUpdateable<T> SetColumns(Expression<Func<T, T>> columns);
IUpdateable<T> UpdateColumns(params string[] columns);
IUpdateable<T> UpdateColumns(Expression<Func<T, object>> columns);

传入要更新的实际列名。其中 object 用来接一个匿名对象,其中属性名字就是要更新的值。

  • 不更新某些列
IUpdateable<T> IgnoreColumns(params string[] columns);// 忽略传入的列名
IUpdateable<T> IgnoreColumns(Expression<Func<T, object>> columns);// 用匿名对象表示要忽略的列名
IUpdateable<T> IgnoreColumns(bool ignoreAllNullColumns, bool isOffIdentity = false, bool ignoreAllDefaultValue = false);// 设置是否忽略Null列,是否强制更新主键,是否忽略所有默认值列
  • 条件更新
IUpdateable<T> Where(Expression<Func<T, bool>> expression);
IUpdateable<T> Where(string fieldName, string conditionalType, object fieldValue);
IUpdateable<T> Where(string whereSql, object parameters = null);
IUpdateable<T> WhereColumns(Expression<Func<T, object>> columns);
IUpdateable<T> WhereColumns(string columnName);
IUpdateable<T> WhereColumns(string[] columnNames);

来,简单猜一猜这几个是什么意思呢?

可以说很简单明了的几种条件设置模式,lambda表示筛选更新数据,字段值判断条件更新。

其中 conditionType的值,推荐使用 ConditionalType枚举的值。

3.3 更新或插入

在实际开发中可能会遇到插入或更新是走的一个方法,所以我们就要寻找一个可以直接更新或插入的方法。SqlSugar为此提供了解决方案:

ISaveable<T> Saveable<T>(T saveObject) where T : class, new();
ISaveable<T> Saveable<T>(List<T> saveObjects) where T : class, new();

不过这个方法是在SugarClient里,我们可以通过:

public ISqlSugarClient AsSugarClient();

在SimpleClient中获得 与之关联的SugarClient对象。

关于更新或插入判断标准是,主键是否有值。如果主键有值且在数据库中存在该条记录,则执行更新,否则执行插入。

4. 删除

删除在实际开发过程中是一个非常重要的功能点,所以如何快速有效的删除数据也是一件很重要的事。那么,就来看看如何执行删除吧:

public bool Delete(Expression<Func<T, bool>> 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<Func<T, bool>> whereExpression);// 查询是否存在符合条件的数据
public int Count(Expression<Func<T, bool>> whereExpression);// 获取满足条件的数量
public T GetById([Dynamic] dynamic id);//根据主键获取一个实例
public bool IsAny(Expression<Func<T, bool>> whereExpression);//返回满足条件的一个对象
public List<T> GetList();// 以List的形式返回所有数据
public List<T> GetList(Expression<Func<T, bool>> whereExpression);//返回符合条件的所有数据

分页获取数据:

public List<T> GetPageList(Expression<Func<T, bool>> whereExpression, PageModel page);
public List<T> GetPageList(Expression<Func<T, bool>> whereExpression, PageModel page, Expression<Func<T, object>> orderByExpression = null, OrderByType orderByType = OrderByType.Asc);
public List<T> GetPageList(List<IConditionalModel> conditionalList, PageModel page);
public List<T> GetPageList(List<IConditionalModel> conditionalList, PageModel page, Expression<Func<T, object>> 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<string,object> 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<IConditionalModel>
{
    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的知识点和设置。

本文分享自微信公众号 - 不做码农的开发者(attachie_1),作者:高先生工作室

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2020-05-25

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • C# 数据操作系列 - 7. EF Core 导航属性配置

    在上一篇,大概介绍了Entity Framework Core关于关系映射的逻辑。在上一篇中留下了EF的外键映射没有说,也就是一对一,一对多,多对一,多对多的关...

    程序员小高
  • C# 数据操作系列 - 16 SqlSugar 完结篇

    前一篇我们详细的介绍了SqlSugar的增删改查,那些已经满足我们在日常工程开发中的使用了。但是还有一点点在开发中并不常用,但是却非常有用的方法。接下来让我们一...

    程序员小高
  • C# 数据操作系列 - 2. ADO.NET操作

    在上一篇中初略的介绍了一下SQL的基本写法,这一篇开始我们正式步入C#操作数据库的范围。通过这一系列的内容,我想大家能对于数据库交互有了一定的认识和基础。闲话不...

    程序员小高
  • 解决wordpress搬家后,首页缩略图不显示

    这自然也是宝塔一键迁移所带来的一些小问题。我的妹子图网站怎么能不显示缩略图呢,看解决方法。

    SweetHunter
  • 再见,AOP,怀恋和你在一起的日子!

    这是aop最后一篇文章了,本文带你深入理解@EnableAspectJAutoProxy,这篇文章可能会颠覆你以前所掌握的一些知识,让你醍醐灌顶,欣喜若狂!

    路人甲Java
  • Spring AOP注解开发

    PHY_68
  • 搞定数据结构-栈和队列

    如下,使用栈结构操作. “网”这个错别字在栈顶,“网”改成”望”只需要将“网”从栈顶移除重新写入”望”.

    用户3045442
  • 工行b2c

    2.商户按照工行B2C支付1.0.0.11接口形成提交数据,并使用工行提供API和商户证书对订单数据签名,形成form表单返回客户浏览器,表单action地址指...

    用户1434423
  • 性能工具之Ngrinder之Get请求脚本编写

    背景:做性能测试脚本是一个实际下功夫的地方,工作中常见也就是key-value,json方式比较多,那么 nGrinder脚本咱们怎么编写以下简单介绍。

    高楼Zee
  • 创建多线程的4种方式

    Noneplus

扫码关注云+社区

领取腾讯云代金券