Sy.ExpressionBuilder 使用说明

已于 2024-06-12 17:36:38 修改
阅读量867 收藏 18
点赞数 26
文章标签： 状态模式
于 2024-06-12 17:24:31 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/noert/article/details/139632407
版权

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

  1. QueryBase ：基础查询类

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

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

  4. QueryPageModel：查询模型，对比PageModel多了查询集合QueryItems和过滤FilterFields。前端可以在后端给与的基础上，添加查询参数，对于前端来说权限有点大，慎用。

2.属性名约束

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

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

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

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

3.特性约束。这部分主要为了弥补属性名的不足。目前提供特性的构造函数以及特性属性如下

/// <summary>
/// 字段属性
/// </summary>
/// <param name="condition">查询方法</param>
/// <param name="conditionType">查询类型</param>
/// <param name="value">属性值</param>
public ConditionAttribute(EnumCondition condition = EnumCondition.Equal, EnumConditionType conditionType = EnumConditionType.And, object value = null)
{
    Condition = condition;
    ConditionType = conditionType;
    Value = value;
}
​
/// <summary>
/// 字段属性
/// </summary>
/// <param name="propertyName">PropertyName</param>
/// <param name="condition">查询方法</param>
/// <param name="conditionType">查询类型</param>
/// <param name="value">属性值</param>
public ConditionAttribute(string propertyName, EnumCondition condition = EnumCondition.Equal, EnumConditionType conditionType = EnumConditionType.And, object value = null)
{
    Condition = condition;
    ConditionType = conditionType;
    PropertyName = propertyName;
    Value = value;
}

  • 属性名：PropertyName

  • 属性值：Value

  • 查询方法：Condition

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

  • 是否唯一属性名称：IsSinglePropertyName

  • 是否区分大小写：IsCaseSensitive

4.排序处理

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

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

5.分页配置

  1. 重置当前页：Page(this PageModel model, object page)

  2. 重置当前每页显示：PageSize(this PageModel model, object pageSize)

  3. 重置每页配置： public static PageModel Paging<Input>(this PageModel model, Input input) where Input : class, IPageModel

    IPageModel对应代码

/// <summary>
/// 分页相关
/// </summary>
public interface IPageModel
{
    /// <summary>
    /// 当前页
    /// </summary>
    [NotQuery]
    int Page { get; set; }  
    /// <summary>
    /// 页码
    /// </summary>
    [NotQuery]
    int PageSize { get; set; } 
}

6.参数忽略

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

7.构建表达式

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

8.查询扩展之返回IQueryable数据，插件基于IQueryable类型数据提供了扩展方法 如下

  1. QueryBase、QueryModel、PageModel、QueryPageModel 类作为参数方法如下

 /// <summary>
/// 获取条件下数据
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="source"></param>
/// <param name="input"></param>
/// <returns></returns>
public static IQueryable<T> WhereExt<T>(this IQueryable<T> source, QueryBase input)
{}
​
/// <summary>
/// 获取条件下列表
/// </summary>
/// <param name="input"></param>
/// <param name="total"></param>
/// <returns></returns>
public static (IQueryable<T> query, int total) PageWhere<T>(this IQueryable<T> source, QueryBase input)
​
 /// <summary>
 /// 获取条件下列表
 /// </summary>
 /// <param name="input"></param>
 /// <param name="total"></param>
 /// <returns></returns>
 public static IQueryable<T> WhereExt<T>(this IQueryable<T> source, QueryBase input, out int total)

  1. 表达式树作为参数扩展查询

  /// <summary>
 /// 通过表达式树查询扩展
 /// </summary>
 /// <typeparam name="T">数据源的元素类型</typeparam>
 /// <param name="source">待筛选和排序的数据源</param>
 /// <param name="expression">查询表达式</param>
 /// <param name="total">总页数</param>
 /// <returns></returns>
 public static IQueryable<T> WhereExt<T>(this IQueryable<T> source, Expression<Func<T, bool>> expression, out int total)
  
/// <summary>
/// 查询扩展
/// </summary>
/// <typeparam name="T">数据源的元素类型</typeparam>
/// <typeparam name="TKey">排序参数</typeparam>
/// <param name="source">待筛选和排序的数据源</param>
/// <param name="expression">查询表达式</param>
/// <param name="orderBy">排序表达式</param>
/// <returns></returns>
public static IQueryable<T> WhereExt<T, TKey>(this IQueryable<T> source, Expression<Func<T, bool>> expression, Expression<Func<T, TKey>> orderBy)
​
 /// <summary>
