1 | <?php |
||
15 | abstract class Query implements \JsonSerializable |
||
16 | { |
||
17 | /** |
||
18 | * @var ElasticClient $client |
||
19 | */ |
||
20 | protected $elastic; |
||
21 | |||
22 | /** |
||
23 | * @var array |
||
24 | */ |
||
25 | protected $listeners = []; |
||
26 | |||
27 | /** |
||
28 | * Получить собранный elasticsearch-запрос |
||
29 | * @return array |
||
30 | */ |
||
31 | abstract public function getQuery(); |
||
32 | |||
33 | |||
34 | /** |
||
35 | * Отправить запрос на конкретный endpoint elasticsearch-сервера |
||
36 | * @param array $query |
||
37 | * @return array |
||
38 | */ |
||
39 | abstract protected function executeQuery(array $query); |
||
40 | |||
41 | |||
42 | /** |
||
43 | * Конструктор |
||
44 | * @param ElasticClient $elastic |
||
45 | */ |
||
46 | public function __construct(ElasticClient $elastic) |
||
50 | |||
51 | |||
52 | /** |
||
53 | * Выполнить запрос к ES и вернуть результаты поиска. |
||
54 | * @return SearchResult - возвращает набор документов |
||
55 | */ |
||
56 | public function fetchAll() |
||
62 | |||
63 | |||
64 | /** |
||
65 | * Выполнить запрос к ES и вернуть необработанный результат (с мета-данными). |
||
66 | * @return array возвращает необработанный ответ ES |
||
67 | */ |
||
68 | public function fetchRaw() |
||
87 | |||
88 | |||
89 | /** |
||
90 | * Создать из ответа ES-сервера экземляр SearchResult |
||
91 | * @param array $response |
||
92 | * @return SearchResult |
||
93 | */ |
||
94 | protected function createSearchResult(array $response) |
||
101 | |||
102 | /** |
||
103 | * Выбрать документы из ответа ES-сервера и добавить script fields. |
||
104 | * @param array $response - ответ ES сервера. |
||
105 | * @return array - возвращает набор документов |
||
106 | */ |
||
107 | protected function extractDocuments(array $response) |
||
127 | |||
128 | |||
129 | /** |
||
130 | * Выбрать из ответа ES-сервера количество найденных документов. |
||
131 | * @param array $response - ответ ES сервера. |
||
132 | * @return integer - возвращает количество найденных документов. |
||
133 | */ |
||
134 | protected function extractTotal(array $response) |
||
142 | |||
143 | public function addListener(IListener $listener) |
||
148 | |||
149 | public function removeListener(IListener $listener) |
||
158 | |||
159 | protected function triggerSuccess(array $query, array $response, $time) |
||
165 | |||
166 | protected function triggerError(array $query, \Exception $e) |
||
172 | |||
173 | /** |
||
174 | * Имплементация \JsonSerializable |
||
175 | * @return array |
||
176 | */ |
||
177 | public function jsonSerialize() |
||
181 | } |