SqlSugar中使用IConditionalModel实现动态条件查询与联表查询

前言

在SqlSugar这个优秀的ORM框架中，IConditionalModel接口为我们提供了强大的动态条件查询能力。本文将深入探讨如何利用IConditionalModel实现复杂的动态查询，特别是在多表联查场景下的应用技巧。

IConditionalModel基础用法

IConditionalModel是SqlSugar中用于构建动态查询条件的核心接口，它支持多种条件类型和组合方式。基本使用方式如下：

// 创建条件列表
var conModels = new List<IConditionalModel>();

// 添加等于条件
conModels.Add(new ConditionalModel() { 
    FieldName = "id", 
    ConditionalType = ConditionalType.Equal, 
    FieldValue = "1" 
});

// 使用条件查询
var student = db.Queryable<Order>().Where(conModels).ToList();

复杂条件组合

IConditionalModel支持多种条件类型的组合，可以构建非常复杂的查询逻辑：

// 多种条件类型组合
conModels.Add(new ConditionalModel() { 
    FieldName = "id", 
    ConditionalType = ConditionalType.Like, 
    FieldValue = "1" 
});

// 空值检查
conModels.Add(new ConditionalModel() { 
    FieldName = "id", 
    ConditionalType = ConditionalType.IsNullOrEmpty 
});

// IN查询
conModels.Add(new ConditionalModel() { 
    FieldName = "id", 
    ConditionalType = ConditionalType.In, 
    FieldValue = "1,2,3" 
});

// 条件集合
conModels.Add(new ConditionalCollections() {
    ConditionalList = new List<KeyValuePair<WhereType, ConditionalModel>>() {
        new KeyValuePair<WhereType, ConditionalModel>(
            WhereType.Or,
            new ConditionalModel() { 
                FieldName = "id", 
                ConditionalType = ConditionalType.Equal, 
                FieldValue = "2" 
            }),
        new KeyValuePair<WhereType, ConditionalModel>(
            WhereType.And,
            new ConditionalModel() { 
                FieldName = "id", 
                ConditionalType = ConditionalType.Equal, 
                FieldValue = "2" 
            })
    }
});

联表查询中的应用

在联表查询场景下，使用IConditionalModel需要特别注意表别名的处理：

实体类联表查询

var conModels = new List<IConditionalModel>();
conModels.Add(new ConditionalModel() { 
    FieldName = "o.id", 
    ConditionalType = ConditionalType.Equal, 
    FieldValue = "1" 
});

var query = db.Queryable<Order>()
    .LeftJoin<Custom>((o,cus) => o.CustomId == cus.Id)
    .LeftJoin<OrderDetail>((o,cus,oritem) => o.Id == oritem.OrderId)
    .Where(conModels)
    .Select((o,cus,oritem) => new ViewOrder {
        Id = o.Id,
        CustomName = cus.Name 
    })
    .ToList();

动态表名联表查询

var conModels = new List<IConditionalModel>();
conModels.Add(new ConditionalModel() { 
    FieldName = "o.id", 
    ConditionalType = ConditionalType.Equal, 
    FieldValue = "1" 
});

var list = db.Queryable<dynamic>("o").AS("order")
    .AddJoinInfo("OrderDetail", "i", "o.id=i.OrderId")
    .Where(conModels)
    .Select("o.*")
    .ToList();

高级技巧：MergeTable合并查询

对于复杂的联表查询后需要再进行条件过滤的场景，可以使用MergeTable方法将结果集合并为单表后再进行条件过滤：

var query = db.Queryable<Order>()
    .LeftJoin<Custom>((o,cus) => o.CustomId == cus.Id)
    .LeftJoin<OrderDetail>((o,cus,oritem) => o.Id == oritem.OrderId)
    .Select((o,cus,oritem) => new ViewOrder {
        Id = o.Id,
        CustomName = cus.Name 
    })
    .MergeTable() // 将结果集合并为单表
    .Where(conModels) // 此时可以像操作单表一样添加条件
    .ToList();

实际应用案例

在实际项目中，我们经常需要处理动态过滤条件。以下是一个完整的业务场景实现：

public async ValueTask<PageModel<EmployeesViewModel>> DataPaging(PageInput<EmployeeQuery_FilterModel> model)
{
    // 转换动态过滤条件
    var dynamicFilter = model.DynamicFilter?.ConvertToSqlSugarConditions();
    
    // 添加固定条件
    if (model.Filter?.orgId != null)
    {
        dynamicFilter ??= new List<IConditionalModel>();
        dynamicFilter.Add(new ConditionalModel { 
            FieldName = "OrganizationId", 
            ConditionalType = ConditionalType.Equal, 
            FieldValue = model.Filter.orgId?.ToString() 
        });
    }

    // 执行联表查询
    return await QueryMuchPage_Cache<Hr_Employee_Info_Entity, Hr_Employment_WorkPlaces_Entity, EmployeesViewModel>(
        (o, x) => new object[] { JoinType.Left, o.Id == x.EmployeeId },
        (o, x) => new EmployeesViewModel {
            OrganizationName = SqlFunc.MappingColumn(default(string), 
                "([dbo].[Fn_Organiztion_GetName] (CONCAT([x].OrganizationId,',',[x].DepartmentId,',',[x].TeamId)))"),
            // 其他字段映射...
        },
        (o, x) => o.IsDeleted == false,
        dynamicFilter,
        model.Page,
        model.PageSize,
        true,
        "[o].[Id] DESC",
        null);
}

总结

SqlSugar的IConditionalModel为动态查询提供了强大的支持，特别是在复杂的业务场景中：

1. 支持多种条件类型和复杂的条件组合
2. 在联表查询中需要明确指定表别名
3. MergeTable方法可以简化联表查询后的条件处理
4. 可以方便地与分页等业务需求结合使用

掌握这些技巧，可以让我们在项目中更加灵活地处理各种复杂的查询需求，提高开发效率和代码的可维护性。