/// 查询扩展
/// </summary>
/// <typeparam name="T">数据源的元素类型</typeparam>
/// <typeparam name="TKey">排序参数</typeparam>
/// <param name="source">待筛选和排序的数据源</param>
/// <param name="expression">查询表达式</param>
/// <param name="orderBy">排序表达式</param>
/// <param name="IsOrderByDesc">是否降序</param>
/// <returns></returns>
public static IQueryable<T> WhereExt<T, TKey>(this IQueryable<T> source, Expression<Func<T, bool>> expression, Expression<Func<T, TKey>> orderBy, bool IsOrderByDesc = true)
  
 /// <summary>
 /// 查询扩展
 /// </summary>
 /// <typeparam name="T">数据源的元素类型</typeparam>
 /// <param name="source">数据源</param>
 /// <param name="expression">表达式树</param>
 /// <param name="orderByItems">排序集合</param>
 /// <returns></returns>
 public static IQueryable<T> WhereExt<T>(this IQueryable<T> source, Expression<Func<T, bool>> expression, params OrderByItem[] orderByItems)
​
/// <summary>
/// 查询扩展
/// </summary>
/// <typeparam name="T">数据源的元素类型</typeparam>
/// <param name="source">数据源</param>
/// <param name="expression">表达式树</param>
/// <param name="total">总页数</param>
/// <param name="orderByItems">排序集合</param>
/// <returns></returns>
public static IQueryable<T> WhereExt<T>(this IQueryable<T> source, Expression<Func<T, bool>> expression, out int total, params OrderByItem[] orderByItems)
 
/// <summary>
/// 查询扩展
/// </summary>
/// <typeparam name="T">数据源的元素类型</typeparam>
/// <param name="source">数据源</param>
/// <param name="expression">表达式树</param>
/// <param name="total">总页数</param>
/// <param name="page">当前页</param>
/// <param name="pageSize">每页显示</param>
/// <param name="orderByItems">排序集合</param>
/// <returns></returns>
public static IQueryable<T> WhereExt<T>(this IQueryable<T> source, Expression<Func<T, bool>> expression, out int total, int page, int pageSize, params OrderByItem[] orderByItems)

  1. 排序。QueryBase、QueryModel、PageModel、QueryPageModel4 都提供了扩展方法，参考代码如：

/// <summary>
/// 排序
/// </summary>
/// <typeparam name="T">数据源的元素类型</typeparam>
/// <param name="query">资源</param>
/// <param name="input">查询模型</param>
/// <returns></returns>
 public static IQueryable<T> OrderBy<T>(this IQueryable<T> query, QueryBase input)

  1. 分页。PageModel、QueryPageModel 提供了分页扩展方法，参考代码如：

/// <summary>
/// 获取条件下列表
/// </summary>
/// <param name="input"></param>
/// <param name="total"></param>
/// <returns></returns>
public static IQueryable<T> Page<T>(this IQueryable<T> query, PageModel input)
​
/// <summary>
/// 分页
/// </summary>
/// <param name="input"></param>
/// <param name="total"></param>
/// <returns></returns>
public static IQueryable<T> Page<T>(this IQueryable<T> query, QueryPageModel input)

  1. 分页且排序。PageModel、QueryPageModel4个模型也提供了扩展方法，参考代码如：

/// <summary>
/// 获取条件下列表
/// </summary>
/// <param name="input"></param>
/// <param name="total"></param>
/// <returns></returns>
public static IQueryable<T> OrderByPage<T>(this IQueryable<T> query, PageModel input)
​
/// <summary>
/// 获取条件下列表
/// </summary>
/// <param name="input"></param>
/// <param name="total"></param>
/// <returns></returns>
public static IQueryable<T> OrderByPage<T>(this IQueryable<T> query, QueryPageModel input)

9.查询扩展之返回List数据(需要引入Sy.ExpressionBuilder.Sql组件)，插件基于IQueryable类型数据提供了扩展方法 如下

  1. ToList()方法扩展。对应模型 QueryBase，QueryModel。扩展方法如下

    /// <summary>
 /// 获取条件下列表
 /// </summary>
 /// <param name="queryModel"></param>
 /// <param name="total"></param>
 /// <returns></returns>
 public static List<T> ToList<T>(this IQueryable<T> source, QueryBase input)
 
 /// <summary>
/// 获取条件下列表
/// </summary>
/// <param name="input"></param>
/// <param name="total"></param>
/// <returns></returns>
public static List<T> ToList<T>(this IQueryable<T> source, QueryModel input)

    1. PageToList()方法扩展。对应模型 QueryPageModel，PageModel。扩展方法如下

    /// <summary>
