find.php

См. документацию.

<?php
 
namespace Bitrix\Location\Repository\Location\Strategy;
 
use Bitrix\Location\Entity\Location;
use Bitrix\Location\Entity\Generic\Collection;
use Bitrix\Location\Entity\Location\Parents;
use Bitrix\Location\Repository\Location\Capability\IFindByCoords;
use Bitrix\Location\Repository\Location\Capability\IFindByExternalId;
use Bitrix\Location\Repository\Location\Capability\IFindById;
use Bitrix\Location\Repository\Location\Capability\IFindByText;
use Bitrix\Location\Repository\Location\Capability\IFindParents;
use Bitrix\Location\Repository\Location\Capability\ISupportAutocomplete;
use Bitrix\Location\Repository\Location\IScope;
use Bitrix\Location\Repository\Location\IRepository;
use Bitrix\Location\Repository\Location\ICache;
use Bitrix\Location\Repository\Location\IDatabase;

class Find extends Base
{
    public function findById(int $id, string $languageId, int $searchScope)
    {
        return $this->find(IFindById::class, 'findById', [$id, $languageId], $searchScope);
    }
 
    public function findByExternalId(string $externalId, string $sourceCode, string $languageId, int $searchScope)
    {
        return $this->find(
            IFindByExternalId::class,
            'findByExternalId',
            [
                $externalId,
                $sourceCode,
                $languageId,
            ],
            $searchScope
        );
    }
 
    public function findByCoords(
        float $lat,
        float $lng,
        int $zoom,
        string $languageId,
        int $searchScope
    )
    {
        return $this->find(
            IFindByCoords::class,
            'findByCoords',
            [
                $lat,
                $lng,
                $zoom,
                $languageId,
            ],
            $searchScope
        );
    }
 
    public function findByText(string $text, string $languageId, int $searchScope)
    {
        $result = $this->find(
            IFindByText::class,
            'findByText',
            [
                $text,
                $languageId,
            ],
            $searchScope
        );
 
        return $result ?? new Location\Collection();
    }
    
    public function autocomplete(array $params, int $searchScope)
    {
        $result = $this->find(
            ISupportAutocomplete::class,
            'autocomplete',
            [
                $params,
            ],
            $searchScope
        );
 
        return $result ?? [];
    }
 
    public function findParents(Location $location, string $languageId, int $searchScope)
    {
        $result = $this->find(
            IFindParents::class,
            'findParents',
            [
                $location,
                $languageId,
            ],
            $searchScope
        );
 
        return $result ?? new Parents();
    }

    public function setLocationRepositories(array $locationRepositories): Base
    {
        $idx = 0;
 
        foreach ($locationRepositories as $repository)
        {
            if (
                $repository instanceof IFindById
                || $repository instanceof IFindByExternalId
                || $repository instanceof IFindByText
                || $repository instanceof IFindParents
            )
            {
                $key = (string)$this->getRepoPriority($repository) . (string)($idx++);
                $this->locationRepositories[$key] = $repository;
            }
        }
 
        ksort($this->locationRepositories);
 
        return $this;
    }

    protected function find(string $interface, string $method, array $params, int $searchScope)
    {
        foreach ($this->locationRepositories as $repository)
        {
            if ($repository instanceof IScope)
            {
                if (!$repository->isScopeSatisfy($searchScope))
                {
                    continue;
                }
            }
 
            if ($repository instanceof $interface)
            {
                $result = call_user_func_array([$repository, $method], $params);
 
                if ($result)
                {
                    if (!($result instanceof Location\Collection) || $result->count() > 0)
                    {
                        return $result;
                    }
                }
            }
        }
 
        return null;
    }
 
    protected function getRepoPriority(IRepository $repository): string
    {
        if ($repository instanceof ICache)
        {
            return self::REPO_PRIORITY_A;
        }
        elseif ($repository instanceof IDatabase)
        {
            return self::REPO_PRIORITY_B;
        }
 
        return self::REPO_PRIORITY_C;
    }
}