Sy.ExpressionBuilder 动态查询新体验

noert2024-08-14 10:51

省流模式，看下对比

复制代码 
 //常规查询
                var query = users
                    .WhereIf(m => m.UserName.Contains(input.UserName), !string.IsNullOrEmpty(input.UserName))
                    .WhereIf(m => input.RoleIds.Contains(m.RoleId), input.RoleIds?.Any() ?? false)
                    .WhereIf(m => m.Role.RoleName.Contains(input.RoleName), !string.IsNullOrEmpty(input.RoleName))
                    .WhereIf(m => m.Sys.Any(p => p.SysName.Contains(input.SysName)), !string.IsNullOrEmpty(input.SysName))
                    .WhereIf(m => m.Gender == input.Gender, input.Gender.HasValue)
                    .WhereIf(m => m.CreateTime >= input.CreateTimeStart, input.CreateTimeStart.HasValue)
                    .WhereIf(m => m.CreateTime <= input.CreateTimeEnd, input.CreateTimeEnd.HasValue);
                var list = query
                    .OrderBy(m => m.RoleId).ThenBy(m => m.Tel)
                    .Skip((input.Page - 1) * input.PageSize).Take(input.PageSize)
                    .ToList();
                var total = query.Count();
            } {
                //构造器查询方式1
                var (list, total) =
                    users.ToPageList(input.AddMultipleOrderBy(false, nameof(User.RoleId), nameof(User.Tel)));
                //构造器查询方式2
                var (list2, total2) = users
                    .WhereExt(input) //.Where(input.ToExpression<User>())
                    .OrderBy(false, nameof(User.RoleId), nameof(User.Tel)
                    )
                    .Page(input);
            }

没兴趣?那本博客到此结束。小伙伴可以到别处看看了（吐槽下，博客园的这个发布机制属实是看人脸皮和自信度了，我属于脸皮厚的，敢自己推首页）。

1.该表达式插件通过模型继承获取对应的能力。目前提供的模型有

  1. QueryModel ：基础查询类

  2. PageModel：分页查询参数类（默认每页分页20条）

  3. FullQueryModel：查询模型，对比QueryModel 多了查询集合QueryItems和过滤FilterFields。前端可以在后端给与的基础上，添加查询参数，对于前端来说权限有点大，慎用(建议高级查询的时候用)。

  4. FullPageModel：查询模型，对比PageModel多了查询集合QueryItems和过滤FilterFields。慎用（原因同上）。

2.属性名约束

  1. 编号查询：编号查询最好是以Id结尾，不然如果编号为字符串的话，查询方式会以Contains形式查询。

  2. 时间格式：以 Start,End 结尾 ,生成条件为 >= 和<=。

  3. 数字范围：属性名称 以 Min,Max 结尾 ,生成条件为 >= 和<=。

  4. 字符串查询： 名字需要和表字段一致，生成条件为 Contains

3.特性约束。这部分主要为了弥补属性名的不足。可以使用特性ConditionAttribute。下面给出参数介绍以及使用例子。

  • 属性名：PropertyName

  • 属性值：Value

  • 查询方法：Condition

  • 查询类型：ConditionType（and/or）

  • 是否唯一属性名称：IsSinglePropertyName

  • 是否区分大小写：IsCaseSensitive

使用范例
  1. 导航父类查询：父类类名+英文符号.+父类的属性名。如
复制代码 
  [Condition($"{nameof(NewType)}.{nameof(NewType.Name)}")]
  public string Name { get; set; }
  1. 导航子类查询：子类类名+括号[子类属性名]。如
复制代码 
  [Condition($"{nameof(NewType)}[{nameof(NewType.Name)}]")]
  public string Name { get; set; }
  1. 默认的属性名不符合自己的规则的查询：例如字符串想要正值匹配，可通过特性配置
复制代码 
 [Condition("Role.RoleName", EnumCondition.Equal, EnumConditionType.And)]
  public string Name { get; set; }

4.排序处理

  1. 默认排序方法 DefaultOrderBy(string propName, bool isDesc = true, bool isClearReserved = true)。参数解析：属性名、降序升序、是否清掉之前的排序

  2. 默认排序方法 AddOrderBy(string propName, bool isDesc = true)。参数解析：属性名、降序升序。可添加多个，优先级按照，添加的顺序来。

复制代码 
/// <summary>
    /// 设置默认的排序条件，并清空之前保留的排序条件（如果isClearReserved为true）。
    /// </summary>
    /// <param name="input">当前的QueryModel实例。</param>
    /// <param name="propName">要排序的属性名。</param>
    /// <param name="isDesc">排序方向，true为降序，false为升序。</param>
    /// <param name="isClearReserved">是否清空之前保留的排序条件。</param>
    /// <returns>返回修改后的QueryModel实例。</returns>
    public static QueryModel DefaultOrderBy(this QueryModel input, string propName, bool isDesc, bool isClearReserved)
    {
         // 方法实现
    }
