C# 数据操作系列 – 16 SqlSugar 完结篇

0. 前言

前一篇我们详细的先容了SqlSugar的增删改查,那些已经知足我们在一样平常工程开发中的使用了。然则另有一点点在开发中并不常用,然则却异常有用的方式。接下来让我们一起来看看另有哪些有意思的内容。

1. 差别寻常的查询

之前先容了针对单个表的查询,同样也是相对简朴的查询模式。虽然开发完全够用,然则难免会遇到一些特殊的情形。而下面这些方式就是为领会决这些意料之外。

1.1 多表查询

SqlSugar提供了一种特殊的多表查询方案,使用IQueryable接口 。来看看是怎样操作的吧:

ISugarQueryable<T, T2> Queryable<T, T2>(Expression<Func<T, T2, object[]>> joinExpression);
ISugarQueryable<T, T2> Queryable<T, T2>(ISugarQueryable<T> joinQueryable1, ISugarQueryable<T2> joinQueryable2, Expression<Func<T, T2, bool>> joinExpression)
            where T : class, new()
            where T2 : class, new();
ISugarQueryable<T, T2> Queryable<T, T2>(ISugarQueryable<T> joinQueryable1, ISugarQueryable<T2> joinQueryable2, JoinType joinType, Expression<Func<T, T2, bool>> joinExpression)
            where T : class, new()
            where T2 : class, new();
ISugarQueryable<T, T2> Queryable<T, T2>(Expression<Func<T, T2, bool>> joinExpression) where T : class, new();

这些方式是属于SqlSugarClient类的方式,SqlSugar提供了最多12个泛型的方式支持,固然现实上开发中能遇到5个表的联查都很少。除非说是在做报表程序,否则就得审查一下数据表模子是否合理了。就以这四个方式为例,先容一下多表查询若何使用:

先来两个模子类:

public class Person
{
    [SugarColumn(IsPrimaryKey = true, IsIdentity = true)]
    public int Id { get; set; }
    public string Name { get; set; }
    public int Age { get; set; }
}
public class Employee
{
    [SugarColumn(IsPrimaryKey = true, IsIdentity = true)]
    public int Id { get; set; }
    public string Name { get; set; }
    public int PersonId { get; set; }
    [SugarColumn(IsIgnore = true)]
    public Person Person { get; set; }
}

简朴的形貌一下两个类的关系:一个雇员身份对应一小我私家,但一小我私家不一定会有一个雇员身份。

OK,先从第一个方式提及:

var query = context.Client.Queryable<Person, Employee>((pr, em)=>new object[]
{
    JoinType.Left,
    em.PersonId == pr.Id
});

第一个返回,是两个表的毗邻方式,例如:Left代表左毗邻,Inner示意内毗邻,Right示意右毗邻;第二个返回是两个表之间的毗邻依据。这是一个牢固的形式,返回一个Object数组,其中第一个是毗邻方式,第二个是通过哪个(些)字段举行毗邻。

天生的SQL类似如下:

SELECT `pr`.`Id`,`pr`.`Name`,`pr`.`Age` FROM `Person` pr Left JOIN `Employee` em ON ( `em`.`PersonId` = `pr`.`Id` ) 

第二个方式:

var query = context.Client.Queryable(context.Client.Queryable<Person>(),
                context.Client.Queryable<Employee>(),
                (pr, em) => pr.Id == em.PersonId);

这个方式使用内毗邻毗邻两个表,最后一个参数用来指定两个表之间的毗邻字段。

天生的SQL类似如下:

SELECT  `pr`.`Id` AS `Person.Id` , `pr`.`Name` AS `Person.Name` , `pr`.`Age` AS `Person.Age` , `em`.`Id` AS `Employee.Id` , `em`.`Name` AS `Employee.Name` , `em`.`PersonId` AS `Employee.PersonId` , `em`.`DeptId` AS `Employee.DeptId`  FROM  (SELECT `Id`,`Name`,`Age` FROM `Person`  ) pr  Inner JOIN  (SELECT `Id`,`Name`,`PersonId`,`DeptId` FROM `Employee`  ) em   ON ( `pr`.`Id` = `em`.`PersonId` )  

