当无法使用@orderBy注释时,根据关联的实体对Doctrine Collection进行排序

时间:2014-04-03 05:34:21

标签: php symfony doctrine-orm

我想了解基于相关实体订购Doctrine Collection的最佳方式。在这种情况下,无法使用@orderBy注释。

我在互联网上找到了5个解决方案。

1)向AbstractEntity添加方法(根据Ian Belter https://stackoverflow.com/a/22183527/1148260

/**
 * This method will change the order of elements within a Collection based on the given method.
 * It preserves array keys to avoid any direct access issues but will order the elements
 * within the array so that iteration will be done in the requested order.
 *
 * @param string $property
 * @param array  $calledMethods
 *
 * @return $this
 * @throws \InvalidArgumentException
 */
public function orderCollection($property, $calledMethods = array())
{
    /** @var Collection $collection */
    $collection = $this->$property;

    // If we have a PersistentCollection, make sure it is initialized, then unwrap it so we
    // can edit the underlying ArrayCollection without firing the changed method on the
    // PersistentCollection. We're only going in and changing the order of the underlying ArrayCollection.
    if ($collection instanceOf PersistentCollection) {
        /** @var PersistentCollection $collection */
        if (false === $collection->isInitialized()) {
            $collection->initialize();
        }
        $collection = $collection->unwrap();
    }

    if (!$collection instanceOf ArrayCollection) {
        throw new InvalidArgumentException('First argument of orderCollection must reference a PersistentCollection|ArrayCollection within $this.');
    }

    $uaSortFunction = function($first, $second) use ($calledMethods) {

        // Loop through $calledMethods until we find a orderable difference
        foreach ($calledMethods as $callMethod => $order) {

            // If no order was set, swap k => v values and set ASC as default.
            if (false == in_array($order, array('ASC', 'DESC')) ) {
                $callMethod = $order;
                $order = 'ASC';
            }

            if (true == is_string($first->$callMethod())) {

                // String Compare
                $result = strcasecmp($first->$callMethod(), $second->$callMethod());

            } else {

                // Numeric Compare
                $difference = ($first->$callMethod() - $second->$callMethod());
                // This will convert non-zero $results to 1 or -1 or zero values to 0
                // i.e. -22/22 = -1; 0.4/0.4 = 1;
                $result = (0 != $difference) ? $difference / abs($difference): 0;
            }

            // 'Reverse' result if DESC given
            if ('DESC' == $order) {
                $result *= -1;
            }

            // If we have a result, return it, else continue looping
            if (0 !== (int) $result) {
                return (int) $result;
            }
        }

        // No result, return 0
        return 0;
    };

    // Get the values for the ArrayCollection and sort it using the function
    $values = $collection->getValues();
    uasort($values, $uaSortFunction);

    // Clear the current collection values and reintroduce in new order.
    $collection->clear();
    foreach ($values as $key => $item) {
        $collection->set($key, $item);
    }

    return $this;
}

2)创建一个Twig扩展,如果你需要在模板中进行排序(根据Kris https://stackoverflow.com/a/12505347/1148260

use Doctrine\Common\Collections\Collection;

public function sort(Collection $objects, $name, $property = null)
{
    $values = $objects->getValues();
    usort($values, function ($a, $b) use ($name, $property) {
        $name = 'get' . $name;
        if ($property) {
            $property = 'get' . $property;
            return strcasecmp($a->$name()->$property(), $b->$name()->$property());
        } else {
            return strcasecmp($a->$name(), $b->$name());
        }
    });
    return $values;
}

3)将集合转换为数组,然后对其进行排序(根据Benjamin Eberlei https://groups.google.com/d/msg/doctrine-user/zCKG98dPiDY/oOSZBMabebwJ

public function getSortedByFoo()
{
    $arr = $this->arrayCollection->toArray();
    usort($arr, function($a, $b) {
    if ($a->getFoo() > $b->getFoo()) {
        return -1;
    }
    //...
    });
    return $arr;
}

4)使用ArrayIterator对集合进行排序(根据nifr https://stackoverflow.com/a/16707694/1148260

$iterator = $collection->getIterator();
$iterator->uasort(function ($a, $b) {
    return ($a->getPropery() < $b->getProperty()) ? -1 : 1;
});
$collection = new ArrayCollection(iterator_to_array($iterator));

5)创建一个服务来收集有序集合,然后替换无序集合(我没有一个例子,但我认为很清楚)。我认为这是最丑陋的解决方案。

根据您的经验,哪种解决方案最好?您是否有其他建议以更有效/更优雅的方式订购系列?