/// 获取条件下列表
/// </summary>
/// <param name="input"></param>
/// <param name="total"></param>
/// <returns></returns>
public static (List<T> list, int total) PageToList<T>(this IQueryable<T> source, QueryPageModel input)
​
 /// <summary>
 /// 获取条件下列表
 /// </summary>
 /// <param name="queryModel"></param>
 /// <param name="total"></param>
 /// <returns></returns>
 public static (List<T> list, int total) PageToList<T>(this IQueryable<T> source, PageModel input)

    10.举个例子

    1. 构建用户基础数据，给个代码

       [TestMethod()]
​
 public void ToExpressionTest()
 {
     var userlist = new List<User>();
     var sysList = new List<Sys>();
     var sysList2 = new List<Sys>();
     sysList.Add(new Sys { Id = "1", SysName = "仓管系统" });
     sysList.Add(new Sys { Id = "2", SysName = "人力资源系统" });
     sysList2.Add(new Sys { Id = "1", SysName = "仓管系统" });
​
     var user1 = new User { Id = "1", UserName = "张三", Tel = "18888888888", Gender = EnumGender.Man, RoleId = 1, CreateTime = DateTime.Parse("2021-9-22 10:50:50"), Sys = sysList, Role = new Role { RoleName = "超级管理员", Id = 1 } };
     var user2 = new User { Id = "2", UserName = "李四", Tel = "16666666666", Gender = (EnumGender)3, RoleId = 2, CreateTime = DateTime.Parse("2021-9-21 10:50:50"), Sys = sysList2, Role = new Role { RoleName = "管理员", Id = 2 } };
​
     userlist.Add(user1);
     userlist.Add(user2);
​
     Expression<Func<User, bool>> query;
     AllUserDto input = new AllUserDto();
     input.RoleIds = new List<long>() { 1, 2 };
     input.UserName = "1".ToLower();
     input.SysName = "仓管系统";
     input.RoleName = "管理员";
     input.CreateTimeStart = DateTime.Parse("2021-9-22");
     input.CreateTimeEnd = DateTime.Parse("2021-9-25");
     input.Gender = EnumGender.Man;
     input.IsMan = (EnumGender)2;
     query = input.ToExpression<User>();
​
​
     var result = userlist.Where(query.Compile()).ToList();
    // BenchmarkRunner.Run<TestExpress>();
​
 }

    2. 给个效果图吧

    1. 声明基础表。用户表、角色表、系统表、以及性别枚举

    /// <summary>
/// 用户表
/// </summary>
public class User
{
    /// <summary>
    /// 编号
    /// </summary>
    [Key]
    public string Id { get; set; }
    
    /// <summary>
    /// 名称
    /// </summary>
    [DependenceProp(PropName = "UserName123213", Ext1 = "名称")]
    public string UserName { get; set; }
​
    /// <summary>
    /// 手机
    /// </summary>
    public string Tel { get; set; }
​
    /// <summary>
    /// 角色编号
    /// </summary>
    [ForeignKey("RoleId")]
    public long RoleId { get; set; }
​
    /// <summary>
    /// 角色
    /// </summary>
    public Role Role { get; set; }
​
    /// <summary>
    /// 系统
    /// </summary>
    public List<Sys> Sys { get; set; }
​
    /// <summary>
    /// 创建时间
    /// </summary>
    public DateTime CreateTime { get; set; }
​
    /// <summary>
    /// 性别
    /// </summary>
    public EnumGender Gender { get; set; }
}
​
/// <summary>
/// 角色表
/// </summary>
public class Role
{
    /// <summary>
    /// 角色名
    /// </summary>
    [DisplayName("角色名")]
    public string? RoleName { get; set; }
​
    /// <summary>
    /// 角色编号
    /// </summary>
    [DisplayName("角色编号")]
    [Key]
    public long Id { get; set; }
​
​
}
​
 /// <summary>
 /// 系统表
 /// </summary>
 public class Sys
 {
     /// <summary>
     /// 系统名称
     /// </summary>
     [Key]
     public string SysName { get; set; }
​
     /// <summary>
     /// 编号
     /// </summary>
     public string Id { get; set; }
 }
 
  /// <summary>
 /// 性别
 /// </summary>
 [Flags]
 public enum EnumGender
 {
     /// <summary>
     /// 男
     /// </summary>
     [Description("男")]
     Man = 1 << 0,
​
     /// <summary>
     /// 女
     /// </summary>
     [Description("女")]
     Women = 1 << 1,
​
     /// <summary>
     /// 其他
     /// </summary>
     [Description("其他")]
     Other = 1 << 2,
 }

    1. 声明要查询参数表。如表AllUserDto，代码如下

    /// <summary>