第三个方式在第二个方式的基础上,可以指定毗邻方式:

var query = context.Client.Queryable(context.Client.Queryable<Person>(),
                context.Client.Queryable<Employee>(),
                JoinType.Left,
                (pr, em) => pr.Id == em.PersonId);

最后一个:

var query = context.Client.Queryable<Person, Employee>((pr, em) => pr.Id == em.PersonId);

直接指定两个表之间的联系方式。

需要指出的是,所有的方式都只是返回了一个可查询工具,若是不举行后续的投影(举行select)则可能会提醒主键冲突。而且,所有的方式在举行ToXXX之前都不会立刻执行。

1.2 查询函数

SqlSugar添加了许多我们常用的方式,使其可以映射为sql语句。我们来看一下支持哪些内容:

public class SqlFunc
{
    public static TResult AggregateAvg<TResult>(TResult thisValue);//针对这个列举行取平均数统计
    public static int AggregateCount<TResult>(TResult thisValue);// 统计这个列数目 等价于 SQL里的 count(x)
    public static int AggregateDistinctCount<TResult>(TResult thisValue);/ 返回去重之后的数目
    public static TResult AggregateMax<TResult>(TResult thisValue);//返回最大值
    public static TResult AggregateMin<TResult>(TResult thisValue);// 返回最小值
    public static TResult AggregateSum<TResult>(TResult thisValue);// 返回总和
    public static bool Between(object value, object start, object end);// 判断列的值是否在两个值之间
    public static int CharIndex(string findChar, string searchValue);// SQL 的charindex
    public static bool Contains(string thisValue, string parameterValue);// 是否包罗
    public static bool ContainsArray<T>(T[] thisValue, object InField);// 数组是否包罗
    public static bool ContainsArray<T>(List<T> thisValue, object InField);//列表苏菲包罗
    public static bool ContainsArrayUseSqlParameters<T>(List<T> thisValue, object InField);//
    public static bool ContainsArrayUseSqlParameters<T>(T[] thisValue, object InField);//
    public static DateTime DateAdd(DateTime date, int addValue, DateType dataType);// 时间添加
    public static DateTime DateAdd(DateTime date, int addValue);// 日期添加
    public static bool DateIsSame(DateTime date1, DateTime date2);// 时间是否相同
    public static bool DateIsSame(DateTime? date1, DateTime? date2);//时间是否相同
    public static bool DateIsSame(DateTime date1, DateTime date2, DateType dataType);//时间是否相同,凭据DateType判断
    public static int DateValue(DateTime date, DateType dataType);// 凭据dateType, 返回详细的时间值
    public static bool EndsWith(string thisValue, string parameterValue);//字符串是否以某些值末端
    public static bool Equals(object thisValue, object parameterValue);//是否相等
    public static DateTime GetDate();//返回当前数据库时间
    public static string GetRandom();//
    public static TResult GetSelfAndAutoFill<TResult>(TResult value);//
    public static bool HasNumber(object thisValue);//返回是否大于0,且不能为Null
    public static bool HasValue(object thisValue);// 是否有值,且不为Null
    public static CaseThen IF(bool condition);// sql 里的if判断
    public static TResult IIF<TResult>(bool Expression, TResult thenValue, TResult elseValue);// case when
    public static TResult IsNull<TResult>(TResult thisValue, TResult ifNullValue);// sql 里的 IsNull
    public static bool IsNullOrEmpty(object thisValue);//判断是否是Null或者空
    public static int Length(object value);//取长度
    public static TResult MappingColumn<TResult>(TResult oldColumnName, string newColumnName);// 列名映射
    public static string MergeString(string value1, string value2);
    public static string MergeString(string value1, string value2, string value3, string value4);
    public static string MergeString(string value1, string value2, string value3, string value4, string value5);
    public static string MergeString(string value1, string value2, string value3, string value4, string value5, string value6);
    public static string MergeString(string value1, string value2, string value3);
    public static string MergeString(string value1, string value2, string value3, string value4, string value5, string value6, string value7);
    public static string Replace(object value, string oldChar, string newChar);// 替换
    public static bool StartsWith(string thisValue, string parameterValue);
    public static Subqueryable<T> Subqueryable<T>() where T : class, new();
    public static string Substring(object value, int index, int length);// 获取子串
    public static bool ToBool(object value);//类型转换
    public static DateTime ToDate(object value);// 类型转换
    public static decimal ToDecimal(object value);// 类型转换
    public static double ToDouble(object value);// 类型转换
    public static Guid ToGuid(object value);// 类型转换
    public static int ToInt32(object value);// 类型转换
    public static long ToInt64(object value);// 类型转换
    public static string ToLower(object thisValue);// 类型转换
    public static string ToString(object value);// 类型转换
    public static TimeSpan ToTime(object value);// 类型转换
    public static string ToUpper(object thisValue);// 类型转换
    public static string Trim(object thisValue);// 去除首尾的空格
}

