Kreyu DataTable Bundle 中如何实现无ORM的数组数据过滤

Kreyu DataTable Bundle 中如何实现无ORM的数组数据过滤

背景介绍

Kreyu DataTable Bundle 是一个功能强大的 Symfony 数据表格组件。虽然它原生支持与 Doctrine ORM 集成，但在某些场景下，开发者可能需要处理非数据库来源的数据，比如来自 API、消息总线或其他非ORM数据源的数据。

核心挑战

当不使用 ORM 时，开发者面临的主要挑战是如何实现对数组数据的过滤功能。与 ORM 不同，数组数据没有内置的查询构建器，需要开发者自行实现过滤逻辑。

解决方案

自定义 ProxyQuery 实现

要实现数组数据的过滤，关键在于创建一个自定义类来实现 ProxyQueryInterface。这个接口是数据表格与底层数据源之间的桥梁，负责处理排序、分页和过滤等操作。

实现要点

1. 数据存储：在自定义类中维护原始数据数组
2. 过滤逻辑：添加方法来设置和应用过滤条件
3. 结果处理：在 getResult() 方法中应用所有过滤条件

示例实现思路

class ArrayFilterProxyQuery implements ProxyQueryInterface
{
    private array $data;
    private array $filters = [];
    
    public function __construct(array $data) {
        $this->data = $data;
    }
    
    public function setFilters(array $filters): void {
        $this->filters = $filters;
    }
    
    public function getResult(): array {
        $filteredData = $this->data;
        
        // 应用所有过滤条件
        foreach ($this->filters as $filter) {
            $filteredData = array_filter($filteredData, function($item) use ($filter) {
                // 根据过滤条件判断是否保留该项
                return $this->applyFilter($item, $filter);
            });
        }
        
        return array_values($filteredData);
    }
    
    // 其他必需接口方法的实现...
}

过滤器处理器实现

创建自定义过滤器处理器时，需要：

1. 接收过滤条件
2. 将它们设置到 ProxyQuery 实例中
3. 让 ProxyQuery 在获取结果时应用这些条件

class ArrayFilterHandler implements FilterHandlerInterface
{
    public function handle(FilterInterface $filter, ProxyQueryInterface $query): void
    {
        if ($query instanceof ArrayFilterProxyQuery) {
            $query->setFilters([
                // 转换过滤条件为适合数组过滤的格式
            ]);
        }
    }
}

最佳实践建议

1. 性能考虑：对于大数据集，考虑实现缓存机制
2. 复杂过滤：支持多种过滤操作符(等于、包含、大于等)
3. 组合过滤：正确处理 AND/OR 逻辑组合
4. 类型安全：确保过滤条件与数据类型匹配

总结

通过实现自定义的 ProxyQueryInterface 和过滤器处理器，Kreyu DataTable Bundle 可以灵活地支持各种非ORM数据源的过滤需求。这种方法保持了与ORM相似的API体验，同时提供了处理数组数据的灵活性。开发者可以根据具体业务需求扩展过滤逻辑，构建高效的数据表格功能。