1 | <?php |
||
9 | class FieldsManager |
||
10 | { |
||
11 | /** |
||
12 | * @var ModelsResolver |
||
13 | */ |
||
14 | protected $modelsResolver; |
||
15 | |||
16 | /** |
||
17 | * @var ResourcesResolver |
||
18 | */ |
||
19 | protected $resourcesResolver; |
||
20 | |||
21 | /** |
||
22 | * FieldsManager constructor. |
||
23 | * |
||
24 | * @param ModelsResolver $modelsResolver |
||
25 | * @param ResourcesResolver $resourcesResolver |
||
26 | */ |
||
27 | public function __construct(ModelsResolver $modelsResolver, ResourcesResolver $resourcesResolver) |
||
32 | |||
33 | /** |
||
34 | * Attach field values to the given resource. |
||
35 | * |
||
36 | * @param Model $resource |
||
37 | * @param array $fieldValues |
||
38 | * |
||
39 | * @return Model |
||
40 | */ |
||
41 | public function attachFields(Model $resource, array $fieldValues) |
||
49 | |||
50 | /** |
||
51 | * Sync field values with given resource. |
||
52 | * |
||
53 | * @param Model $resource |
||
54 | * @param array $fieldValues |
||
55 | * @param bool $detach |
||
56 | * |
||
57 | * @return Model |
||
58 | */ |
||
59 | public function syncFields(Model $resource, array $fieldValues, bool $detach = true) |
||
71 | |||
72 | /** |
||
73 | * Detach field values from the given model. |
||
74 | * |
||
75 | * @param Model $resource |
||
76 | * @param array $fieldIds |
||
77 | * |
||
78 | * @return Model |
||
79 | */ |
||
80 | public function detachFields(Model $resource, array $fieldIds) |
||
86 | |||
87 | /** |
||
88 | * Transforms fieldId=>fieldValueId array to attachable list. |
||
89 | * |
||
90 | * @param array $fieldValues |
||
91 | * |
||
92 | * @return array |
||
93 | */ |
||
94 | protected function createAttachableArray(array $fieldValues) |
||
104 | |||
105 | /** |
||
106 | * Loads resources that have exact field values attached. |
||
107 | * |
||
108 | * @param Collection $fieldValues |
||
109 | * |
||
110 | * @return Collection |
||
111 | */ |
||
112 | public function getResourcesByFieldValues(Collection $fieldValues) |
||
123 | |||
124 | /** |
||
125 | * Loads resources by given field=>value pairs. |
||
126 | * |
||
127 | * @param Collection $filter |
||
128 | * |
||
129 | * @return Collection |
||
130 | */ |
||
131 | public function filterResources(Collection $filter) |
||
141 | |||
142 | /** |
||
143 | * Resolves actual models via ResourceResolver and groups them by short key or model class name. |
||
144 | * |
||
145 | * @param Collection $rows |
||
146 | * |
||
147 | * @return Collection |
||
148 | */ |
||
149 | protected function resolveModels($rows) |
||
166 | |||
167 | /** |
||
168 | * Loads filtered rows from `filerables` table. |
||
169 | * |
||
170 | * @param Collection $filter |
||
171 | * |
||
172 | * @return Collection |
||
173 | */ |
||
174 | protected function loadRowsByFilter(Collection $filter) |
||
188 | |||
189 | /** |
||
190 | * Groups DB rows by attached model type. |
||
191 | * |
||
192 | * @param Collection $rows |
||
193 | * |
||
194 | * @return Collection |
||
195 | */ |
||
196 | protected function groupRowsByModelType(Collection $rows) |
||
203 | |||
204 | /** |
||
205 | * Load rows that have given field_value_id list attached. |
||
206 | * |
||
207 | * @param array $valuesId |
||
208 | * |
||
209 | * @return Collection |
||
210 | */ |
||
211 | protected function loadRowsByValuesId(array $valuesId) |
||
217 | |||
218 | /** |
||
219 | * Creates array of value IDs from Collection or array of models/integers (or from single model/integer). |
||
220 | * |
||
221 | * @param \Illuminate\Database\Eloquent\Model|int|Collection|array $fieldValues |
||
222 | * @param string $fieldValueModel = null |
||
223 | * |
||
224 | * @return array |
||
225 | */ |
||
226 | protected function resolveValuesId($fieldValues, string $fieldValueModel = null): array |
||
242 | |||
243 | /** |
||
244 | * Extracts value IDs from collection. |
||
245 | * |
||
246 | * @param Collection $fieldValues |
||
247 | * @param $fieldValueModel |
||
248 | * |
||
249 | * @return array |
||
250 | */ |
||
251 | protected function mapIdsFromCollection(Collection $fieldValues, $fieldValueModel) |
||
265 | } |
||
266 |