这里的方式大多简朴直接,我就不逐一演示了。

1.3 动态查询

之前我们写的查询条件都是牢固好的,至少在编程的时刻就知道最终查询条件是什么了。然则在开发历程中,有时刻并不会那么早的知道最终查询条件或者说查询需要凭据用户输入来调整查询条件,那么若何实现呢?

常见的解决方案有以下几种:

  • 使用SQL语句,动态拼接SQL语句,然后凭据SQL语句执行返回效果
  • 在使用Lambda表达式时,举行动态拼接Lambda表达式
  • 获取IQueryable接口,然后凭据条件添加方式举行查询

这三种方式各有优略,使用查询接口会有一个显著的问题就是对应用层开放了更高的权限,使用SQL语句也是同样的原理。以是更相符逻辑的是使用动态拼接Lambda表达式。

固然,SqlSugar在这三种方案之上,提供了另外两种方案:

正是上一篇文中提到的IConditionalModel和WhereIF。我们先来看一下IConditionalModel若何使用:

var conditions = new List<IConditionalModel>();
var query = context.Client.Queryable<Person>().Where(conditions);

可以在Where中传入IConditionModel类型。SqlSugar提供了两个受支持的实现类:

public class ConditionalCollections : IConditionalModel
{
    public ConditionalCollections();
    public List<KeyValuePair<WhereType, ConditionalModel>> ConditionalList { get; set; }
}
public class ConditionalModel : IConditionalModel
{
    public ConditionalModel();
    public string FieldName { get; set; }
    public string FieldValue { get; set; }
    public ConditionalType ConditionalType { get; set; }
    public Func<string, object> FieldValueConvertFunc { get; set; }
}

对于一个聚集里的兄弟 ConditionModel,示意查询条件都是 and 关系。而ConditionCollections则差别,其中ConditionList示意是一个键值对聚集。键是WhereType类型,ConditionModel是值。我们先说说 WhereType:

3D视觉基础(基本原理及3D传感器基本参数)

public enum WhereType
{
    And = 0,
    Or = 1
}

划分示意And,Or。怎样明白呢?就是说,这一条键值对与前一个关系模子是And照样Or。

看一下示例:

