Duplicate code is one of the most pungent code smells. A rule that is often used is to re-structure code once it is duplicated in three or more places.
Common duplication problems, and corresponding solutions are:
Complex classes like ClientRemote often do a lot of different things. To break such a class down, we need to identify a cohesive component within that class. A common approach to find such a component is to look for fields/methods that share the same prefixes, or suffixes. You can also have a look at the cohesion graph to spot any un-connected, or weakly-connected components.
Once you have determined the fields that belong together, you can apply the Extract Class refactoring. If the component makes sense as a sub-class, Extract Subclass is also a candidate, and is often faster.
While breaking up the class, it is a good idea to analyze how other classes use ClientRemote, and based on these observations, apply Extract Interface, too.
1 | <?php |
||
20 | class ClientRemote extends BaseClientRemote |
||
21 | { |
||
22 | /** |
||
23 | * @inheritdoc |
||
24 | */ |
||
25 | 2 | public function getTables(array $params = []) |
|
29 | |||
30 | /** |
||
31 | * @inheritdoc |
||
32 | */ |
||
33 | 4 | public function getTable($tableName) |
|
39 | |||
40 | /** |
||
41 | * @inheritdoc |
||
42 | */ |
||
43 | 2 | public function getColumns($tableName, array $params = []) |
|
49 | |||
50 | /** |
||
51 | * @inheritdoc |
||
52 | */ |
||
53 | 2 | public function getColumn($tableName, $columnName) |
|
59 | |||
60 | /** |
||
61 | * @inheritdoc |
||
62 | */ |
||
63 | 2 | public function getItems($tableName, array $options = []) |
|
64 | { |
||
65 | 2 | $path = $this->buildPath(static::TABLE_ENTRIES_ENDPOINT, $tableName); |
|
66 | |||
67 | 2 | return $this->performRequest('GET', $path, ['query' => $options]); |
|
68 | } |
||
69 | |||
70 | /** |
||
71 | * @inheritdoc |
||
72 | */ |
||
73 | 2 | public function getItem($tableName, $id, array $options = []) |
|
74 | { |
||
75 | 2 | $path = $this->buildPath(static::TABLE_ENTRY_ENDPOINT, [$tableName, $id]); |
|
76 | |||
77 | 2 | return $this->performRequest('GET', $path, ['query' => $options]); |
|
78 | } |
||
79 | |||
80 | /** |
||
81 | * @inheritdoc |
||
82 | */ |
||
83 | 2 | public function getUsers(array $params = []) |
|
87 | |||
88 | /** |
||
89 | * @inheritdoc |
||
90 | */ |
||
91 | 2 | public function getUser($id, array $params = []) |
|
95 | |||
96 | /** |
||
97 | * @inheritdoc |
||
98 | */ |
||
99 | 2 | public function getGroups() |
|
103 | |||
104 | /** |
||
105 | * @inheritdoc |
||
106 | */ |
||
107 | 2 | public function getGroup($groupID) |
|
113 | |||
114 | /** |
||
115 | * @inheritdoc |
||
116 | */ |
||
117 | 2 | public function getGroupPrivileges($groupID) |
|
123 | |||
124 | /** |
||
125 | * @inheritdoc |
||
126 | */ |
||
127 | 2 | public function getFiles() |
|
131 | |||
132 | /** |
||
133 | * @inheritdoc |
||
134 | */ |
||
135 | 2 | public function getFile($fileID) |
|
141 | |||
142 | /** |
||
143 | * @inheritdoc |
||
144 | */ |
||
145 | 2 | public function getSettings() |
|
149 | |||
150 | /** |
||
151 | * @inheritdoc |
||
152 | */ |
||
153 | 2 | public function getSettingsByCollection($collectionName) |
|
159 | |||
160 | /** |
||
161 | * @inheritdoc |
||
162 | */ |
||
163 | public function updateSettings($collection, array $data) |
||
164 | { |
||
165 | $path = $this->buildPath(static::SETTING_COLLECTION_UPDATE_ENDPOINT, $collection); |
||
166 | |||
167 | return $this->performRequest('PUT', $path, [ |
||
168 | 'body' => $data |
||
169 | ]); |
||
170 | } |
||
171 | |||
172 | /** |
||
173 | * @inheritdoc |
||
174 | */ |
||
175 | View Code Duplication | public function getMessages($userId = null) |
|
176 | { |
||
177 | if ($userId !== null) { |
||
178 | $path = $this->buildPath(static::MESSAGES_USER_LIST_ENDPOINT, $userId); |
||
179 | } else { |
||
180 | $path = $this->buildPath(static::MESSAGES_LIST_ENDPOINT); |
||
181 | } |
||
182 | |||
183 | return $this->performRequest('GET', $path); |
||
184 | } |
||
185 | |||
186 | /** |
||
187 | * @inheritdoc |
||
188 | */ |
||
189 | public function getMessage($id) |
||
190 | { |
||
191 | $path = $this->buildPath(static::MESSAGES_GET_ENDPOINT, $id); |
||
192 | |||
193 | return $this->performRequest('GET', $path); |
||
194 | } |
||
195 | |||
196 | /** |
||
197 | * @inheritdoc |
||
198 | */ |
||
199 | View Code Duplication | public function createItem($tableName, array $data) |
|
200 | { |
||
201 | $path = $this->buildPath(static::TABLE_ENTRY_CREATE_ENDPOINT, $tableName); |
||
202 | $data = $this->processData($tableName, $data); |
||
203 | |||
204 | return $this->performRequest('POST', $path, ['body' => $data]); |
||
205 | } |
||
206 | |||
207 | /** |
||
208 | * @inheritdoc |
||
209 | */ |
||
210 | View Code Duplication | public function updateItem($tableName, $id, array $data) |
|
211 | { |
||
212 | $path = $this->buildPath(static::TABLE_ENTRY_UPDATE_ENDPOINT, [$tableName, $id]); |
||
213 | $data = $this->processData($tableName, $data); |
||
214 | |||
215 | return $this->performRequest('PUT', $path, ['body' => $data]); |
||
216 | } |
||
217 | |||
218 | /** |
||
219 | * @inheritdoc |
||
220 | */ |
||
221 | public function deleteItem($tableName, $id) |
||
222 | { |
||
223 | $path = $this->buildPath(static::TABLE_ENTRY_DELETE_ENDPOINT, [$tableName, $id]); |
||
224 | |||
225 | return $this->performRequest('DELETE', $path); |
||
226 | } |
||
227 | |||
228 | /** |
||
229 | * @inheritdoc |
||
230 | */ |
||
231 | public function createUser(array $data) |
||
235 | |||
236 | /** |
||
237 | * @inheritdoc |
||
238 | */ |
||
239 | public function updateUser($id, array $data) |
||
243 | |||
244 | /** |
||
245 | * @inheritdoc |
||
246 | */ |
||
247 | public function deleteUser($ids) |
||
248 | { |
||
249 | return $this->deleteItem('directus_users', $ids); |
||
250 | } |
||
251 | |||
252 | /** |
||
253 | * @inheritdoc |
||
254 | */ |
||
255 | public function createFile(File $file) |
||
256 | { |
||
257 | $data = $this->processFile($file); |
||
258 | |||
259 | return $this->performRequest('POST', static::FILE_CREATE_ENDPOINT, ['body' => $data]); |
||
260 | } |
||
261 | |||
262 | /** |
||
263 | * @inheritdoc |
||
264 | */ |
||
265 | public function updateFile($id, $data) |
||
266 | { |
||
267 | if ($data instanceof File) { |
||
268 | $data = $data->toArray(); |
||
269 | } |
||
270 | |||
271 | $data['id'] = $id; |
||
272 | $path = $this->buildPath(static::FILE_UPDATE_ENDPOINT, $id); |
||
273 | $data = $this->processData('directus_files', $data); |
||
274 | |||
275 | return $this->performRequest('POST', $path, ['body' => $data]); |
||
276 | } |
||
277 | |||
278 | /** |
||
279 | * @inheritdoc |
||
280 | */ |
||
281 | public function deleteFile($id) |
||
282 | { |
||
283 | return $this->deleteItem('directus_files', $id); |
||
284 | } |
||
285 | |||
286 | public function createPreferences($data) |
||
287 | { |
||
288 | $this->requiredAttributes(['title', 'table_name'], $data); |
||
289 | |||
290 | $tableName = ArrayUtils::get($data, 'table_name'); |
||
291 | $path = $this->buildPath(static::TABLE_PREFERENCES_ENDPOINT, $tableName); |
||
292 | $data = $this->processData($tableName, $data); |
||
293 | |||
294 | return $this->performRequest('POST', $path, ['body' => $data]); |
||
295 | } |
||
296 | |||
297 | /** |
||
298 | * @inheritdoc |
||
299 | */ |
||
300 | public function createBookmark($data) |
||
301 | { |
||
302 | $preferences = $this->createPreferences(ArrayUtils::pick($data, [ |
||
303 | 'title', 'table_name', 'sort', 'status', 'search_string', 'sort_order', 'columns_visible' |
||
304 | ])); |
||
305 | |||
306 | $title = $preferences->title; |
||
307 | $tableName = $preferences->table_name; |
||
308 | $bookmarkData = [ |
||
309 | 'section' => 'search', |
||
310 | 'title' => $title, |
||
311 | 'url' => 'tables/' . $tableName . '/pref/' . $title |
||
312 | ]; |
||
313 | |||
314 | $path = $this->buildPath(static::BOOKMARKS_CREATE_ENDPOINT); |
||
315 | $bookmarkData = $this->processData($tableName, $bookmarkData); |
||
316 | |||
317 | return $this->performRequest('POST', $path, ['body' => $bookmarkData]); |
||
318 | } |
||
319 | |||
320 | /** |
||
321 | * @inheritdoc |
||
322 | */ |
||
323 | public function getBookmark($id) |
||
329 | |||
330 | /** |
||
331 | * @inheritdoc |
||
332 | */ |
||
333 | View Code Duplication | public function getBookmarks($userId = null) |
|
334 | { |
||
335 | if ($userId !== null) { |
||
336 | $path = $this->buildPath(static::BOOKMARKS_USER_ENDPOINT, $userId); |
||
337 | } else { |
||
338 | $path = $this->buildPath(static::BOOKMARKS_ALL_ENDPOINT); |
||
339 | } |
||
340 | |||
341 | return $this->performRequest('GET', $path); |
||
342 | } |
||
343 | |||
344 | /** |
||
345 | * @inheritdoc |
||
346 | */ |
||
347 | public function createColumn($data) |
||
348 | { |
||
349 | $data = $this->parseColumnData($data); |
||
350 | |||
351 | return $this->performRequest('POST', $this->buildPath(static::COLUMN_CREATE_ENDPOINT, $data['table_name']), [ |
||
352 | 'body' => $data |
||
353 | ]); |
||
354 | } |
||
355 | |||
356 | /** |
||
357 | * @inheritdoc |
||
358 | */ |
||
359 | public function createGroup(array $data) |
||
360 | { |
||
361 | return $this->performRequest('POST', static::GROUP_CREATE_ENDPOINT, [ |
||
362 | 'body' => $data |
||
363 | ]); |
||
364 | } |
||
365 | |||
366 | /** |
||
367 | * @inheritdoc |
||
368 | */ |
||
369 | public function createMessage(array $data) |
||
370 | { |
||
371 | $this->requiredAttributes(['from', 'message', 'subject'], $data); |
||
372 | $this->requiredOneAttribute(['to', 'toGroup'], $data); |
||
373 | |||
374 | $data['recipients'] = $this->getMessagesTo($data); |
||
375 | ArrayUtils::remove($data, ['to', 'toGroup']); |
||
376 | |||
377 | return $this->performRequest('POST', static::MESSAGES_CREATE_ENDPOINT, [ |
||
378 | 'body' => $data |
||
379 | ]); |
||
380 | } |
||
381 | |||
382 | /** |
||
383 | * @inheritdoc |
||
384 | */ |
||
385 | public function sendMessage(array $data) |
||
386 | { |
||
387 | return $this->createMessage($data); |
||
388 | } |
||
389 | |||
390 | /** |
||
391 | * @inheritdoc |
||
392 | */ |
||
393 | public function createPrivileges(array $data) |
||
394 | { |
||
395 | $this->requiredAttributes(['group_id', 'table_name'], $data); |
||
396 | |||
397 | return $this->performRequest('POST', static::GROUP_PRIVILEGES_CREATE_ENDPOINT, [ |
||
398 | 'body' => $data |
||
399 | ]); |
||
400 | } |
||
401 | |||
402 | public function createTable($name, array $params = []) |
||
403 | { |
||
404 | $data = [ |
||
405 | 'addTable' => true, |
||
406 | 'table_name' => $name |
||
407 | ]; |
||
408 | |||
409 | return $this->performRequest('POST', static::TABLE_CREATE_ENDPOINT, [ |
||
410 | 'body' => $data |
||
411 | ]); |
||
412 | } |
||
413 | |||
414 | /** |
||
415 | * @inheritdoc |
||
416 | */ |
||
417 | public function createColumnUIOptions(array $data) |
||
418 | { |
||
419 | $this->requiredAttributes(['table', 'column', 'ui', 'options'], $data); |
||
420 | |||
421 | $path = $this->buildPath(static::COLUMN_OPTIONS_CREATE_ENDPOINT, [ |
||
422 | $data['table'], |
||
423 | $data['column'], |
||
424 | $data['ui'] |
||
425 | ]); |
||
426 | |||
427 | $data = ArrayUtils::get($data, 'options'); |
||
428 | |||
429 | return $this->performRequest('POST', $path, [ |
||
430 | 'body' => $data |
||
431 | ]); |
||
432 | } |
||
433 | |||
434 | /** |
||
435 | * @inheritdoc |
||
436 | */ |
||
437 | public function getPreferences($table, $user = null) |
||
441 | |||
442 | /** |
||
443 | * @inheritdoc |
||
444 | */ |
||
445 | public function deleteBookmark($id) |
||
449 | |||
450 | /** |
||
451 | * @inheritdoc |
||
452 | */ |
||
453 | public function deleteColumn($name, $table) |
||
454 | { |
||
455 | $path = $this->buildPath(static::COLUMN_DELETE_ENDPOINT, [$name, $table]); |
||
456 | |||
457 | return $this->performRequest('DELETE', $path); |
||
458 | } |
||
459 | |||
460 | /** |
||
461 | * @inheritdoc |
||
462 | */ |
||
463 | public function deleteGroup($id) |
||
467 | |||
468 | /** |
||
469 | * @inheritdoc |
||
470 | */ |
||
471 | public function deleteTable($name) |
||
472 | { |
||
473 | $path = $this->buildPath(static::TABLE_DELETE_ENDPOINT, $name); |
||
474 | |||
475 | return $this->performRequest('DELETE', $path); |
||
476 | } |
||
477 | |||
478 | /** |
||
479 | * @inheritdoc |
||
480 | */ |
||
481 | public function getActivity(array $params = []) |
||
482 | { |
||
483 | $path = $this->buildPath(static::ACTIVITY_GET_ENDPOINT); |
||
484 | |||
485 | return $this->performRequest('GET', $path, [ |
||
486 | 'query' => $params |
||
487 | ]); |
||
488 | } |
||
489 | } |
||
490 |