/// 查询参数实体
/// </summary>
​
public class AllUserDto : QueryPageModel
{
    /// <summary>
    /// 创建时间 开始
    /// </summary>
    [TimeSpan(4, EnumTimeType.Day)]
    public DateTime? CreateTimeStart { get; set; }
​
    /// <summary>
    /// 创建时间  结束
    /// </summary>
    public DateTime? CreateTimeEnd { get; set; }
​
    /// <summary>
    /// 角色编号
    /// </summary>
    public string? Tel { get; set; }
​
    /// <summary>
    /// 角色编号
    /// </summary>
    [Condition("Role.Id", EnumCondition.In)]
    public List<long> RoleIds { get; set; } = new List<long>();
​
    /// <summary>
    /// 角色名称
    /// </summary>
    [Condition("Role.RoleName", EnumCondition.Contains, EnumConditionType.And)]
    public string? RoleName { get; set; }
​
    /// <summary>
    /// 系统名称
    /// </summary>
    [Condition("Sys[SysName]", EnumCondition.Contains)]
    [Group(1)]
    public string? SysName { get; set; }
​
    /// <summary>
    /// 名称
    /// </summary>
    [Condition(EnumCondition.Contains, EnumConditionType.Or)]
    [Group(1, EnumConditionType.Or)]
    public string? UserName { get; set; }
​
    /// <summary>
    /// 性别
    /// </summary>
    //[Group(0, EnumConditionType.Or)]
    [Condition(conditionType: EnumConditionType.Or, IsSinglePropertyName = false)]
    public EnumGender? Gender { get; set; }
​
    /// <summary>
    /// 男
    /// </summary>
    [Condition("Gender", EnumCondition.HasFlag, conditionType: EnumConditionType.Or, IsSinglePropertyName = false)]
    public EnumGender? IsMan { get; set; }
​
    /// <summary>
    /// 是否是女的
    /// </summary>
    [Condition($"Gender", EnumCondition.NotEqual, value: EnumGender.Women)]
    public bool? IsWomen { get; set; } = true;
​
    /// <summary>
    /// 不参与查询
    /// </summary>
    [NotQuery]
    public string TreeId { get; set; }
​
    /// <summary>
    /// 当前页
    /// </summary>
    [NotQuery]
    public int Page { get; set; } = 1;
​
    /// <summary>
    /// 页码
    /// </summary>
    [NotQuery]
    public int PageSize { get; set; } = 20;
​
}
noert
关注
  • 26
    点赞
  • 踩
  • 18
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
超简单的集成表达式树查询组件，Sy.ExpressionBuilder 使用说明
www_xuhss_com的博客
03-07 284
Python微信订餐小程序课程视频 https://edu.csdn.net/course/detail/36074 Python实战量化交易理财系统 https://edu.csdn.net/course/detail/35475     Sy.ExpressionBuilder是一套依赖于表达式树上的集成的查询组件。设计的初衷没别的，就为了少写代码，让查询业务可以变得更加模式化。可以从nuget 获取到该组件（目前支持 .net5 和.net6 版本）。 来到查询，查询实体需要继承&
ASP.NET.4揭秘 卷2
06-08
n62 创建自定义ExpressionBuilder n63 创建HTTP处理程序 n631 创建一般处理程序 n632 实现IHttpHandler接口 n633 创建异步HTTP处理程序 n64 使用HTTP应用程序和HTTP模块 n641 创建Globalasax文件 n642 创建自定义...
ASP.NET自定义表达式构造器
07-25
ExpressionBuilder 表达式 构造器
动态生成表达式树插件 Sy.ExpressionBuilder，向着手写条件说拜拜。
noert的专栏
10-06 286
作为还在CURD中的一员,查询我感觉还是很烦人的一个浪费时间的工作，我经历过远古时代的GetAll(string name,int age),这种方式写服务的时候真的是心中一万个草泥马飞过，后面逐渐的变成了传一个实体GetAll([FromQuery] GetDto)似乎也能默默的忍受，然后含泪写着一堆的WhereIf,目前这种方式应该还是很多人在用的一种方式。然而Sy.ExpressionParser的出现，我们有了更好的选择。 为了方便后面的介绍，先让我们有几个实体，用户表，角色表，系...
三目运算符
weixin_30500473的博客
04-05 68
page.pageNum+1>page.totalPage?page.totalPage:page.pageNum+1 看着没什么问题，但是会出现转换异常 javax.el.ELException: Error Parsing: ${page.pageNum+1>page.totalPage?page.totalPage:page.pageNum+1} org.apache.e...
Z.Expressions.Eval.2.4.2
11-03
Expression expression = new ExpressionBuilder("2 + 3 * 4").build(); double result = expression.evaluate(); System.out.println(result); // 输出：14.0 } } ``` 这个简单的例子展示了如何创建、编译和...
Expression-Builder:为Java和Scheme语言构建二进制，一元，常量和参数表达式
05-24
1. **表达式树（Expression Trees）**：Expression-Builder可能使用表达式树来表示和操作表达式，这是一种数据结构，可以直观地展示表达式的结构。 2. **编译原理**：理解二进制和一元表达式的构建涉及到词法分析、...
ASP.NET 3.5 揭秘(卷2).part2
12-03
　6.2 创建自定义ExpressionBuilder 　6.3 创建HTTP处理程序 　6.4 使用HTTP应用程序和HTTP模块 　6.5 小结 　第7章　配置应用程序 　7.1 网站配置概览 　7.2 使用配置API 　7.3 创建自定义配置节 　7.4 ...
19.JWT
m0_45209551的博客
07-07 443
现在token生成好了，大家要注意，refreshToken方法已经把当前成功登录的人的信息存到了redis中，前缀是login_tokens: + 当前的tokenId，tokenId是一个uuid。可以看到，它会去config.headers看看到底要不要，如果我们在请求头指定了不要，那么发请求就不会带上token，否则就会被带上token。答：没有，所以只能在login页面，凡是想跳转其他界面，都被重定向到登录，硬生生让你登录。然后它又是最后一个话在生成token，好家伙，玩我是吧？
工作日常学习记录
m0_73774439的博客
07-03 628
今天开发上遇到一个搜索的需求，要求可以多选，模糊查询。我首先和前端沟通，前端多选后使用逗号分隔，拼成字符串传输给我，我后端再进行具体的处理。
状态模式（State Pattern）
yuiezt的专栏
07-05 493
也称为状态机模式（State Machine Pattern）通过定义不同的状态类来封装与特定状态相关的行为，并将状态的判断逻辑转移到表示不同状态的一系列类中，从而把复杂的判断逻辑简化。状态模式将状态和行为分开，使对象在内部状态改变时能够改变它的行为。每一个状态对应一个子类，从而将状态的转换逻辑分布到状态子类中，减少了相互依赖。客户端通常不直接与状态对象交互，而是通过环境类（Context）与状态对象进行交互。
2024年公关服务行业分析报告.pptx
07-09
行业报告
惠州市建筑物矢量数据（Shp格式+带高度）.txt
最新发布
07-09
因文件较多，数据存放网盘，txt文件内包含下载链接及提取码，永久有效。失效会第一时间进行补充。
Matlab语言教程及案例
07-09
项目总结 本文详细介绍了Matlab的基础知识和一个完整的数据分析与可视化案例。内容包括： 1. **基本操作**：基本算术运算和矩阵操作。 2. **绘图**：二维和三维绘图。 3. **函数和脚本**：编写和运行Matlab函数和脚本。 4. **案例分析**：生成模拟数据，进行数据预处理、绘图和统计分析。 通过这个项目，读者可以掌握Matlab的基本使用方法，并了解如何在Matlab中进行数据分析和可视化。这对于初学者入门Matlab编程、提升数据处理和分析能力非常有帮助。希望本文能为读者提供有价值的参考，提升其Matlab编程和数据分析技能。
KB8825英文数据手册
07-09
三星KB8825英文数据手册
述职报告（08）PPT模板.pptx
07-09
述职报告（08）PPT模板.pptx
知识产权优势培育企业推荐表.docx
07-09
知识产权优势培育企业推荐表.docx
学校商店超市消防安全工作责任书.docx
07-09
学校商店超市消防安全工作责任书.docx
com.sun.tools.internal.xjc.reader.xmlschema.ExpressionBuilder和net.objecthunter.exp4j.ExpressionBuilder 区别
06-08
com.sun.tools.internal.xjc.reader.xmlschema.ExpressionBuilder是Java API的一部分，用于将XML模式转换为Java类的工具中的一个组件，主要用于构建XPath表达式，以在XML文档中选择元素和属性。而net.objecthunter.exp4j.ExpressionBuilder则是一个用于在Java中构建和计算数学表达式的开源库，它可以将字符串形式的数学表达式转换为可计算的Java对象。两者的主要区别在于用途和功能。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值