Sy.ExpressionBuilder 1.0.0.3

Sy.ExpressionBuilder 使用指南

概述

Sy.ExpressionBuilder 通过模型继承提供灵活查询和分页功能。本指南涵盖模型继承、属性约束、特性使用、排序、分组、分页等功能。

1. 模型继承

注意：FullQueryModel 和 FullPageModel 权限较大，需谨慎使用

2. 属性名约束

3. 特性约束

通过 ConditionAttribute 定义灵活查询条件：

特性参数

• PropertyName: 属性名
• Condition: 查询方法（Equal/Contains等）
• ConditionType: 查询类型（And/Or）
• IsSinglePropertyName: 是否唯一属性名
• IsCaseSensitive: 是否区分大小写

使用示例

// 导航父类查询
[Condition($"{nameof(NewType)}.{nameof(NewType.Name)}")]
public string Name { get; set; }

// 导航子类查询
[Condition($"{nameof(NewType)}[{nameof(NewType.Name)}]")]
public string Name { get; set; }

// 自定义条件
[Condition("Role.RoleName", EnumCondition.Equal, EnumConditionType.And)]
public string Name { get; set; }

4. 排序处理

主要方法

示例

queryModel.DefaultOrderBy("CreateTime", true);  // 创建时间降序
queryModel.AddOrderBy("Name", false);           // 名称升序

5. 分组查询

使用 GroupAttribute 特性：

[Group(1)]
public string Name { get; set; }

[Group(1, EnumConditionType.Or)]
public string UserName { get; set; }

6. 时间跨度查询

使用 DurationAttribute：

[Duration(3, EnumTimeType.Month)]
public DateTime? CreateTimeStart { get; set; }
public DateTime? CreateTimeEnd { get; set; }

7. 分页配置

8. 参数忽略

使用 NotQueryAttribute：

[NotQuery]
public string IgnoreField { get; set; }

9. 构建表达式

通过 ToExpression<T>() 构建：

var expression = queryModel.ToExpression<MyEntity>();

10. 查询扩展方法

常用方法

// 过滤数据
var result = query.WhereExt(queryModel).ToList(); 

// 分页查询
var pageResult = query.ToPageList(pageModel);

// 动态排序
query.OrderBy("CreateTime", isDesc: true);

总结

• 根据场景选择 QueryModel 或 PageModel
• 优先使用属性名约束简化代码
• 谨慎使用 FullQueryModel/FullPageModel
• 更多用法参考代码注释和示例项目