​
    /// <summary>
    /// 向QueryModel中添加一个排序条件。
    /// </summary>
    /// <param name="input">当前的QueryModel实例。</param>
    /// <param name="propName">要排序的属性名。</param>
    /// <param name="isDesc">排序方向，true为降序，false为升序。</param>
    /// <returns>返回修改后的QueryModel实例。</returns>
    public static QueryModel AddOrderBy(this QueryModel input, string propName, bool isDesc)
    {
         // 方法实现
    }
​
    /// <summary>
    /// 向QueryModel中添加两个排序条件。
    /// </summary>
    /// <param name="input">当前的QueryModel实例。</param>
    /// <param name="propName">第一个要排序的属性名。</param>
    /// <param name="isDesc">第一个排序的方向，true为降序，false为升序。</param>
    /// <param name="propName2">第二个要排序的属性名。</param>
    /// <param name="isDesc2">第二个排序的方向，true为降序，false为升序。</param>
    /// <returns>返回修改后的QueryModel实例。</returns>
    public static QueryModel AddOrderBy(this QueryModel input, string propName, bool isDesc, string propName2, bool isDesc2)
    {
          // 方法实现
    }
​
    /// <summary>
    /// 向QueryModel中添加三个排序条件。
    /// </summary>
    /// <param name="input">当前的QueryModel实例。</param>
    /// <param name="propName">第一个要排序的属性名。</param>
    /// <param name="isDesc">第一个排序的方向，true为降序，false为升序。</param>
    /// <param name="propName2">第二个要排序的属性名。</param>
    /// <param name="isDesc2">第二个排序的方向，true为降序，false为升序。</param>
    /// <param name="propName3">第三个要排序的属性名。</param>
    /// <param name="isDesc3">第三个排序的方向，true为降序，false为升序。</param>
    /// <returns>返回修改后的QueryModel实例。</returns>
    public static QueryModel AddOrderBy(this QueryModel input, string propName, bool isDesc, string propName2, bool isDesc2, string propName3, bool isDesc3)
    {
        // 方法实现
    }
    
    /// <summary>
    /// 向QueryModel实例中添加一组排序条件。
    /// </summary>
    /// <param name="input">当前的QueryModel实例。</param>
    /// <param name="orderByItems">包含排序信息的OrderByItem列表。</param>
    /// <returns>返回修改后的QueryModel实例（在空实现中，实际上只是返回传入的实例）。</returns>
    public static QueryModel AddOrderBy(this QueryModel input, List<OrderByItem> orderByItems)
    {
       // 方法实现
    }
​
    /// <summary>
    /// 向QueryModel实例中添加多个排序条件，所有条件使用相同的排序方向。
    /// </summary>
    /// <param name="input">当前的QueryModel实例。</param>
    /// <param name="isDesc">排序方向，true为降序，false为升序。</param>
    /// <param name="propNames">要排序的属性名数组。</param>
    /// <returns>返回修改后的QueryModel实例（在空实现中，实际上只是返回传入的实例）。</returns>
    public static QueryModel AddMultipleOrderBy(this QueryModel input, bool isDesc, params string[] propNames)
    {
         // 方法实现
    }

5.分组查询

  1. 使用特性GroupAttribute。使用分组序号，如Group(1)、如Group(1,EnumConditionType.Or)。
复制代码 
   [Group(1)]
   public string Name { get; set; }
    
   [Group(1, EnumConditionType.Or)]
   public string UserName { get; set; }

6.时间跨度查询约束

  1. 使用特性DurationAttribute。在时间的两个属性之间中的一个打上这个特性即可。如时间跨度三个月的。

    复制代码 
    /// <summary>
/// 创建时间 开始
/// </summary>
[Duration(3, EnumTimeType.Month)]
public DateTime? CreateTimeStart { get; set; }
/// <summary>
/// 创建时间  结束
/// </summary>
public DateTime? CreateTimeEnd { get; set; }

7.分页配置

  1. 没啥好说的：PageIndex 当前页 ，PageSize 显示数。

8.参数忽略

  1. 提供了特性NotQueryAttribute，在对于属性添加即可忽略构建查询。

9.构建表达式

  1. 只要类继承了QueryModel等这四个模型，即可以通过ToExpression<TSource>()，构建对于自己模型的表达式。

10.查询扩展

  1. 常规扩展,根据传入的4大模型过滤。例如
复制代码 
 /// <summary>
    /// 查询扩展
    /// </summary>
    public static IQueryable<T> WhereExt<T>(this IQueryable<T> source, QueryModel input)
    {
        // 
    }
    /// <summary>
    /// 查询扩展，并排序
    /// </summary>
    public static IQueryable<T> WhereExt<T>(this IQueryable<T> source, Expression<Func<T,       bool>> expression, params OrderByItem[] orderByItems)
    {
      // 
    }
  1. 部分查询扩展，可返回传入的模型类（如果属性匹配得上的话）
