如何在C#中实现Specification规约模式来构建可复用的查询逻辑？

在复杂业务系统里，数据查询条件往往穿插在Service层甚至Controller中，时间一长就会出现大量重复的Where判断。C#中的Specification规约模式提倡把“什么样的对象符合条件”封装成一个个独立规约类，再通过组合方式拼装查询，既提升可读性也方便单元测试。

一、定义规约接口与基础实现

最基础的规约只需要表达“给定对象是否满足条件”，但在EF Core场景下我们更关心表达式树。下面定义一个泛型规约接口：

public interface ISpecification<T>
{
    // 返回用于IQueryable的过滤表达式
    System.Linq.Expressions.Expression<System.Func<T, bool>> ToExpression();
}

以订单实体为例，我们可以写出“金额大于某值”的规约：

public class OrderAmountGreaterThanSpec : ISpecification<Order>
{
    private readonly decimal _minAmount;
    public OrderAmountGreaterThanSpec(decimal minAmount)
    {
        _minAmount = minAmount;
    }
    public System.Linq.Expressions.Expression<System.Func<Order, bool>> ToExpression()
    {
        return o => o.Amount > _minAmount;
    }
}

二、使用扩展方法组合规约

单个规约能力有限，真正价值在于And、Or等组合。我们可以在静态类里写扩展：

public static class SpecificationExtensions
{
    public static ISpecification<T> And<T>(this ISpecification<T> left, ISpecification<T> right)
    {
        return new CombinedSpec<T>(left, right, true);
    }
}

public class CombinedSpec<T> : ISpecification<T>
{
    private readonly ISpecification<T> _left;
    private readonly ISpecification<T> _right;
    private readonly bool _isAnd;
    public CombinedSpec(ISpecification<T> left, ISpecification<T> right, bool isAnd)
    {
        _left = left; _right = right; _isAnd = isAnd;
    }
    public System.Linq.Expressions.Expression<System.Func<T, bool>> ToExpression()
    {
        var l = _left.ToExpression();
        var r = _right.ToExpression();
        // 简单演示：实际应使用ExpressionVisitor合并 bodies
        if (_isAnd)
            return System.Linq.Expressions.Expression.Lambda<System.Func<T, bool>>(
                System.Linq.Expressions.Expression.AndAlso(l.Body, r.Body), l.Parameters);
        else
            return System.Linq.Expressions.Expression.Lambda<System.Func<T, bool>>(
                System.Linq.Expressions.Expression.OrElse(l.Body, r.Body), l.Parameters);
    }
}

三、在仓储中应用规约

把规约传给仓储，由仓储统一翻译成查询，可以避免上层直接写LINQ：

public class OrderRepository
{
    private readonly DbContext _db;
    public OrderRepository(DbContext db) { _db = db; }
    public IQueryable<Order> Query(ISpecification<Order> spec)
    {
        return _db.Set<Order>().Where(spec.ToExpression());
    }
}

// 调用示例
var spec = new OrderAmountGreaterThanSpec(100).And(new OrderStatusSpec("Paid"));
var list = repo.Query(spec).ToList();

四、规约模式的优势总结

• 查询规则独立成类，方便单独测试和复用
• 业务语义清晰，例如<code>OrderAmountGreaterThanSpec</code>一眼可知用途
• 组合方式灵活，避免仓储方法爆炸式增长

注意：示例中的CombinedSpec仅为说明思路，生产环境建议使用成熟的Specification库或正确处理参数替换的ExpressionVisitor。

通过上述方式，你就能在C#项目中用Specification规约模式写出更干净、可维护的查询代码。

C#Specification规约模式修改时间：2026-07-30 02:51:24