非常感谢你。

1 个答案:

答案 0 :(得分:6)

前提

你提出了5个有效/正常的解决方案,但我认为所有这些解决方案都可以减少到两个案例,只有一些小的变体。

我们知道排序总是O(NlogN),所以所有解决方案在理论上都具有相同的性能。但由于这是Doctrine,SQL查询和Hydration方法的数量(即将数据从数组转换为对象实例)是瓶颈。

因此,您需要选择“最佳方法”,具体取决于您何时需要加载实体以及您将如何使用它们。

这些是我的“最佳解决方案”,在一般情况下,我更喜欢我的解决方案A)

A)加载程序/存储库服务中的DQL

类似

没有你的情况(不知何故有5,见最后的注释)。 AlbertoFernández在评论中指出了正确的方向。

最佳

DQL是(可能)最快的方法,因为委托排序到DBMS,这是为此高度优化的。 DQL还提供了在单个查询和水合模式中获取哪些实体的总体控制。

缺点

通过配置修改Doctrine Proxy类生成的查询是不可能的(AFAIK),因此您的应用程序需要使用Repository并在每次加载实体时调用正确的方法(或覆盖默认的方法)。

实施例

class MainEntityRepository extends EntityRepository
{
    public function findSorted(array $conditions)
    {
        $qb = $this->createQueryBuilder('e')
            ->innerJoin('e.association', 'a')
            ->orderBy('a.value')
        ;
        // if you always/frequently read 'a' entities uncomment this to load EAGER-ly
        // $qb->select('e', 'a');

        // If you just need data for display (e.g. in Twig only)
        // return $qb->getQuery()->getResult(Query::HYDRATE_ARRAY);

        return $qb->getQuery()->getResult();
    }
}

B)急切加载,并在PHP中进行排序

与案例

类似

案例2),3)和4)在不同的地方完成同样的事情。我的版本是一般情况,只要提取实体就适用。如果你必须选择其中之一,那么我认为解决方案3)是最方便的,因为不要搞乱实体并且始终可用,但是使用EAGER加载(继续阅读)。

最佳

如果始终读取关联实体,但无法(或方便)添加服务,则所有实体都应加载EAGER-ly。然后,只要对应用程序有意义,就可以通过PHP进行排序:在事件监听器中,在控制器中,在树枝模板中......如果应始终加载实体,那么事件监听器是最佳选择。 / p>

缺点

比DQL更灵活,并且当集合很大时,在PHP中进行排序可能是一个缓慢的操作。此外,实体需要水合作为对象,这是缓慢的,如果集合不用于其他目的则是过度的。请注意延迟加载,因为这会为每个实体触发一个查询。

实施例

MainEntity.orm.xml:

<?xml version="1.0" encoding="utf-8"?>
<doctrine-mapping>
  <entity name="MainEntity">
    <id name="id" type="integer" />
    <one-to-many field="collection" target-entity="LinkedEntity" fetch="EAGER" />
    <entity-listeners>
      <entity-listener class="MainEntityListener"/>
    </entity-listeners>
  </entity>
</doctrine-mapping>

MainEntity.php:

class MainEntityListener
{
    private $id;

    private $collection;

    public function __construct()
    {
        $this->collection = new ArrayCollection();
    }

    // this works only with Doctrine 2.5+, in previous version association where not loaded on event
    public function postLoad(array $conditions)
    {
        /*
         * From your example 1)
         * Remember that $this->collection is an ArryCollection when constructor is called,
         * but a PersistentCollection when are loaded from DB. Don't recreate the instance!
         */

        // Get the values for the ArrayCollection and sort it using the function
        $values = $this->collection->getValues();

        // sort as you like
        asort($values);

        // Clear the current collection values and reintroduce in new order.
        $collection->clear();
        foreach ($values as $key => $item) {
            $collection->set($key, $item);
        }
    }
}

最终笔记

  • 我不会使用案例1),因为它非常复杂并且引入了减少封装的继承。另外,我认为它具有与我的例子相同的复杂性和性能。
  • 案例5)不一定是坏事。如果“服务”是应用程序存储库,并且它使用DQL进行排序,那么这是我的第一个最佳案例。如果只是一个自定义服务来排序集合,那么我认为绝对不是一个好的解决方案。
  • 我在这里写的所有代码都没有准备好“复制粘贴”,因为我的目标是展示我的观点。希望这将是一个很好的起点。

声明

这些是“我的”最佳解决方案,正如我在我的作品中所做的那样。希望能帮助你和其他人。