// and id=100 and (id=1 or id=2 and id=1) 
conModels.Add(new ConditionalModel() { FieldName = "id", ConditionalType = ConditionalType.Equal, FieldValue = "100" });
conModels.Add(new ConditionalCollections() { ConditionalList=
new List<KeyValuePair<WhereType, SqlSugar.ConditionalModel>>()
{
    new  KeyValuePair<WhereType, ConditionalModel>
    ( WhereType.And ,
    new ConditionalModel() { FieldName = "id", ConditionalType = ConditionalType.Equal, FieldValue = "1" }),
    new  KeyValuePair<WhereType, ConditionalModel> 
    (WhereType.Or,
    new ConditionalModel() { FieldName = "id", ConditionalType = ConditionalType.Equal, FieldValue = "2" }),
    new  KeyValuePair<WhereType, ConditionalModel> 
    ( WhereType.And,
    new ConditionalModel() { FieldName = "id", ConditionalType = ConditionalType.Equal, FieldValue = "2" })
}
});
var student = db.Queryable<Student>().Where(conModels).ToList();

继续看一下WhereIF,WhereIF的使用就相对简朴一点:

ISugarQueryable<T> WhereIF(bool isWhere, Expression<Func<T, bool>> expression);

示例代码:

var query = context.Client.Queryable<Person>().WhereIF(string.IsNullOrEmpty(input), p=>p.Age>10);

明白起来也很容易,第一个参数若何效果为False,则不执行后续的查询,否则就执行。

2. 一些高级玩法

除了增删改查,SqlSugar还提供了一些其余有意思的机制,继续我们的探索吧。

2.1 批量操作

SqlSugar提供了一种一次性纪录许多操作然后统一提交执行的模式,之前的操作都是仅支持批量插入、批量修改、批量删除。在这种模式下,SqlSugar还支持了批量(插入、修改、删除)。也就是说,在一个批处理中,即可以插入也可以修改还可以删除。

那么我们来看若何让这个功能为我们所用吧:

void AddQueue();

在IDeleteable、IInsertable、IUpdateable、ISugarQueryable都有这个方式,一旦挪用这个方式就示意该条指令举行缓存不立刻执行,直到挪用SqlSugarClient.SaveQueues()。通过挪用SaveQueues()保存到数据库中。

值得注重的是:

SqlSugar 虽然支持将查询也加入到批量操作的支持中,然则这部分在我看来更像是为了保证接口一致化而作的。小我私家并不推荐在批处理中加入查询,由于查询更多的需要实时准确快速,若是一旦陷入批处理中,查询就无法准确快速的返回数据了。

这样对于设定批处理的初衷,反而是违反的。固然最主要的一点,现实开发中这种情形很少遇到。

2.2 事务

SQL自己支持事务,大多数ORM都支持事务,SqlSugar也不破例。SqlSugar通过哪些方式来自己实现一个事务呢?

在SqlSugarClient中执行:

public void BeginTran();

会将SqlSugarClient做一个事务符号,示意之后的操作都是在事务中,直到事务提交或者回滚。

在SimpleClient中执行:

public ITenant AsTenant();

返回一个ITenant实例,然后通过这个实例提交事务或者回滚事务。

注重,SqlSugar所有的事务都是针对 SqlSugarClient级其余,也就是说一个事务,一个SqlSugarClient。

2.3 原生SQL执行

SqlSugar在许多地方都添加了原生Sql的支持。

比如说通过如下这种方式,可以使用Sql语句举行查询:

var t12 = context.Client.SqlQueryable<Student>("select * from student").Where(it=>it.id>0).ToPageList(1, 2);

通过以下这种方式,执行SQL:

context.Client.Ado.ExecuteCommand(sql, parameters)

然后,通过以下方式执行存储历程:

context.Client.Ado.UseStoredProcedure()

3. 总结

优异的ORM总是有林林总总的方案,也有林林总总的优点。SqlSugar到目前为止,可以告一段落了。固然,我照样剩下了一部分,留给大伙自己去探索挖掘。接下来,我将以Dapper作为《C# 数据操作系列》的最后内容。之后将会以项目的形式,率领人人去领会并学习asp.net core。

更多内容烦请关注我的博客《高先生小屋》

C# 数据操作系列 - 16 SqlSugar 完结篇

原创文章,作者:admin,如若转载,请注明出处:https://www.2lxm.com/archives/11975.html