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 CsvExportService 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 CsvExportService, and based on these observations, apply Extract Interface, too.
1 | <?php |
||
33 | class CsvExportService |
||
|
|||
34 | { |
||
35 | /** |
||
36 | * @var |
||
37 | */ |
||
38 | protected $fp; |
||
39 | |||
40 | /** |
||
41 | * @var |
||
42 | */ |
||
43 | protected $closed = false; |
||
44 | |||
45 | /** |
||
46 | * @var \Closure |
||
47 | */ |
||
48 | protected $convertEncodingCallBack; |
||
49 | |||
50 | /** |
||
51 | * @var \Doctrine\ORM\EntityManager |
||
52 | */ |
||
53 | protected $em; |
||
54 | |||
55 | /** |
||
56 | * @var \Doctrine\ORM\QueryBuilder; |
||
57 | */ |
||
58 | protected $qb; |
||
59 | |||
60 | /** |
||
61 | * @var array |
||
62 | */ |
||
63 | protected $config; |
||
64 | |||
65 | /** |
||
66 | * @var \Eccube\Entity\Master\CsvType |
||
67 | */ |
||
68 | protected $CsvType; |
||
69 | |||
70 | /** |
||
71 | * @var \Eccube\Entity\Csv[] |
||
72 | */ |
||
73 | protected $Csvs; |
||
74 | |||
75 | /** |
||
76 | * @var \Eccube\Repository\CsvRepository |
||
77 | */ |
||
78 | protected $csvRepository; |
||
79 | |||
80 | /** |
||
81 | * @var \Eccube\Repository\Master\CsvTypeRepository |
||
82 | */ |
||
83 | protected $csvTypeRepository; |
||
84 | |||
85 | /** |
||
86 | * @var \Eccube\Repository\OrderRepository |
||
87 | */ |
||
88 | protected $orderRepository; |
||
89 | |||
90 | /** |
||
91 | * @var \Eccube\Repository\CustomerRepository |
||
92 | */ |
||
93 | protected $customerRepository; |
||
94 | |||
95 | /** |
||
96 | * @var \Eccube\Repository\ProductRepository |
||
97 | */ |
||
98 | protected $productRepository; |
||
99 | |||
100 | /** |
||
101 | * @param $config |
||
102 | */ |
||
103 | 1 | public function setConfig($config) |
|
104 | { |
||
105 | 1 | $this->config = $config; |
|
106 | 1 | } |
|
107 | |||
108 | /** |
||
109 | * @param \Eccube\Repository\CsvRepository $csvRepository |
||
110 | */ |
||
111 | 1 | public function setCsvRepository(\Eccube\Repository\CsvRepository $csvRepository) |
|
112 | { |
||
113 | 1 | $this->csvRepository = $csvRepository; |
|
114 | } |
||
115 | |||
116 | /** |
||
117 | * @param \Eccube\Repository\Master\CsvTypeRepository $csvTypeRepository |
||
118 | */ |
||
119 | 1 | public function setCsvTypeRepository(\Eccube\Repository\Master\CsvTypeRepository $csvTypeRepository) |
|
120 | { |
||
121 | 1 | $this->csvTypeRepository = $csvTypeRepository; |
|
122 | } |
||
123 | |||
124 | /** |
||
125 | * @param \Eccube\Repository\OrderRepository $orderRepository |
||
126 | */ |
||
127 | 1 | public function setOrderRepository(\Eccube\Repository\OrderRepository $orderRepository) |
|
128 | { |
||
129 | 1 | $this->orderRepository = $orderRepository; |
|
130 | } |
||
131 | |||
132 | /** |
||
133 | * @param \Eccube\Repository\CustomerRepository $customerRepository |
||
134 | */ |
||
135 | 1 | public function setCustomerRepository(\Eccube\Repository\CustomerRepository $customerRepository) |
|
136 | { |
||
137 | 1 | $this->customerRepository = $customerRepository; |
|
138 | } |
||
139 | |||
140 | /** |
||
141 | * @param \Eccube\Repository\ProductRepository $productRepository |
||
142 | */ |
||
143 | 1 | public function setProductRepository(\Eccube\Repository\ProductRepository $productRepository) |
|
144 | { |
||
145 | 1 | $this->productRepository = $productRepository; |
|
146 | } |
||
147 | |||
148 | /** |
||
149 | * @param \Doctrine\ORM\EntityManager $em |
||
150 | */ |
||
151 | 1 | public function setEntityManager(\Doctrine\ORM\EntityManager $em) |
|
152 | { |
||
153 | 1 | $this->em = $em; |
|
154 | } |
||
155 | |||
156 | /** |
||
157 | * @return \Doctrine\ORM\EntityManager |
||
158 | */ |
||
159 | public function getEntityManager() |
||
160 | { |
||
161 | return $this->em; |
||
162 | } |
||
163 | |||
164 | /** |
||
165 | * @param \Doctrine\ORM\QueryBuilder $qb |
||
166 | */ |
||
167 | 1 | public function setExportQueryBuilder(\Doctrine\ORM\QueryBuilder $qb) |
|
168 | { |
||
169 | 1 | $this->qb = $qb; |
|
170 | } |
||
171 | |||
172 | /** |
||
173 | * Csv種別からServiceの初期化を行う. |
||
174 | * |
||
175 | * @param $CsvType|integer |
||
176 | */ |
||
177 | 1 | public function initCsvType($CsvType) |
|
194 | |||
195 | /** |
||
196 | * @return \Eccube\Entity\Csv[] |
||
197 | */ |
||
198 | public function getCsvs() |
||
199 | { |
||
200 | return $this->Csvs; |
||
201 | } |
||
202 | |||
203 | /** |
||
204 | * ヘッダ行を出力する. |
||
205 | * このメソッドを使う場合は, 事前にinitCsvType($CsvType)で初期化しておく必要がある. |
||
206 | */ |
||
207 | public function exportHeader() |
||
208 | { |
||
209 | if (is_null($this->CsvType) || is_null($this->Csvs)) { |
||
210 | throw new \LogicException('init csv type incomplete.'); |
||
211 | } |
||
212 | |||
213 | $row = array(); |
||
214 | foreach ($this->Csvs as $Csv) { |
||
215 | $row[] = $Csv->getDispName(); |
||
216 | } |
||
217 | |||
218 | $this->fopen(); |
||
219 | $this->fputcsv($row); |
||
220 | $this->fclose(); |
||
221 | } |
||
222 | |||
223 | /** |
||
224 | * クエリビルダにもとづいてデータ行を出力する. |
||
225 | * このメソッドを使う場合は, 事前にsetExportQueryBuilder($qb)で出力対象のクエリビルダをわたしておく必要がある. |
||
226 | * |
||
227 | * @param \Closure $closure |
||
228 | */ |
||
229 | 1 | public function exportData(\Closure $closure) |
|
230 | { |
||
231 | if (is_null($this->qb) || is_null($this->em)) { |
||
232 | throw new \LogicException('query builder not set.'); |
||
233 | } |
||
234 | |||
235 | $this->fopen(); |
||
236 | |||
237 | $query = $this->qb->getQuery(); |
||
238 | 1 | foreach ($query->getResult() as $iteratableResult) { |
|
239 | $closure($iteratableResult, $this); |
||
240 | $this->em->detach($iteratableResult); |
||
241 | $this->em->clear(); |
||
242 | $query->free(); |
||
243 | flush(); |
||
244 | } |
||
245 | |||
246 | $this->fclose(); |
||
247 | } |
||
248 | |||
249 | /** |
||
250 | * CSV出力項目と比較し, 合致するデータを返す. |
||
251 | * |
||
252 | * @param \Eccube\Entity\Csv $Csv |
||
253 | * @param $entity |
||
254 | * @return mixed|null|string|void |
||
255 | */ |
||
256 | public function getData(\Eccube\Entity\Csv $Csv, $entity) |
||
257 | { |
||
258 | // エンティティ名が一致するかどうかチェック. |
||
259 | $csvEntityName = str_replace('\\\\', '\\', $Csv->getEntityName()); |
||
260 | $entityName = str_replace('\\\\', '\\', get_class($entity)); |
||
261 | if ($csvEntityName !== $entityName) { |
||
262 | $entityName = str_replace('DoctrineProxy\\__CG__\\', '', $entityName); |
||
263 | if ($csvEntityName !== $entityName) { |
||
264 | return null; |
||
265 | } |
||
266 | } |
||
267 | |||
268 | // カラム名がエンティティに存在するかどうかをチェック. |
||
269 | if (!$entity->offsetExists($Csv->getFieldName())) { |
||
270 | return null; |
||
271 | } |
||
272 | |||
273 | // データを取得. |
||
274 | $data = $entity->offsetGet($Csv->getFieldName()); |
||
275 | |||
276 | // one to one の場合は, dtb_csv.referece_field_nameと比較し, 合致する結果を取得する. |
||
277 | if ($data instanceof \Eccube\Entity\AbstractEntity) { |
||
278 | if (EntityUtil::isNotEmpty($data)) { |
||
279 | return $data->offsetGet($Csv->getReferenceFieldName()); |
||
280 | } |
||
281 | } elseif ($data instanceof \Doctrine\Common\Collections\Collection) { |
||
282 | // one to manyの場合は, カンマ区切りに変換する. |
||
283 | $array = array(); |
||
284 | foreach ($data as $elem) { |
||
285 | if (EntityUtil::isNotEmpty($elem)) { |
||
286 | $array[] = $elem->offsetGet($Csv->getReferenceFieldName()); |
||
287 | } |
||
288 | } |
||
289 | return implode($this->config['csv_export_multidata_separator'], $array); |
||
290 | |||
291 | } elseif ($data instanceof \DateTime) { |
||
292 | // datetimeの場合は文字列に変換する. |
||
293 | return $data->format($this->config['csv_export_date_format']); |
||
294 | |||
295 | } else { |
||
296 | // スカラ値の場合はそのまま. |
||
297 | return $data; |
||
298 | } |
||
299 | |||
300 | return null; |
||
301 | } |
||
302 | |||
303 | /** |
||
304 | * 文字エンコーディングの変換を行うコールバック関数を返す. |
||
305 | * |
||
306 | * @return \Closure |
||
307 | */ |
||
308 | 1 | public function getConvertEncodhingCallback() |
|
309 | { |
||
310 | 1 | $config = $this->config; |
|
311 | |||
312 | return function ($value) use ($config) { |
||
313 | return mb_convert_encoding( |
||
314 | (string) $value, $config['csv_export_encoding'], 'UTF-8' |
||
315 | ); |
||
316 | 1 | }; |
|
317 | } |
||
318 | |||
319 | /** |
||
320 | * |
||
321 | */ |
||
322 | 1 | public function fopen() |
|
323 | { |
||
324 | if (is_null($this->fp) || $this->closed) { |
||
325 | $this->fp = fopen('php://output', 'w'); |
||
326 | } |
||
327 | 1 | } |
|
328 | |||
329 | /** |
||
330 | * @param $row |
||
331 | * @param null $callback |
||
332 | */ |
||
333 | public function fputcsv($row) |
||
334 | { |
||
335 | if (is_null($this->convertEncodingCallBack)) { |
||
336 | $this->convertEncodingCallBack = $this->getConvertEncodhingCallback(); |
||
337 | } |
||
338 | |||
339 | fputcsv($this->fp, array_map($this->convertEncodingCallBack, $row), $this->config['csv_export_separator']); |
||
340 | } |
||
341 | |||
342 | /** |
||
343 | * |
||
344 | */ |
||
345 | 1 | public function fclose() |
|
346 | { |
||
347 | 1 | if (!$this->closed) { |
|
348 | fclose($this->fp); |
||
349 | 1 | $this->closed = true; |
|
350 | } |
||
351 | 1 | } |
|
352 | |||
353 | /** |
||
354 | * 受注検索用のクエリビルダを返す. |
||
355 | * |
||
356 | * @param Request $request |
||
357 | * @return \Doctrine\ORM\QueryBuilder |
||
358 | */ |
||
359 | View Code Duplication | public function getOrderQueryBuilder(Request $request) |
|
360 | { |
||
361 | $session = $request->getSession(); |
||
362 | if ($session->has('eccube.admin.order.search')) { |
||
363 | $searchData = $session->get('eccube.admin.order.search'); |
||
364 | $this->findDeserializeObjects($searchData); |
||
365 | } else { |
||
366 | $searchData = array(); |
||
367 | } |
||
368 | |||
369 | // 受注データのクエリビルダを構築. |
||
370 | $qb = $this->orderRepository |
||
371 | ->getQueryBuilderBySearchDataForAdmin($searchData); |
||
372 | |||
373 | return $qb; |
||
374 | } |
||
375 | |||
376 | /** |
||
377 | * 会員検索用のクエリビルダを返す. |
||
378 | * |
||
379 | * @param Request $request |
||
380 | * @return \Doctrine\ORM\QueryBuilder |
||
381 | */ |
||
382 | View Code Duplication | public function getCustomerQueryBuilder(Request $request) |
|
383 | { |
||
384 | $session = $request->getSession(); |
||
385 | if ($session->has('eccube.admin.customer.search')) { |
||
386 | $searchData = $session->get('eccube.admin.customer.search'); |
||
387 | $this->findDeserializeObjects($searchData); |
||
388 | } else { |
||
389 | $searchData = array(); |
||
390 | } |
||
391 | |||
392 | // 会員データのクエリビルダを構築. |
||
393 | $qb = $this->customerRepository |
||
394 | ->getQueryBuilderBySearchData($searchData); |
||
395 | |||
396 | return $qb; |
||
397 | } |
||
398 | |||
399 | /** |
||
400 | * 商品検索用のクエリビルダを返す. |
||
401 | * |
||
402 | * @param Request $request |
||
403 | * @return \Doctrine\ORM\QueryBuilder |
||
404 | */ |
||
405 | View Code Duplication | public function getProductQueryBuilder(Request $request) |
|
421 | |||
422 | /** |
||
423 | * セッションでシリアライズされた Doctrine のオブジェクトを取得し直す. |
||
424 | * |
||
425 | * XXX self::setExportQueryBuilder() をコールする前に EntityManager を取得したいので、引数で渡している |
||
426 | * |
||
427 | * @param array $searchData セッションから取得した検索条件の配列 |
||
428 | * @param EntityManager $em |
||
429 | */ |
||
430 | protected function findDeserializeObjects(array &$searchData) |
||
447 | } |
||
448 |