analogueorm / analogue

     * @param  string           $relation

     * @return array

     */

    public function match(array $entities, EntityCollection $results, $relation)

    {

        $dictionary = $this->buildDictionary($results);

        $keyName = $this->relatedMap->getKeyName();

        $cache = $this->parentMapper->getEntityCache();

        // Once we have an array dictionary of child objects we can easily match the

        // children back to their parent using the dictionary and the keys on the

        // the parent models. Then we will return the hydrated models back out.

        foreach ($entities as $entity) {

            $wrapper = $this->factory->make($entity);

            if (isset($dictionary[$key = $wrapper->getEntityAttribute($keyName)])) {

                $collection = $this->relatedMap->newCollection($dictionary[$key]);

                $wrapper->setEntityAttribute($relation, $collection);

                $cache->cacheLoadedRelationResult($entity, $relation, $collection, $this);

            }

        }

        return $entities;

    }

    /**

     * Build model dictionary keyed by the relation's foreign key.

     * @param  string           $type

     * @return array

     */

    protected function matchOneOrMany(array $entities, EntityCollection $results, $relation, $type)

    {

        $dictionary = $this->buildDictionary($results);

        $cache = $this->parentMapper->getEntityCache();

        // Once we have the dictionary we can simply spin through the parent models to

        // link them up with their children using the keyed dictionary to make the

        // matching very convenient and easy work. Then we'll just return them.

        foreach ($entities as $entity) {

            $entity = $this->factory->make($entity);

            $key = $entity->getEntityAttribute($this->localKey);

            if (isset($dictionary[$key])) {

                $value = $this->getRelationValue($dictionary, $key, $type);

                $entity->setEntityAttribute($relation, $value);

                $cache->cacheLoadedRelationResult($entity, $relation, $value, $this);

            }

        }

        return $entities;

    }

    /**

     * Get the value of a relationship by one or many type.