复制代码 
        /// <summary>
        /// Select扩展方法
        /// </summary>
        /// <typeparam name="TSource"></typeparam>
        /// <typeparam name="TTarget"></typeparam>
        /// <param name="query"></param>
        /// <returns></returns>
        public static IQueryable<TTarget> Select<TSource, TTarget>(this IQueryable<TSource> query)
        {
             
        }
  1. IQueryable扩展方法
复制代码 
/// <summary>
/// 根据QueryModel中的条件过滤IQueryable<T>并返回结果列表。 
/// </summary>
/// <param name="source">待处理的IQueryable<T>。</param>
/// <param name="input">包含过滤条件的QueryModel。</param>
/// <returns>未经过滤的T类型列表。</returns>
public static List<T> ToList<T>(this IQueryable<T> source, QueryModel input)
{
    // 实现
}

/// <summary>
/// 根据FullQueryModel中的复杂条件过滤IQueryable<T>并返回结果列表。 
/// </summary>
/// <param name="source">待处理的IQueryable<T>。</param>
/// <param name="input">包含复杂过滤条件的FullQueryModel。</param>
/// <returns>未经过滤的T类型列表。</returns>
public static List<T> ToList<T>(this IQueryable<T> source, FullQueryModel input)
{
    // 实现
}

/// <summary>
/// 根据PageModel中的分页参数对IQueryable<T>进行分页处理，并返回包含数据列表和总记录数的元组。
/// </summary>
/// <param name="query">待分页处理的IQueryable<T>。</param>
/// <param name="input">包含分页参数的PageModel。</param>
/// <returns>包含未分页数据列表和未计算总记录数的元组。</returns>
public static (List<T> list, int total) ToPageList<T>(this IQueryable<T> query, PageModel input)
{
    // 实现
}

/// <summary>
/// 根据FullPageModel中的分页和过滤条件对IQueryable<T>进行处理，并返回包含数据列表和总记录数的元组
/// </summary>
/// <param name="query">待处理的IQueryable<T>。</param>
/// <param name="input">包含分页和过滤条件的FullPageModel。</param>
/// <returns>包含未分页且未过滤的数据列表和未计算总记录数的元组。</returns>
public static (List<T> list, int total) ToPageList<T>(this IQueryable<T> query, FullPageModel input)
{
    // 实现
}

/// <summary>
/// 对IQueryable<T>进行分页处理，并返回包含数据列表和总记录数的元组。
/// </summary>
/// <param name="query">待分页处理的IQueryable<T>。</param>
/// <param name="input">包含分页参数的PageModel。</param>
/// <returns>包含未分页数据列表和未计算总记录数的元组。</returns>
public static (List<T> list, int total) Page<T>(this IQueryable<T> query, PageModel input)
{
    // 实现
}

/// <summary>
/// 根据FullPageModel中的分页和过滤条件对IQueryable<T>进行处理，并返回包含数据列表和总记录数的元组。
/// </summary>
/// <param name="query">待处理的IQueryable<T>。</param>
/// <param name="input">包含分页和过滤条件的FullPageModel。</param>
/// <returns>包含未分页且未过滤的数据列表和未计算总记录数的元组。</returns>
public static (List<T> list, int total) Page<T>(this IQueryable<T> query, FullPageModel input)
{
    // 实现
}
/// <summary>
/// 根据PageModel中的分页和排序参数对IQueryable<T>进行分页和排序处理，并返回包含排序后数据列表和总记录数的元组。
/// </summary>
/// <param name="query">待分页和排序处理的IQueryable<T>。</param>
/// <param name="input">包含分页和排序参数的PageModel。</param>
/// <returns>包含未分页且未排序的数据列表和未计算总记录数的元组。</returns>
public static (List<T> list, int total) OrderPageList<T>(this IQueryable<T> query, PageModel input)
{
    // 实现
}

/// <summary>
/// 根据FullPageModel中的分页、排序和过滤条件对IQueryable<T>进行处理，并返回包含排序后数据列表和总记录数的元组。
/// </summary>
/// <param name="query">待处理的IQueryable<T>。</param>
/// <param name="input">包含分页、排序和过滤条件的FullPageModel。</param>
/// <returns>包含未分页、未排序且未过滤的数据列表和未计算总记录数的元组。</returns>
public static (List<T> list, int total) OrderPageList<T>(this IQueryable<T> query, FullPageModel input)
{
    // 实现
}
  1. IQueryable扩展方法之排序
