Complex classes like Date 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 Date, and based on these observations, apply Extract Interface, too.
1 | <?php |
||
17 | class Date extends \DateTime implements \BFWInterface\IDate |
||
18 | { |
||
19 | /** |
||
20 | * @var \BFW\Kernel $_kernel L'instance du Kernel |
||
21 | */ |
||
22 | protected $_kernel; |
||
23 | |||
24 | /** |
||
25 | * @var string $date La date au format string |
||
26 | */ |
||
27 | protected $date = ''; |
||
28 | |||
29 | /** |
||
30 | * @var string $annee L'année de la date |
||
31 | */ |
||
32 | protected $annee = ''; |
||
33 | |||
34 | /** |
||
35 | * @var string $mois Le mois de la date |
||
36 | */ |
||
37 | protected $mois = ''; |
||
38 | |||
39 | /** |
||
40 | * @var string $jour Le jour de la date |
||
41 | */ |
||
42 | protected $jour = ''; |
||
43 | |||
44 | /** |
||
45 | * @var string $heure L'heure de la date |
||
46 | */ |
||
47 | protected $heure = ''; |
||
48 | |||
49 | /** |
||
50 | * @var string $minute Les minutes de la date |
||
51 | */ |
||
52 | protected $minute = ''; |
||
53 | |||
54 | /** |
||
55 | * @var string $seconde Les secondes de la date |
||
56 | */ |
||
57 | protected $seconde = ''; |
||
58 | |||
59 | /** |
||
60 | * @var string $zone Le timezone à utiliser |
||
61 | */ |
||
62 | protected $zone; |
||
63 | |||
64 | /** |
||
65 | * Accesseur vers l'attribut $date |
||
66 | */ |
||
67 | public function getDate() |
||
68 | { |
||
69 | 1 | return $this->date; |
|
70 | } |
||
71 | |||
72 | /** |
||
73 | * Accesseur vers l'attribut $annee |
||
74 | * |
||
75 | * @return string |
||
76 | */ |
||
77 | public function getAnnee() |
||
78 | { |
||
79 | 1 | return $this->annee; |
|
80 | } |
||
81 | |||
82 | /** |
||
83 | * Accesseur vers l'attribut $mois |
||
84 | * |
||
85 | * @return string |
||
86 | */ |
||
87 | public function getMois() |
||
88 | { |
||
89 | 1 | return $this->mois; |
|
90 | } |
||
91 | |||
92 | /** |
||
93 | * Accesseur vers l'attribut $jour |
||
94 | * |
||
95 | * @return string |
||
96 | */ |
||
97 | public function getJour() |
||
98 | { |
||
99 | 1 | return $this->jour; |
|
100 | } |
||
101 | |||
102 | /** |
||
103 | * Accesseur vers l'attribut $heure |
||
104 | * |
||
105 | * @return string |
||
106 | */ |
||
107 | public function getHeure() |
||
108 | { |
||
109 | 1 | return $this->heure; |
|
110 | } |
||
111 | |||
112 | /** |
||
113 | * Accesseur vers l'attribut $minute |
||
114 | * |
||
115 | * @return string |
||
116 | */ |
||
117 | public function getMinute() |
||
118 | { |
||
119 | 1 | return $this->minute; |
|
120 | } |
||
121 | |||
122 | /** |
||
123 | * Accesseur vers l'attribut $seconde |
||
124 | * |
||
125 | * @return string |
||
126 | */ |
||
127 | public function getSeconde() |
||
128 | { |
||
129 | 1 | return $this->seconde; |
|
130 | } |
||
131 | |||
132 | /** |
||
133 | * Accesseur vers l'attribut $zone |
||
134 | * |
||
135 | * @return string |
||
136 | */ |
||
137 | public function getZone() |
||
138 | { |
||
139 | 1 | return $this->zone; |
|
140 | } |
||
141 | |||
142 | /** |
||
143 | * Constructeur |
||
144 | * La date dans un format précis (aaaa-mm-jj hh:mm:ss+OO:OO) |
||
145 | * S'il n'y a pas ":00" à la fin, alors c'est géré. |
||
146 | * |
||
147 | * @param string $date (default: "now") La date sur laquelle travailler. Si pas indiqué, il s'agit de la date actuelle. |
||
148 | */ |
||
149 | public function __construct($date="now") |
||
173 | |||
174 | /** |
||
175 | * Initialise les attributs avec leurs valeurs respectives. La méthode est appelé dans le constructeur |
||
176 | */ |
||
177 | final private function MAJ_Attributes() |
||
189 | |||
190 | /** |
||
191 | * Modifie une données de la date |
||
192 | * |
||
193 | * @param string $cond La partie à modifier : year, mouth, day, jour, minute, second |
||
194 | * |
||
195 | * @throws \Exception : Si le paramètre pour modifier n'est pas géré |
||
196 | * |
||
197 | * @return \BFW\Date : Retourne l'objet si la modification à réussi. |
||
198 | */ |
||
199 | public function modify($cond) |
||
200 | { |
||
201 | //Date actuel |
||
202 | 1 | $dateOri = parent::format('Y-m-d H:i:s'); |
|
203 | |||
204 | //On tente la modif avec le paramètre de la fonction |
||
205 | 1 | $mod = @parent::modify($cond); //@ pour éviter une erreur car on permet d'autres format |
|
206 | 1 | $dateMod = parent::format('Y-m-d H:i:s'); |
|
207 | |||
208 | //Si la modif à marcher direct, on met à jour et on sort. |
||
209 | 1 | if(!($dateOri == $dateMod || $mod == false)) |
|
210 | 1 | { |
|
211 | 1 | $this->MAJ_Attributes(); |
|
212 | 1 | return $this; |
|
213 | } |
||
214 | |||
215 | 1 | $match = array(); |
|
216 | //Regex sur le paramètre pour récupéré le type de modification |
||
217 | 1 | preg_match('#(\+|\-)([0-9]+) ([a-z]+)#i', $cond, $match); |
|
218 | 1 | $match[3] = strtolower($match[3]); |
|
219 | |||
220 | //Liste des possibilités qu'on permet |
||
221 | $search = array( |
||
222 | 1 | 'an', 'ans', |
|
223 | 1 | 'mois', |
|
224 | 1 | 'jour', 'jours', |
|
225 | 1 | 'heure', 'heures', |
|
226 | 1 | 'minutes', |
|
227 | 1 | 'seconde', 'secondes' |
|
228 | 1 | ); |
|
229 | |||
230 | //Liste des équivalent pour la fonction modify de DateTime |
||
231 | $replace = array( |
||
232 | 1 | 'year', 'year', |
|
233 | 1 | 'month', |
|
234 | 1 | 'day', 'day', |
|
235 | 1 | 'hour', 'hour', |
|
236 | 1 | 'minute', |
|
237 | 1 | 'second', 'second' |
|
238 | 1 | ); |
|
239 | |||
240 | //On remplace le type de modification par sa valeur pour DateTime |
||
241 | 1 | $real = str_replace($search, $replace, $match[3]); |
|
242 | |||
243 | //Et on retente la modif |
||
244 | 1 | $mod2 = @parent::modify($match[1].$match[2].' '.$real); |
|
245 | 1 | $dateMod2 = parent::format('Y-m-d H:i:s'); |
|
246 | |||
247 | //Si la modif à fail : création d'une exception |
||
248 | 1 | if($dateOri == $dateMod2 || $mod2 == false) |
|
249 | 1 | { |
|
250 | 1 | throw new Exception('Parameter '.$match[3].' is unknown.'); |
|
251 | } |
||
252 | |||
253 | //Maj des attributs et retourne l'instance courante. |
||
254 | 1 | $this->MAJ_Attributes(); |
|
255 | 1 | return $this; |
|
256 | } |
||
257 | |||
258 | /** |
||
259 | * Renvoi au format pour SQL (postgresql) via un array |
||
260 | * |
||
261 | * @param bool $decoupe (default: false) Indique si on veux retourner un string ayant tout, ou un array ayant la date et l'heure séparé |
||
262 | * |
||
263 | * @return string|array Le format pour SQL |
||
264 | * Si string : aaaa-mm-jj hh:mm:ss |
||
265 | * Si array : [0]=>partie date (aaaa-mm-jj), [1]=>partie heure (hh:mm:ss) |
||
266 | */ |
||
267 | public function getSql($decoupe=false) |
||
268 | { |
||
269 | 1 | $dateSql = new \DateTime($this->date, new \DateTimeZone(self::ZONE_DEFAULT)); |
|
270 | 1 | $date = $dateSql->format('Y-m-d'); |
|
271 | 1 | $heure = $dateSql->format('H:i:s'); |
|
272 | |||
273 | 1 | if($decoupe) {return array($date, $heure);} |
|
274 | |||
275 | 1 | return $date.' '.$heure; |
|
276 | } |
||
277 | |||
278 | /** |
||
279 | * Modifie le timezone |
||
280 | * |
||
281 | * @param string $NewZone le nouveau time zone |
||
282 | */ |
||
283 | public function setZone($NewZone) |
||
287 | |||
288 | /** |
||
289 | * Liste tous les timezone qui existe |
||
290 | * |
||
291 | * @return array La liste des timezone possible |
||
292 | */ |
||
293 | public function lst_TimeZone() |
||
294 | { |
||
295 | 1 | $TimeZone = parent::getTimezone(); |
|
296 | 1 | return $TimeZone->listIdentifiers(); |
|
297 | } |
||
298 | |||
299 | /** |
||
300 | * Liste les continents possible pour les timezones |
||
301 | * |
||
302 | * @return string[] La liste des continents |
||
303 | */ |
||
304 | public function lst_TimeZoneContinent() |
||
321 | |||
322 | /** |
||
323 | * Liste des pays possible pour un continent donné |
||
324 | * |
||
325 | * @param string $continent Le continent dans lequel on veux la liste des pays |
||
326 | * |
||
327 | * @return array La liste des pays pour le continent donné |
||
328 | */ |
||
329 | public function lst_TimeZonePays($continent) |
||
346 | |||
347 | /** |
||
348 | * Transforme la date en un format plus facilement lisible. |
||
349 | * |
||
350 | * Paramètre en entrée |
||
351 | * $tout : |
||
352 | * 1 : On affiche la date en entier (jour et heure) |
||
353 | * 0 : On affiche que le jour |
||
354 | * $minus : |
||
355 | * 1 : On affiche le texte en minuscule (hier, le) |
||
356 | * 0 : On affiche le texte en normal (Hier, Le) |
||
357 | * |
||
358 | * possibilitées en sortie : |
||
359 | * |
||
360 | * $tout == 1 |
||
361 | * Il y 1s |
||
362 | * Il y 1min |
||
363 | * Il y 1h |
||
364 | * Hier à 00:00 |
||
365 | * Le 00/00 à 00:00 |
||
366 | * Le 00/00/0000 à 00:00 (si l'année n'est pas la même) |
||
367 | * |
||
368 | * $tout == 0 |
||
369 | * Il y 1s |
||
370 | * Il y 1min |
||
371 | * Il y 1h |
||
372 | * Hier |
||
373 | * Le 00/00 |
||
374 | * Le 00/00/0000 (si l'année n'est pas la même) |
||
375 | * |
||
376 | * Ou "Maintenant" (qu'importe la valeur de $tout) |
||
377 | * |
||
378 | * @param bool $tout (default: true) Affiche la date en entier (true) ou non (false). |
||
379 | * @param bool $minus (default: false) Affiche la date en minuscule (true) ou non (false). |
||
380 | * |
||
381 | * @return string La date simplifié |
||
382 | */ |
||
383 | public function aff_simple($tout=true, $minus=false) |
||
474 | } |
||
475 |
This check looks for a call to a parent method whose name is different than the method from which it is called.
Consider the following code:
The
getFirstName()
method in theSon
calls the wrong method in the parent class.