Complex classes like BunchSubject 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 BunchSubject, and based on these observations, apply Extract Interface, too.
1 | <?php |
||
38 | class BunchSubject extends AbstractProductSubject |
||
39 | { |
||
40 | |||
41 | /** |
||
42 | * The mapping for the supported backend types (for the product entity) => persist methods. |
||
43 | * |
||
44 | * @var array |
||
45 | */ |
||
46 | protected $backendTypes = array( |
||
47 | 'datetime' => array('persistProductDatetimeAttribute', 'loadProductDatetimeAttribute'), |
||
48 | 'decimal' => array('persistProductDecimalAttribute', 'loadProductDecimalAttribute'), |
||
49 | 'int' => array('persistProductIntAttribute', 'loadProductIntAttribute'), |
||
50 | 'text' => array('persistProductTextAttribute', 'loadProductTextAttribute'), |
||
51 | 'varchar' => array('persistProductVarcharAttribute', 'loadProductVarcharAttribute') |
||
52 | ); |
||
53 | |||
54 | /** |
||
55 | * Mappings for attribute code => CSV column header. |
||
56 | * |
||
57 | * @var array |
||
58 | */ |
||
59 | protected $headerMappings = array( |
||
60 | 'status' => 'product_online', |
||
61 | 'tax_class_id' => 'tax_class_name', |
||
62 | 'price_type' => 'bundle_price_type', |
||
63 | 'sku_type' => 'bundle_sku_type', |
||
64 | 'price_view' => 'bundle_price_view', |
||
65 | 'weight_type' => 'bundle_weight_type', |
||
66 | 'image' => 'base_image', |
||
67 | 'image_label' => 'base_image_label', |
||
68 | 'thumbnail' => 'thumbnail_image', |
||
69 | 'thumbnail_label' => 'thumbnail_image_label', |
||
70 | 'shipment_type' => 'bundle_shipment_type' |
||
71 | ); |
||
72 | |||
73 | /** |
||
74 | * Mappings for the table column => CSV column header. |
||
75 | * |
||
76 | * @var array |
||
77 | */ |
||
78 | protected $headerStockMappings = array( |
||
79 | 'qty' => array('qty', 'float'), |
||
80 | 'min_qty' => array('out_of_stock_qty', 'float'), |
||
81 | 'use_config_min_qty' => array('use_config_min_qty', 'int'), |
||
82 | 'is_qty_decimal' => array('is_qty_decimal', 'int'), |
||
83 | 'backorders' => array('allow_backorders', 'int'), |
||
84 | 'use_config_backorders' => array('use_config_backorders', 'int'), |
||
85 | 'min_sale_qty' => array('min_cart_qty', 'float'), |
||
86 | 'use_config_min_sale_qty' => array('use_config_min_sale_qty', 'int'), |
||
87 | 'max_sale_qty' => array('max_cart_qty', 'float'), |
||
88 | 'use_config_max_sale_qty' => array('use_config_max_sale_qty', 'int'), |
||
89 | 'is_in_stock' => array('is_in_stock', 'int'), |
||
90 | 'notify_stock_qty' => array('notify_on_stock_below', 'float'), |
||
91 | 'use_config_notify_stock_qty' => array('use_config_notify_stock_qty', 'int'), |
||
92 | 'manage_stock' => array('manage_stock', 'int'), |
||
93 | 'use_config_manage_stock' => array('use_config_manage_stock', 'int'), |
||
94 | 'use_config_qty_increments' => array('use_config_qty_increments', 'int'), |
||
95 | 'qty_increments' => array('qty_increments', 'float'), |
||
96 | 'use_config_enable_qty_inc' => array('use_config_enable_qty_inc', 'int'), |
||
97 | 'enable_qty_increments' => array('enable_qty_increments', 'int'), |
||
98 | 'is_decimal_divided' => array('is_decimal_divided', 'int'), |
||
99 | ); |
||
100 | |||
101 | /** |
||
102 | * The array with the available visibility keys. |
||
103 | * |
||
104 | * @var array |
||
105 | */ |
||
106 | protected $availableVisibilities = array( |
||
107 | 'Not Visible Individually' => VisibilityKeys::VISIBILITY_NOT_VISIBLE, |
||
108 | 'Catalog' => VisibilityKeys::VISIBILITY_IN_CATALOG, |
||
109 | 'Search' => VisibilityKeys::VISIBILITY_IN_SEARCH, |
||
110 | 'Catalog, Search' => VisibilityKeys::VISIBILITY_BOTH |
||
111 | ); |
||
112 | |||
113 | /** |
||
114 | * The attribute set of the product that has to be created. |
||
115 | * |
||
116 | * @var array |
||
117 | */ |
||
118 | protected $attributeSet = array(); |
||
119 | |||
120 | /** |
||
121 | * The array containing the data for product type configuration (configurables, bundles, etc). |
||
122 | * |
||
123 | * @var array |
||
124 | */ |
||
125 | protected $artefacs = array(); |
||
126 | |||
127 | /** |
||
128 | * The mapping for the SKUs to the created entity IDs. |
||
129 | * |
||
130 | * @var array |
||
131 | */ |
||
132 | protected $skuEntityIdMapping = array(); |
||
133 | |||
134 | /** |
||
135 | * The category IDs the product is related with. |
||
136 | * |
||
137 | * @var array |
||
138 | */ |
||
139 | protected $productCategoryIds = array(); |
||
140 | |||
141 | /** |
||
142 | * Set's the attribute set of the product that has to be created. |
||
143 | * |
||
144 | * @param array $attributeSet The attribute set |
||
145 | * |
||
146 | * @return void |
||
147 | */ |
||
148 | 1 | public function setAttributeSet(array $attributeSet) |
|
152 | |||
153 | /** |
||
154 | * Return's the attribute set of the product that has to be created. |
||
155 | * |
||
156 | * @return array The attribute set |
||
157 | */ |
||
158 | public function getAttributeSet() |
||
162 | |||
163 | /** |
||
164 | * Clean up the global data after importing the bunch. |
||
165 | * |
||
166 | * @return void |
||
167 | */ |
||
168 | public function tearDown() |
||
186 | |||
187 | /** |
||
188 | * Export's the artefacts to CSV files. |
||
189 | * |
||
190 | * @return void |
||
191 | */ |
||
192 | public function exportArtefacts() |
||
226 | |||
227 | /** |
||
228 | * Initialize and return the exporter configuration. |
||
229 | * |
||
230 | * @return \Goodby\CSV\Export\Standard\ExporterConfig The exporter configuration |
||
231 | */ |
||
232 | protected function getExportConfig() |
||
271 | |||
272 | /** |
||
273 | * Cast's the passed value based on the backend type information. |
||
274 | * |
||
275 | * @param string $backendType The backend type to cast to |
||
276 | * @param mixed $value The value to be casted |
||
277 | * |
||
278 | * @return mixed The casted value |
||
279 | */ |
||
280 | 1 | public function castValueByBackendType($backendType, $value) |
|
281 | { |
||
282 | |||
283 | // cast the value to a valid timestamp |
||
284 | 1 | if ($backendType === 'datetime') { |
|
285 | return \DateTime::createFromFormat($this->getSourceDateFormat(), $value)->format('Y-m-d H:i:s'); |
||
286 | } |
||
287 | |||
288 | // cast the value to a float value |
||
289 | 1 | if ($backendType === 'float') { |
|
290 | 1 | return (float) $value; |
|
291 | } |
||
292 | |||
293 | // cast the value to an integer |
||
294 | 1 | if ($backendType === 'int') { |
|
295 | 1 | return (int) $value; |
|
296 | } |
||
297 | |||
298 | // we don't need to cast strings |
||
299 | return $value; |
||
300 | } |
||
301 | |||
302 | /** |
||
303 | * Return's the mappings for the table column => CSV column header. |
||
304 | * |
||
305 | * @return array The header stock mappings |
||
306 | */ |
||
307 | 1 | public function getHeaderStockMappings() |
|
308 | { |
||
309 | 1 | return $this->headerStockMappings; |
|
310 | } |
||
311 | |||
312 | /** |
||
313 | * Return's mapping for the supported backend types (for the product entity) => persist methods. |
||
314 | * |
||
315 | * @return array The mapping for the supported backend types |
||
316 | */ |
||
317 | public function getBackendTypes() |
||
321 | |||
322 | /** |
||
323 | * Return's the artefacts for post-processing. |
||
324 | * |
||
325 | * @return array The artefacts |
||
326 | */ |
||
327 | public function getArtefacts() |
||
331 | |||
332 | /** |
||
333 | * Return's the visibility key for the passed visibility string. |
||
334 | * |
||
335 | * @param string $visibility The visibility string to return the key for |
||
336 | * |
||
337 | * @return integer The requested visibility key |
||
338 | * @throws \Exception Is thrown, if the requested visibility is not available |
||
339 | */ |
||
340 | public function getVisibilityIdByValue($visibility) |
||
351 | |||
352 | /** |
||
353 | * Map the passed attribute code, if a header mapping exists and return the |
||
354 | * mapped mapping. |
||
355 | * |
||
356 | * @param string $attributeCode The attribute code to map |
||
357 | * |
||
358 | * @return string The mapped attribute code, or the original one |
||
359 | */ |
||
360 | public function mapAttributeCodeByHeaderMapping($attributeCode) |
||
371 | |||
372 | /** |
||
373 | * Add the passed product type artefacts to the product with the |
||
374 | * last entity ID. |
||
375 | * |
||
376 | * @param string $type The artefact type, e. g. configurable |
||
377 | * @param array $artefacts The product type artefacts |
||
378 | * |
||
379 | * @return void |
||
380 | * @uses \TechDivision\Import\Product\Subjects\BunchSubject::getLastEntityId() |
||
381 | */ |
||
382 | public function addArtefacts($type, array $artefacts) |
||
393 | |||
394 | /** |
||
395 | * Add the passed SKU => entity ID mapping. |
||
396 | * |
||
397 | * @param string $sku The SKU |
||
398 | * |
||
399 | * @return void |
||
400 | * @uses \Import\Csv\Actions\ProductImportBunchAction::getLastEntityId() |
||
401 | */ |
||
402 | public function addSkuEntityIdMapping($sku) |
||
406 | |||
407 | /** |
||
408 | * Add the passed category ID to the product's category list. |
||
409 | * |
||
410 | * @param integer $categoryId The category ID to add |
||
411 | * |
||
412 | * @return void |
||
413 | */ |
||
414 | public function addProductCategoryId($categoryId) |
||
418 | |||
419 | /** |
||
420 | * Return's the list with category IDs the product is related with. |
||
421 | * |
||
422 | * @return array The product's category IDs |
||
423 | */ |
||
424 | public function getProductCategoryIds() |
||
438 | |||
439 | /** |
||
440 | * Return's the attribute option value with the passed value and store ID. |
||
441 | * |
||
442 | * @param mixed $value The option value |
||
443 | * @param integer $storeId The ID of the store |
||
444 | * |
||
445 | * @return array|boolean The attribute option value instance |
||
446 | */ |
||
447 | public function getEavAttributeOptionValueByOptionValueAndStoreId($value, $storeId) |
||
451 | |||
452 | /** |
||
453 | * Return's the URL rewrites for the passed URL entity type and ID. |
||
454 | * |
||
455 | * @param string $entityType The entity type to load the URL rewrites for |
||
456 | * @param integer $entityId The entity ID to laod the rewrites for |
||
457 | * |
||
458 | * @return array The URL rewrites |
||
459 | */ |
||
460 | 1 | public function getUrlRewritesByEntityTypeAndEntityId($entityType, $entityId) |
|
464 | |||
465 | /** |
||
466 | * Load's and return's the product with the passed SKU. |
||
467 | * |
||
468 | * @param string $sku The SKU of the product to load |
||
469 | * |
||
470 | * @return array The product |
||
471 | */ |
||
472 | public function loadProduct($sku) |
||
476 | |||
477 | /** |
||
478 | * Load's and return's the product website relation with the passed product and website ID. |
||
479 | * |
||
480 | * @param string $productId The product ID of the relation |
||
481 | * @param string $websiteId The website ID of the relation |
||
482 | * |
||
483 | * @return array The product website |
||
484 | */ |
||
485 | public function loadProductWebsite($productId, $websiteId) |
||
489 | |||
490 | /** |
||
491 | * Return's the category product relation with the passed category/product ID. |
||
492 | * |
||
493 | * @param integer $categoryId The category ID of the category product relation to return |
||
494 | * @param integer $productId The product ID of the category product relation to return |
||
495 | * |
||
496 | * @return array The category product relation |
||
497 | */ |
||
498 | public function loadCategoryProduct($categoryId, $productId) |
||
502 | |||
503 | /** |
||
504 | * Load's and return's the stock status with the passed product/website/stock ID. |
||
505 | * |
||
506 | * @param integer $productId The product ID of the stock status to load |
||
507 | * @param integer $websiteId The website ID of the stock status to load |
||
508 | * @param integer $stockId The stock ID of the stock status to load |
||
509 | * |
||
510 | * @return array The stock status |
||
511 | */ |
||
512 | public function loadStockStatus($productId, $websiteId, $stockId) |
||
516 | |||
517 | /** |
||
518 | * Load's and return's the stock status with the passed product/website/stock ID. |
||
519 | * |
||
520 | * @param integer $productId The product ID of the stock item to load |
||
521 | * @param integer $websiteId The website ID of the stock item to load |
||
522 | * @param integer $stockId The stock ID of the stock item to load |
||
523 | * |
||
524 | * @return array The stock item |
||
525 | */ |
||
526 | public function loadStockItem($productId, $websiteId, $stockId) |
||
530 | |||
531 | /** |
||
532 | * Load's and return's the datetime attribute with the passed entity/attribute/store ID. |
||
533 | * |
||
534 | * @param integer $entityId The entity ID of the attribute |
||
535 | * @param integer $attributeId The attribute ID of the attribute |
||
536 | * @param integer $storeId The store ID of the attribute |
||
537 | * |
||
538 | * @return array|null The datetime attribute |
||
539 | */ |
||
540 | public function loadProductDatetimeAttribute($entityId, $attributeId, $storeId) |
||
544 | |||
545 | /** |
||
546 | * Load's and return's the decimal attribute with the passed entity/attribute/store ID. |
||
547 | * |
||
548 | * @param integer $entityId The entity ID of the attribute |
||
549 | * @param integer $attributeId The attribute ID of the attribute |
||
550 | * @param integer $storeId The store ID of the attribute |
||
551 | * |
||
552 | * @return array|null The decimal attribute |
||
553 | */ |
||
554 | public function loadProductDecimalAttribute($entityId, $attributeId, $storeId) |
||
558 | |||
559 | /** |
||
560 | * Load's and return's the integer attribute with the passed entity/attribute/store ID. |
||
561 | * |
||
562 | * @param integer $entityId The entity ID of the attribute |
||
563 | * @param integer $attributeId The attribute ID of the attribute |
||
564 | * @param integer $storeId The store ID of the attribute |
||
565 | * |
||
566 | * @return array|null The integer attribute |
||
567 | */ |
||
568 | public function loadProductIntAttribute($entityId, $attributeId, $storeId) |
||
572 | |||
573 | /** |
||
574 | * Load's and return's the text attribute with the passed entity/attribute/store ID. |
||
575 | * |
||
576 | * @param integer $entityId The entity ID of the attribute |
||
577 | * @param integer $attributeId The attribute ID of the attribute |
||
578 | * @param integer $storeId The store ID of the attribute |
||
579 | * |
||
580 | * @return array|null The text attribute |
||
581 | */ |
||
582 | public function loadProductTextAttribute($entityId, $attributeId, $storeId) |
||
586 | |||
587 | /** |
||
588 | * Load's and return's the varchar attribute with the passed entity/attribute/store ID. |
||
589 | * |
||
590 | * @param integer $entityId The entity ID of the attribute |
||
591 | * @param integer $attributeId The attribute ID of the attribute |
||
592 | * @param integer $storeId The store ID of the attribute |
||
593 | * |
||
594 | * @return array|null The varchar attribute |
||
595 | */ |
||
596 | public function loadProductVarcharAttribute($entityId, $attributeId, $storeId) |
||
600 | |||
601 | /** |
||
602 | * Persist's the passed product data and return's the ID. |
||
603 | * |
||
604 | * @param array $product The product data to persist |
||
605 | * |
||
606 | * @return string The ID of the persisted entity |
||
607 | */ |
||
608 | public function persistProduct($product) |
||
612 | |||
613 | /** |
||
614 | * Persist's the passed product varchar attribute. |
||
615 | * |
||
616 | * @param array $attribute The attribute to persist |
||
617 | * |
||
618 | * @return void |
||
619 | */ |
||
620 | public function persistProductVarcharAttribute($attribute) |
||
624 | |||
625 | /** |
||
626 | * Persist's the passed product integer attribute. |
||
627 | * |
||
628 | * @param array $attribute The attribute to persist |
||
629 | * |
||
630 | * @return void |
||
631 | */ |
||
632 | public function persistProductIntAttribute($attribute) |
||
636 | |||
637 | /** |
||
638 | * Persist's the passed product decimal attribute. |
||
639 | * |
||
640 | * @param array $attribute The attribute to persist |
||
641 | * |
||
642 | * @return void |
||
643 | */ |
||
644 | public function persistProductDecimalAttribute($attribute) |
||
648 | |||
649 | /** |
||
650 | * Persist's the passed product datetime attribute. |
||
651 | * |
||
652 | * @param array $attribute The attribute to persist |
||
653 | * |
||
654 | * @return void |
||
655 | */ |
||
656 | public function persistProductDatetimeAttribute($attribute) |
||
660 | |||
661 | /** |
||
662 | * Persist's the passed product text attribute. |
||
663 | * |
||
664 | * @param array $attribute The attribute to persist |
||
665 | * |
||
666 | * @return void |
||
667 | */ |
||
668 | public function persistProductTextAttribute($attribute) |
||
672 | |||
673 | /** |
||
674 | * Persist's the passed product website data and return's the ID. |
||
675 | * |
||
676 | * @param array $productWebsite The product website data to persist |
||
677 | * |
||
678 | * @return void |
||
679 | */ |
||
680 | public function persistProductWebsite($productWebsite) |
||
684 | |||
685 | /** |
||
686 | * Persist's the passed category product relation. |
||
687 | * |
||
688 | * @param array $categoryProduct The category product relation to persist |
||
689 | * |
||
690 | * @return void |
||
691 | */ |
||
692 | public function persistCategoryProduct($categoryProduct) |
||
696 | |||
697 | /** |
||
698 | * Persist's the passed stock item data and return's the ID. |
||
699 | * |
||
700 | * @param array $stockItem The stock item data to persist |
||
701 | * |
||
702 | * @return void |
||
703 | */ |
||
704 | public function persistStockItem($stockItem) |
||
708 | |||
709 | /** |
||
710 | * Persist's the passed stock status data and return's the ID. |
||
711 | * |
||
712 | * @param array $stockStatus The stock status data to persist |
||
713 | * |
||
714 | * @return void |
||
715 | */ |
||
716 | public function persistStockStatus($stockStatus) |
||
720 | |||
721 | /** |
||
722 | * Persist's the URL write with the passed data. |
||
723 | * |
||
724 | * @param array $row The URL rewrite to persist |
||
725 | * |
||
726 | * @return void |
||
727 | */ |
||
728 | 1 | public function persistUrlRewrite($row) |
|
732 | |||
733 | /** |
||
734 | * Delete's the entity with the passed attributes. |
||
735 | * |
||
736 | * @param array $row The attributes of the entity to delete |
||
737 | * @param string|null $name The name of the prepared statement that has to be executed |
||
738 | * |
||
739 | * @return void |
||
740 | */ |
||
741 | public function deleteProduct($row, $name = null) |
||
745 | |||
746 | /** |
||
747 | * Delete's the URL rewrite(s) with the passed attributes. |
||
748 | * |
||
749 | * @param array $row The attributes of the entity to delete |
||
750 | * @param string|null $name The name of the prepared statement that has to be executed |
||
751 | * |
||
752 | * @return void |
||
753 | */ |
||
754 | 1 | public function deleteUrlRewrite($row, $name = null) |
|
758 | |||
759 | /** |
||
760 | * Delete's the stock item(s) with the passed attributes. |
||
761 | * |
||
762 | * @param array $row The attributes of the entity to delete |
||
763 | * @param string|null $name The name of the prepared statement that has to be executed |
||
764 | * |
||
765 | * @return void |
||
766 | */ |
||
767 | public function deleteStockItem($row, $name = null) |
||
771 | |||
772 | /** |
||
773 | * Delete's the stock status with the passed attributes. |
||
774 | * |
||
775 | * @param array $row The attributes of the entity to delete |
||
776 | * @param string|null $name The name of the prepared statement that has to be executed |
||
777 | * |
||
778 | * @return void |
||
779 | */ |
||
780 | public function deleteStockStatus($row, $name = null) |
||
784 | |||
785 | /** |
||
786 | * Delete's the product website relations with the passed attributes. |
||
787 | * |
||
788 | * @param array $row The attributes of the entity to delete |
||
789 | * @param string|null $name The name of the prepared statement that has to be executed |
||
790 | * |
||
791 | * @return void |
||
792 | */ |
||
793 | public function deleteProductWebsite($row, $name = null) |
||
797 | |||
798 | /** |
||
799 | * Delete's the category product relations with the passed attributes. |
||
800 | * |
||
801 | * @param array $row The attributes of the entity to delete |
||
802 | * @param string|null $name The name of the prepared statement that has to be executed |
||
803 | * |
||
804 | * @return void |
||
805 | */ |
||
806 | public function deleteCategoryProduct($row, $name = null) |
||
810 | } |
||
811 |