复制代码 
/// <summary>
/// 根据单个属性名对IQueryable<TEntity>进行排序。
/// </summary>
/// <param name="input">待排序的IQueryable<TEntity>。</param>
/// <param name="propName">要排序的属性名。</param>
/// <param name="isDesc">指示排序是否为降序。</param>
/// <returns>未应用排序的IQueryable<TEntity>。</returns>
public static IQueryable<TEntity> OrderBy<TEntity>(this IQueryable<TEntity> input, string propName, bool isDesc)
{
  // 实现
}

/// <summary>
/// 根据两个属性名对IQueryable<TEntity>进行排序。
/// </summary>
/// <param name="input">待排序的IQueryable<TEntity>。</param>
/// <param name="propName">第一个要排序的属性名。</param>
/// <param name="isDesc">第一个排序是否为降序。</param>
/// <param name="propName2">第二个要排序的属性名。</param>
/// <param name="isDesc2">第二个排序是否为降序。</param>
/// <returns>未应用排序的IQueryable<TEntity>。</returns>
public static IQueryable<TEntity> OrderBy<TEntity>(this IQueryable<TEntity> input, string propName, bool isDesc, string propName2, bool isDesc2)
{
  // 实现
}

/// <summary>
/// 根据三个属性名对IQueryable<TEntity>进行排序。
/// </summary>
/// <param name="input">待排序的IQueryable<TEntity>。</param>
/// <param name="propName">第一个要排序的属性名。</param>
/// <param name="isDesc">第一个排序是否为降序。</param>
/// <param name="propName2">第二个要排序的属性名。</param>
/// <param name="isDesc2">第二个排序是否为降序。</param>
/// <param name="propName3">第三个要排序的属性名。</param>
/// <param name="isDesc3">第三个排序是否为降序。</param>
/// <returns>未应用排序的IQueryable<TEntity>。</returns>
public static IQueryable<TEntity> OrderBy<TEntity>(this IQueryable<TEntity> input, string propName, bool isDesc, string propName2, bool isDesc2, string propName3, bool isDesc3)
{
  // 实现
}

/// <summary>
/// 根据多个属性名对IQueryable<TEntity>进行排序。属性名和排序方向通过数组提供。
/// </summary>
/// <param name="input">待排序的IQueryable<TEntity>。</param>
/// <param name="isDesc">是否所有排序都应为降序，此参数在可变参数场景下可能不被直接使用，而是作为方法重载的标识。</param>
/// <param name="propNames">要排序的属性名数组。</param>
/// <returns>未应用排序的IQueryable<TEntity>。</returns>
public static IQueryable<TEntity> OrderBy<TEntity>(this IQueryable<TEntity> input, bool isDesc, params string[] propNames)
{
  // 实现
}

/// <summary>
/// 根据IQueryModel中的排序信息对IQueryable<TEntity>进行排序。
/// </summary>
/// <param name="input">待排序的IQueryable<TEntity>。</param>
/// <param name="queryModel">包含排序信息的IQueryModel。</param>
/// <returns>未应用排序的IQueryable<TEntity>。</returns>
public static IQueryable<TEntity> OrderBy<TEntity>(this IQueryable<TEntity> input, IQueryModel queryModel)
{
   // 实现
}

/// <summary>
/// 根据OrderByItem数组中的排序项对IQueryable<TEntity>进行排序。
/// </summary>
/// <param name="input">待排序的IQueryable<TEntity>。</param>
/// <param name="orderByItems">包含排序属性和排序方向的OrderByItem数组。</param>
/// <returns>未应用排序的IQueryable<TEntity>。</returns>
public static IQueryable<TEntity> OrderBy<TEntity>(this IQueryable<TEntity> input, params OrderByItem[] orderByItems)
{
   // 实现
}

/// <summary>
/// 根据OrderByItem列表中的排序项对IQueryable<TEntity>进行排序。
/// </summary>
/// <param name="input">待排序的IQueryable<TEntity>。</param>
/// <param name="orderByItems">包含排序属性和排序方向的OrderByItem列表。</param>
/// <returns>未应用排序的IQueryable<TEntity>。</returns>
public static IQueryable<TEntity> OrderBy<TEntity>(this IQueryable<TEntity> input, List<OrderByItem> orderByItems)
{
   // 实现
}
热门推荐
01Cube-Studio：开源大模型全链路一站式中台02ARM学习（31）编译器对overlay方式的支持03玄机平台应急响应—webshell查杀04Ubuntu 20.04使用Livox mid 360 测试 FAST_LIO05校验 GPT-4 真实性的三个经典问题：快速区分 GPT-3.5 与 GPT-4，并提供免费测试网站06Docker 夺命连环 15 问07构建高效的广告投放系统：应用架构的设计与实现08基于大语言模型（LLM）的合成数据生成、策展和评估的综述09(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明10【一文读懂】NTN（非地面网络）技术介绍