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 NounDeclension 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 NounDeclension, and based on these observations, apply Extract Interface, too.
1 | <?php |
||
12 | class NounDeclension extends BaseInflection implements Cases, Gender |
||
13 | { |
||
14 | use RussianLanguage, CasesHelper; |
||
15 | |||
16 | const FIRST_DECLENSION = 1; |
||
17 | const SECOND_DECLENSION = 2; |
||
18 | const THIRD_DECLENSION = 3; |
||
19 | |||
20 | /** @var string[] */ |
||
21 | public static $immutableWords = [ |
||
22 | // валюты |
||
23 | 'евро', 'пенни', 'песо', 'сентаво', |
||
24 | |||
25 | // на а |
||
26 | 'боа', 'бра', 'фейхоа', 'амплуа', 'буржуа', |
||
27 | // на о |
||
28 | 'манго', 'какао', 'кино', 'трюмо', 'пальто', 'бюро', 'танго', 'вето', 'бунгало', 'сабо', 'авокадо', 'депо', 'панно', |
||
29 | // на у |
||
30 | 'зебу', 'кенгуру', 'рагу', 'какаду', 'шоу', |
||
31 | // на е |
||
32 | 'шимпанзе', 'конферансье', 'атташе', 'колье', 'резюме', 'пенсне', 'кашне', 'протеже', 'коммюнике', 'драже', 'суфле', 'пюре', 'купе', 'фойе', 'шоссе', 'крупье', |
||
33 | // на и |
||
34 | 'такси', 'жалюзи', 'шасси', 'алиби', 'киви', 'иваси', 'регби', 'конфетти', 'колибри', 'жюри', 'пенальти', 'рефери', 'кольраби', |
||
35 | // на э |
||
36 | 'каноэ', 'алоэ', |
||
37 | // на ю |
||
38 | 'меню', 'парвеню', 'авеню', 'дежавю', 'инженю', 'барбекю', 'интервью', |
||
39 | ]; |
||
40 | |||
41 | /** |
||
42 | * These words has 2 declension type. |
||
43 | * @var string[]|string[][] |
||
44 | */ |
||
45 | protected static $abnormalExceptions = [ |
||
46 | 'бремя', |
||
47 | 'вымя', |
||
48 | 'темя', |
||
49 | 'пламя', |
||
50 | 'стремя', |
||
51 | 'пламя', |
||
52 | 'время', |
||
53 | 'знамя', |
||
54 | 'имя', |
||
55 | 'племя', |
||
56 | 'семя', |
||
57 | 'путь' => ['путь', 'пути', 'пути', 'путь', 'путем', 'пути'], |
||
58 | 'дитя' => ['дитя', 'дитяти', 'дитяти', 'дитя', 'дитятей', 'дитяти'], |
||
59 | ]; |
||
60 | |||
61 | /** @var string[] */ |
||
62 | protected static $masculineWithSoft = [ |
||
63 | 'автослесарь', |
||
64 | 'библиотекарь', |
||
65 | 'водитель', |
||
66 | 'воспитатель', |
||
67 | 'врач', |
||
68 | 'выхухоль', |
||
69 | 'гвоздь', |
||
70 | 'делопроизводитель', |
||
71 | 'день', |
||
72 | 'дождь', |
||
73 | 'заместитель', |
||
74 | 'зверь', |
||
75 | 'любитель', |
||
76 | 'камень', |
||
77 | 'конь', |
||
78 | 'конь', |
||
79 | 'корень', |
||
80 | 'лось', |
||
81 | 'медведь', |
||
82 | 'модуль', |
||
83 | 'олень', |
||
84 | 'парень', |
||
85 | 'пекарь', |
||
86 | 'пельмень', |
||
87 | 'пень', |
||
88 | 'председатель', |
||
89 | 'представитель', |
||
90 | 'преподаватель', |
||
91 | 'продавец', |
||
92 | 'производитель', |
||
93 | 'путь', |
||
94 | 'рояль', |
||
95 | 'рубль', |
||
96 | 'руководитель', |
||
97 | 'секретарь', |
||
98 | 'слесарь', |
||
99 | 'строитель', |
||
100 | 'табель', |
||
101 | 'токарь', |
||
102 | 'трутень', |
||
103 | 'тюлень', |
||
104 | 'учитель', |
||
105 | 'циркуль', |
||
106 | 'шампунь', |
||
107 | 'шкворень', |
||
108 | 'юань', |
||
109 | 'ячмень', |
||
110 | ]; |
||
111 | |||
112 | /** @var string[] */ |
||
113 | public static $runawayVowelsExceptions = [ |
||
114 | 'глото*к', |
||
115 | 'де*нь', |
||
116 | 'каме*нь', |
||
117 | 'коре*нь', |
||
118 | 'паре*нь', |
||
119 | 'пе*нь', |
||
120 | 'песе*ц', |
||
121 | 'писе*ц', |
||
122 | 'санузе*л', |
||
123 | 'труте*нь', |
||
124 | ]; |
||
125 | |||
126 | /** |
||
127 | * Проверка, изменяемое ли слово. |
||
128 | * @param string $word Слово для проверки |
||
129 | * @param bool $animateness Признак одушевленности |
||
130 | * @return bool |
||
131 | */ |
||
132 | 43 | public static function isMutable($word, $animateness = false) |
|
140 | |||
141 | /** |
||
142 | * Определение рода существительного. |
||
143 | * @param string $word |
||
144 | * @return string |
||
145 | */ |
||
146 | 8 | public static function detectGender($word) |
|
160 | |||
161 | /** |
||
162 | * Определение склонения (по школьной программе) существительного. |
||
163 | * @param string $word |
||
164 | * @param bool $animateness |
||
165 | * @return int |
||
166 | */ |
||
167 | 207 | public static function getDeclension($word, $animateness = false) |
|
185 | |||
186 | /** |
||
187 | * Получение слова во всех 6 падежах. |
||
188 | * @param string $word |
||
189 | * @param bool $animateness Признак одушевлённости |
||
190 | * @return string[] |
||
191 | * @phpstan-return array<string, string> |
||
192 | */ |
||
193 | 112 | public static function getCases($word, $animateness = false) |
|
241 | |||
242 | /** |
||
243 | * Получение всех форм слова первого склонения. |
||
244 | * @param string $word |
||
245 | * @return string[] |
||
246 | * @phpstan-return array<string, string> |
||
247 | */ |
||
248 | 25 | public static function declinateFirstDeclension($word) |
|
283 | |||
284 | /** |
||
285 | * Получение всех форм слова второго склонения. |
||
286 | * @param string $word |
||
287 | * @param bool $animateness |
||
288 | * @return string[] |
||
289 | * @phpstan-return array<string, string> |
||
290 | */ |
||
291 | 71 | public static function declinateSecondDeclension($word, $animateness = false) |
|
345 | |||
346 | /** |
||
347 | * Получение всех форм слова третьего склонения. |
||
348 | * @param string $word |
||
349 | * @return string[] |
||
350 | * @phpstan-return array<string, string> |
||
351 | */ |
||
352 | 4 | public static function declinateThirdDeclension($word) |
|
365 | |||
366 | /** |
||
367 | * Склонение существительных, образованных от прилагательных и причастий. |
||
368 | * Rules are from http://rusgram.narod.ru/1216-1231.html |
||
369 | * @param string $word |
||
370 | * @param bool $animateness |
||
371 | * @return string[] |
||
372 | * @phpstan-return array<string, string> |
||
373 | */ |
||
374 | 8 | public static function declinateAdjective($word, $animateness) |
|
429 | |||
430 | /** |
||
431 | * Получение одной формы слова (падежа). |
||
432 | * @param string $word Слово |
||
433 | * @param string $case Падеж |
||
434 | * @param bool $animateness Признак одушевленности |
||
435 | * @return string |
||
436 | * @throws \Exception |
||
437 | */ |
||
438 | 43 | public static function getCase($word, $case, $animateness = false) |
|
444 | |||
445 | /** |
||
446 | * @param string $word |
||
447 | * @param string $last |
||
448 | * @return string |
||
449 | */ |
||
450 | 107 | public static function getPrefixOfSecondDeclension($word, $last) |
|
474 | |||
475 | /** |
||
476 | * @param string $word |
||
477 | * @param string $last |
||
478 | * @param string $prefix |
||
479 | * @return string |
||
480 | */ |
||
481 | 94 | public static function getPredCaseOf12Declensions($word, $last, $prefix) |
|
493 | |||
494 | /** |
||
495 | * @return int[]|false[] |
||
496 | */ |
||
497 | 107 | View Code Duplication | public static function getRunAwayVowelsList() |
505 | } |
||
506 |
This check looks from parameters that have been defined for a function or method, but which are not used in the method body.