新增拓展方法，使用表达式树实现动态构建Lambda · Pull Request !434 · dotNET China/Furion

### 相关的 Issue
无

### 原因（目的、解决的问题等）
目的：减少IQueryable根据不确定个条件进行筛选的代码量
解决问题：根据前端提供的不确定个条件进行筛选的时候，后端要写判断与Where表达式筛选数据。当允许前端筛选的字段变多时，代码会出现大片`if`和`Where`(或者是`WhereIf`)，这种代码逻辑一样，重复率高。意在减少这类不美观的代码。

### 描述（做了什么，变更了什么）

- 对 `IQueryable` 拓展了 `BuildLambda`，动态构建表达式（结果格式：`t=>t.Name.Contains(input.Name) && t.Age>=18`

- 对 `IEnumerable` 拓展了 `BuildWhere`，原因是只有上方拓展时，`IEnumerable` 集合使用的话需要像下方这样调用

``` csharp
  // 拓展前
  public async Task<Student> GetListAsync(GetListParameter input)
  {
     var query = _repository.AsQueryable();
     if(!string.IsNullOrWhiteSpace(input.Name))
        query = query.Where(t=>t.Name.Contains(input.Name));
     if(input.Age.HasValue)
        query = query.Where(t=>t.Age == input.Age);
     // ...
     // 省略
     // ...;
     return await query.ToListAsync();
  }
  ```

``` csharp
  // 拓展 IQueryable 后
  public async Task<Student> GetListAsync(GetListParameter input)
  {
      return await _repository.BuildWhere(input).ToListAsync();// 手撸，不确定有没有ToListAsync 
  }
  ```

``` csharp
  // 集合使用：
  
  IEnumerable students = new List<Student>(){.....};
  var queryParam = new StudentQueryParam{Name="王", Code=null, Age=null, Gender=GenderEnum.Male,};
  
  // 未拓展 BuildWhere
  var query = students.AsQueryable();
  var result = query.Where(query.BuildLambda(input));
  
  // 拓展 BuildWhere 后
  var result = students.BuildWhere(input);
  ```

### 测试用例（新增、改动、可能影响的功能）

- 改动：仅拓展新名字的方法，与原有功能无关

- 影响：无影响（已检查代码，不存在同名方法）

- 测试用例预览（2/7）：

``` csharp
  /// <summary>
  /// 测试：数值等于
  /// </summary>
  [Fact]
  public void TestValueEqual()
  {
      // 最简单写法，后面的测试都打印表达式，稍微长点
      var input = new StudentListQueryParameter { Age = 18 };
      var result = students.BuildWhere(input);
  
      Output.WriteLine("最简单写法，其他的测试都打印表达式，代码多了两行");
      Output.WriteLine("数值相等");
      Output.WriteLine("结果：" + JsonConvert.SerializeObject(result));
  }
  /**
   Furion.UnitTests.BuildWhereExtenstionTest.TestValueEqual
     源: BuildWhereExtensionTest.cs 行 63
     持续时间: 16 毫秒
  
    标准输出: 
      最简单写法，其他的测试都打印表达式，代码多了两行
      数值相等
      结果：[{"Name":"李四","Age":18,"Code":"A002"},{"Name":"张四","Age":18,"Code":"B001"},{"Name":"李六","Age":18,"Code":"C002"}]
  */
  ```

``` csharp
  /// <summary>
  /// 测试：多个条件
  /// </summary>
  [Fact]
  public void TestMultiFilter()
  {
      var input = new StudentListQueryParameter { Name = "张", AgeLargerEqualThen=18 };
  
      var query = students.AsQueryable();
      var lambda = query.BuildLambda(input);
      var result = query.Where(lambda);
  
      Output.WriteLine("表达式：" + lambda);
      Output.WriteLine("结果：" + JsonConvert.SerializeObject(result));
  }
  /**
   Furion.UnitTests.BuildWhereExtenstionTest.TestMultiFilter
     源: BuildWhereExtensionTest.cs 行 143
     持续时间: 16 毫秒
  
    标准输出: 
      表达式：t => (((True AndAlso True) AndAlso t.Name.Contains("张", CurrentCulture)) AndAlso (t.Age >= Convert(18, Nullable`1)))
      结果：[{"Name":"张三","Age":25,"Code":"A001"},{"Name":"张四","Age":18,"Code":"B001"},{"Name":"张五","Age":22,"Code":"C001"}]
  */
  ```

- 实体与参数类

``` csharp
  /// <summary>
  /// 实体类
  /// </summary>
  public class Student
  {
      public string Name { get; set; }
      public string Code { get; set; }
      public int? Age { get; set; }
  }
  
  /// <summary>
  /// 请求参数类
  /// </summary>
  public class StudentListQueryParameter
  {
      // 参数属性名与集合实体类型属性名不一致时，通过特性参数指定
  
      [WhereLike]
      public string Name { get; set; }
  
      [WhereLike("Code")]
      public string CodeLike { get; set; }
  
      [WhereEqual]
      public string Code { get; set; }
  
      //不提供参数时，与属性一致
      [WhereEqual("Age")]
      public int? Age { get; set; }
  
      [WhereLarger("Age")]
      public int? AgeLargerThen { get; set; }
  
      [WhereLargerEqual("Age")]
      public int? AgeLargerEqualThen { get; set; }
  }
  ```

类型	指派人员	状态
审查	百小僧	进行中 (0/1人)
测试	百小僧	进行中 (0/1人)

GVPdotNET China/Furion

搜索帮助

GVP dotNET China/Furion