Kendo UI Core中DataSource过滤器AddRange方法的重载优化

在Kendo UI Core项目中，DataSource组件是构建数据驱动型应用的核心部分。最近，开发团队对DataSource的过滤器API进行了重要增强，特别是针对AddRange方法的重载功能。

背景与现状

DataSource组件提供了强大的数据过滤功能，其中AddRange方法允许开发者批量添加多个过滤条件。在2024.2.514版本之前，AddRange方法只有一个默认实现，它会自动将所有过滤条件用AND逻辑运算符连接起来。

这种设计虽然简单易用，但在实际开发中经常遇到需要灵活组合过滤条件的场景。例如，用户可能希望某些条件用OR连接，而另一些用AND连接，现有的API无法直接满足这种需求。

新增功能特性

开发团队新增了一个重载版本的AddRange方法，允许开发者显式指定逻辑运算符。这个改进使得过滤条件的组合更加灵活和强大。

新方法的签名如下：

AddRange(IEnumerable<IFilterDescriptor> filters, FilterCompositionLogicalOperator logicalOperator)

其中第二个参数可以指定为：

• FilterCompositionLogicalOperator.And
• FilterCompositionLogicalOperator.Or

实际应用示例

假设我们有一个产品列表，需要筛选出价格低于100或者库存量大于50的产品。使用新的API可以这样实现：

@(Html.Kendo().Grid<Product>()
    .Name("productsGrid")
    .DataSource(dataSource => dataSource
        .Ajax()
        .PageSize(20)
        .Model(model => model.Id(p => p.ProductID))
        .Filter(filter => filter.AddRange(new List<IFilterDescriptor> {
            new FilterDescriptor("Price", FilterOperator.LessThan, 100),
            new FilterDescriptor("UnitsInStock", FilterOperator.GreaterThan, 50)
        }, FilterCompositionLogicalOperator.Or))
    )
)

技术实现分析

在底层实现上，这个改进涉及到了Kendo UI Core的过滤器组合逻辑。当指定OR运算符时，系统会创建一个复合过滤器，将所有条件用OR连接，而不是默认的AND连接。

这种设计遵循了开放封闭原则(OCP)，通过扩展而不是修改现有代码来增加新功能。原有的AND逻辑保持不变，只是增加了新的选项。

最佳实践建议

1. 性能考虑：使用OR运算符的查询可能会比AND查询消耗更多资源，特别是在大数据集上。建议合理设计过滤条件。

2. 可读性：当过滤条件较多时，考虑将条件列表提取到单独的变量中，提高代码可读性。

3. 组合使用：可以多次调用AddRange方法，结合不同的逻辑运算符，构建复杂的过滤逻辑。

总结

Kendo UI Core团队对DataSource过滤器API的这一增强，显著提升了数据过滤的灵活性。开发者现在可以更精确地控制过滤条件的组合方式，满足各种复杂的业务需求。这一改进体现了Kendo UI Core持续优化开发者体验的承诺，使得构建数据密集型应用更加高效和便捷。