在Doctrine DBAL中重用QueryBuilder

奥利弗·哈德（Oliver Hader）

下面的示例显示了一些代码示例的摘录。在QueryBuilder那里，对Doctrine DBAL的调用要进行两次，一次是执行一条SELECT(*)语句，另一次是执行一条COUNT(*)语句。

表，条件，排序顺序和结果限制之类的常用设置将应用于重用QueryBuilder对象。

问题

是否存在$queryBuilder如示例中所示的隐式重用的缺点？
是否建议只为单独的QueryBuilder实例复制粘贴代码？
使用有副作用clone $queryBuilder吗？

代码示例

/**
 * @param array $arguments
 * @return string
 */
private function getOutput(array $arguments)
{
    /** @var \Doctrine\DBAL\Connection $connection */
    $connection = $this->getConnection();

    $queryBuilder = $connection
        ->createQueryBuilder()
        ->from('some_table')
        ->orderBy('sorting')
        ->setMaxResults(100);

    $condition = $queryBuilder->expr()->andX();
    // ... build conditions
    $queryBuilder->where($condition);

    $count = $queryBuilder->select('COUNT(*)')->execute()->fetchColumn(0);
    if ($count === 0) {
        return 'There is nothing to show';
    }
    if ($count > 100) {
        $output = 'Showing first 100 results only:' . PHP_EOL;
    } else {
        $output = 'Showing all results:' . PHP_EOL;
    }

    // implicitly reusing previously defined settings
    // (table, where, orderBy & maxResults)
    $statement = $queryBuilder->select('*')->execute();
    foreach ($statement as $item) {
        $output .= $this->renderItem($item) . PHP_EOL;
    }

    return $output;
}

奥利弗·哈德（Oliver Hader）

Doctrine DBAL中的QueryBuilder可以动态用于定义SQL查询，也可以再次覆盖查询部分。因此，通常select()在同一QueryBuilder实例上两次调用该方法会覆盖前一个select查询部分。构建器内部具有用于清除或脏状态的属性-状态一旦变脏，就必须重新创建SQL字符串。例如，覆盖查询部分会触发脏状态。

因此，从简单的技术角度来看，通常可以重用QueryBuilder。但是，QueryBuilder不会验证跨数据库的特定逻辑。这意味着，多余的查询部分必须手动清除，以免执行语句时查询失败。

更好的方法是将构建查询的过程分为不同的逻辑类方法-一种用于分配公共查询约束，另一种用于特定上下文（例如，对结果进行计数，对结果进行排序和限制结果集）。最后，初始代码示例可能如下所示：

引入了两种其他方法来丰富查询

/**
 * @param QueryBuilder $queryBuilder
 */
private function addConstraints(QueryBuilder $queryBuilder)
{
    $condition = $queryBuilder->expr()->andX();
    // ... build conditions
    $queryBuilder->where($condition);
}

/**
 * @param QueryBuilder $queryBuilder
 */
private function addResultSettings(QueryBuilder $queryBuilder)
{
    $queryBuilder
        ->orderBy('sorting')
        ->setMaxResults(100);
}

现在有QueryBuilder的两个实例，但是查询基本上是在前面显示的两个新方法中定义的。

/**
 * @param array $arguments
 * @return string
 */
private function getOutput(array $arguments)
{
    /** @var \Doctrine\DBAL\Connection $connection */
    $connection = $this->getConnection();

    // first query builder instance for counting records
    $queryBuilder = $connection->createQueryBuilder()->from('some_table');
    $this->addConstraints($queryBuilder);
    $statement = $queryBuilder->select('COUNT(*)')->execute();

    $count = $statement->fetchColumn(0);
    if ($count === 0) {
        return 'There is nothing to show';
    }
    if ($count > 100) {
        $output = 'Showing first 100 results only:' . PHP_EOL;
    } else {
        $output = 'Showing all results:' . PHP_EOL;
    }

    // second query builder instance to actually retrieve result set
    $queryBuilder = $connection->createQueryBuilder()->from('some_table');
    $this->addConstraints($queryBuilder);
    $this->addResultSettings($queryBuilder);
    $statement = $queryBuilder->select('*')->execute();

    foreach ($statement as $item) {
        $output .= $this->renderItem($item) . PHP_EOL;
    }

    return $output;
}

本文收集自互联网，转载请注明来源。

如有侵权，请联系 [email protected] 删除。

编辑于 2020-11-3

我来说两句

0 条评论

登录后参与评论

TOP 榜单

文章