[C#]利用 DynamicLinq 實現簡單的動態表達式構建查詢

平時使用 LINQ 進行一些簡單的條件拼接查詢一般都會這樣操作：

public class SearchInputDto
{
    public string ConditionA { get; set; }
    public int? ConditionB { get; set; }
    public string ConditionC { get; set; }
}

這裡有三個條件，是前端傳入的搜索條件，然後我們來編寫一個查詢語句：

public Task Search(SearchInputDto input)
{
    var queryResult = _db.Where(z=>(input.ConditionA == null || z.Name == input.ConditionA) 
                                && (input.ConditionB == null || z.Number == input.ConditionB)
                                && (input.ConditionC == null || z.Address == input.ConditionC));
    
    // 執行其他操作...
    
    return Task.FromResult(0);
}

因為我們前端傳入的條件不是固定的，所以有可能會出現有的條件沒有傳入的情況，如果是 SQL 的動態拼接 SQL 就可以了，而 Linq 你肯定是沒法動態拼接的，只有自己構建一個表達式樹傳入到 IQuerable<T>.Where(Expression<Func<T,bool>> expression) 裡面進行查詢。

純手工構建表達式樹也不是不可以，只是略微麻煩，而我們則可以藉助 System.Linq.Dynamic.Core 來方便的實現動態查詢語句拼接。

他的常規用法如下：

官方 WIKI 地址：https://github.com/StefH/System.Linq.Dynamic.Core/wiki/Dynamic-Expressions

var query = db.Customers
              .Where("City == @0 and Orders.Count >= @1", "London", 10)
              .OrderBy("CompanyName")
              .Select("new(CompanyName as Name, Phone)");

既然是字元串那麼就可以拼接，我們來做一下改造。

首先去 NuGet 當中搜索 System.Linq.Dynamic.Core 庫，安裝之後我們來重新編寫之前的查詢範例，首先我們來寫一個構建器，用於構建我們的表達式樹：

using Abp.Runtime.Caching;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Linq.Dynamic.Core;
using System.Linq.Expressions;
using System.Reflection;
using System.Text;

namespace Abp.Linq.Expressions
{
    public class ExpressionBuilder<TEntity, TSearchDto>
    {
        // 其實這裡也可以通過傳入 params Expression<Func<TRelateEntity, object>>[] selectFields 來構建
        public Expression<Func<TEntity, bool>> Build(string[] excludeFields, TSearchDto dto)
        {
            var parameters = GenerateParametersDictionary(excludeFields, dto);

            StringBuilder sb = new StringBuilder();
            var fieldNames = parameters.Keys.ToList();

            // 動態拼接
            for (int i = 0; i < fieldNames.Count; i++)
            {
                sb.Append(fieldNames[i]).Append($" == @{i}").Append(" && ");
            }

            var lambdaStr = sb.ToString();
            lambdaStr = lambdaStr.Substring(0, lambdaStr.Length - " && ".Length);

            // 構建表達式
            return DynamicExpressionParser.ParseLambda<TEntity, bool>(new ParsingConfig(), false, lambdaStr, parameters.Values.ToArray());
        }

        // 構建參數/值鍵值對，如果參數值為 NULL 則不進行構建
        private Dictionary<string, object> GenerateParametersDictionary(string[] excludeFields, TSearchDto dto)
        {
            var typeInfo = typeof(TSearchDto);
            var properties = typeInfo.GetProperties();
            var parameters = new Dictionary<string, object>();

            foreach (var property in properties)
            {
                var propertyValue = property.GetValue(dto);

                if (propertyValue == null) continue;
                if (excludeFields == null) continue;
                if (excludeFields.Contains(property.Name)) continue;
                if (parameters.ContainsKey(property.Name)) continue;

                parameters.Add(property.Name, propertyValue);
            }

            return parameters;
        }
    }
}

用法很簡單，用剛纔的代碼作為一個例子：

public Task Search(SearchInputDto input)
{
    var builder = new ExpressionBuilder<EntityA,SearchInputDto>();
    var queryResult = _db.Where(builder.Build(null,input));
    
    // 執行其他操作...
    
    return Task.FromResult(0);
}

可以看到已經變得十分簡潔，這裡僅僅作為拋磚引玉，其實還有更多高級的用法，這裡不再贅述。