Complex classes like ClassMetadataFactory 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 ClassMetadataFactory, and based on these observations, apply Extract Interface, too.
1 | <?php |
||
46 | class ClassMetadataFactory extends AbstractClassMetadataFactory |
||
47 | { |
||
48 | /** |
||
49 | * @var EntityManagerInterface|null |
||
50 | */ |
||
51 | private $em; |
||
52 | |||
53 | /** |
||
54 | * @var \Doctrine\DBAL\Platforms\AbstractPlatform |
||
55 | */ |
||
56 | private $targetPlatform; |
||
57 | |||
58 | /** |
||
59 | * @var \Doctrine\Common\Persistence\Mapping\Driver\MappingDriver |
||
60 | */ |
||
61 | private $driver; |
||
62 | |||
63 | /** |
||
64 | * @var \Doctrine\Common\EventManager |
||
65 | */ |
||
66 | private $evm; |
||
67 | |||
68 | /** |
||
69 | * @var array |
||
70 | */ |
||
71 | private $embeddablesActiveNesting = array(); |
||
72 | |||
73 | /** |
||
74 | * {@inheritDoc} |
||
75 | */ |
||
76 | 441 | protected function loadMetadata($name) |
|
84 | |||
85 | /** |
||
86 | * @param EntityManagerInterface $em |
||
87 | */ |
||
88 | 2362 | public function setEntityManager(EntityManagerInterface $em) |
|
92 | |||
93 | /** |
||
94 | * {@inheritDoc} |
||
95 | */ |
||
96 | 510 | protected function initialize() |
|
102 | |||
103 | /** |
||
104 | * {@inheritDoc} |
||
105 | */ |
||
106 | 3 | protected function onNotFoundMetadata($className) |
|
107 | { |
||
108 | 3 | if (! $this->evm->hasListeners(Events::onClassMetadataNotFound)) { |
|
109 | 1 | return; |
|
110 | } |
||
111 | |||
112 | 2 | $eventArgs = new OnClassMetadataNotFoundEventArgs($className, $this->em); |
|
|
|||
113 | |||
114 | 2 | $this->evm->dispatchEvent(Events::onClassMetadataNotFound, $eventArgs); |
|
115 | |||
116 | 2 | return $eventArgs->getFoundMetadata(); |
|
117 | } |
||
118 | |||
119 | /** |
||
120 | * {@inheritDoc} |
||
121 | */ |
||
122 | 438 | protected function doLoadMetadata($class, $parent, $rootEntityFound, array $nonSuperclassParents) |
|
123 | { |
||
124 | /* @var $class ClassMetadata */ |
||
125 | /* @var $parent ClassMetadata */ |
||
126 | 438 | if ($parent) { |
|
127 | 128 | $class->setInheritanceType($parent->inheritanceType); |
|
128 | 128 | $class->setDiscriminatorColumn($parent->discriminatorColumn); |
|
129 | 128 | $class->setIdGeneratorType($parent->generatorType); |
|
130 | 128 | $this->addInheritedFields($class, $parent); |
|
131 | 128 | $this->addInheritedRelations($class, $parent); |
|
132 | 127 | $this->addInheritedEmbeddedClasses($class, $parent); |
|
133 | 127 | $class->setIdentifier($parent->identifier); |
|
134 | 127 | $class->setVersioned($parent->isVersioned); |
|
135 | 127 | $class->setVersionField($parent->versionField); |
|
136 | 127 | $class->setDiscriminatorMap($parent->discriminatorMap); |
|
137 | 127 | $class->setLifecycleCallbacks($parent->lifecycleCallbacks); |
|
138 | 127 | $class->setChangeTrackingPolicy($parent->changeTrackingPolicy); |
|
139 | |||
140 | 127 | if ( ! empty($parent->customGeneratorDefinition)) { |
|
141 | 1 | $class->setCustomGeneratorDefinition($parent->customGeneratorDefinition); |
|
142 | } |
||
143 | |||
144 | 127 | if ($parent->isMappedSuperclass) { |
|
145 | 51 | $class->setCustomRepositoryClass($parent->customRepositoryClassName); |
|
146 | } |
||
147 | } |
||
148 | |||
149 | // Invoke driver |
||
150 | try { |
||
151 | 438 | $this->driver->loadMetadataForClass($class->getName(), $class); |
|
152 | 2 | } catch (ReflectionException $e) { |
|
153 | throw MappingException::reflectionFailure($class->getName(), $e); |
||
154 | } |
||
155 | |||
156 | // If this class has a parent the id generator strategy is inherited. |
||
157 | // However this is only true if the hierarchy of parents contains the root entity, |
||
158 | // if it consists of mapped superclasses these don't necessarily include the id field. |
||
159 | 436 | if ($parent && $rootEntityFound) { |
|
160 | 82 | $this->inheritIdGeneratorMapping($class, $parent); |
|
161 | } else { |
||
162 | 432 | $this->completeIdGeneratorMapping($class); |
|
163 | } |
||
164 | |||
165 | 434 | if (!$class->isMappedSuperclass) { |
|
166 | 432 | foreach ($class->embeddedClasses as $property => $embeddableClass) { |
|
167 | |||
168 | 13 | if (isset($embeddableClass['inherited'])) { |
|
169 | 1 | continue; |
|
170 | } |
||
171 | |||
172 | 13 | if ( ! (isset($embeddableClass['class']) && $embeddableClass['class'])) { |
|
173 | 1 | throw MappingException::missingEmbeddedClass($property); |
|
174 | } |
||
175 | |||
176 | 12 | if (isset($this->embeddablesActiveNesting[$embeddableClass['class']])) { |
|
177 | 2 | throw MappingException::infiniteEmbeddableNesting($class->name, $property); |
|
178 | } |
||
179 | |||
180 | 12 | $this->embeddablesActiveNesting[$class->name] = true; |
|
181 | |||
182 | 12 | $embeddableMetadata = $this->getMetadataFor($embeddableClass['class']); |
|
183 | |||
184 | 11 | if ($embeddableMetadata->isEmbeddedClass) { |
|
185 | 11 | $this->addNestedEmbeddedClasses($embeddableMetadata, $class, $property); |
|
186 | } |
||
187 | |||
188 | 11 | $identifier = $embeddableMetadata->getIdentifier(); |
|
189 | |||
190 | 11 | if (! empty($identifier)) { |
|
191 | 5 | $this->inheritIdGeneratorMapping($class, $embeddableMetadata); |
|
192 | } |
||
193 | |||
194 | 11 | $class->inlineEmbeddable($property, $embeddableMetadata); |
|
195 | |||
196 | 11 | unset($this->embeddablesActiveNesting[$class->name]); |
|
197 | } |
||
198 | } |
||
199 | |||
200 | 431 | if ($parent) { |
|
201 | 127 | if ($parent->isInheritanceTypeSingleTable()) { |
|
202 | 33 | $class->setPrimaryTable($parent->table); |
|
203 | } |
||
204 | |||
205 | 127 | if ($parent) { |
|
206 | 127 | $this->addInheritedIndexes($class, $parent); |
|
207 | } |
||
208 | |||
209 | 127 | if ($parent->cache) { |
|
210 | 3 | $class->cache = $parent->cache; |
|
211 | } |
||
212 | |||
213 | 127 | if ($parent->containsForeignIdentifier) { |
|
214 | $class->containsForeignIdentifier = true; |
||
215 | } |
||
216 | |||
217 | 127 | if ( ! empty($parent->namedQueries)) { |
|
218 | 1 | $this->addInheritedNamedQueries($class, $parent); |
|
219 | } |
||
220 | |||
221 | 127 | if ( ! empty($parent->namedNativeQueries)) { |
|
222 | 9 | $this->addInheritedNamedNativeQueries($class, $parent); |
|
223 | } |
||
224 | |||
225 | 127 | if ( ! empty($parent->sqlResultSetMappings)) { |
|
226 | 9 | $this->addInheritedSqlResultSetMappings($class, $parent); |
|
227 | } |
||
228 | |||
229 | 127 | if ( ! empty($parent->entityListeners) && empty($class->entityListeners)) { |
|
230 | 15 | $class->entityListeners = $parent->entityListeners; |
|
231 | } |
||
232 | } |
||
233 | |||
234 | 431 | $class->setParentClasses($nonSuperclassParents); |
|
235 | |||
236 | 431 | if ($class->isRootEntity() && ! $class->isInheritanceTypeNone() && ! $class->discriminatorMap) { |
|
237 | 1 | $this->addDefaultDiscriminatorMap($class); |
|
238 | } |
||
239 | |||
240 | 431 | if ($this->evm->hasListeners(Events::loadClassMetadata)) { |
|
241 | 6 | $eventArgs = new LoadClassMetadataEventArgs($class, $this->em); |
|
242 | 6 | $this->evm->dispatchEvent(Events::loadClassMetadata, $eventArgs); |
|
243 | } |
||
244 | |||
245 | 430 | $this->validateRuntimeMetadata($class, $parent); |
|
246 | 429 | } |
|
247 | |||
248 | /** |
||
249 | * Validate runtime metadata is correctly defined. |
||
250 | * |
||
251 | * @param ClassMetadata $class |
||
252 | * @param ClassMetadataInterface|null $parent |
||
253 | * |
||
254 | * @return void |
||
255 | * |
||
256 | * @throws MappingException |
||
257 | */ |
||
258 | 430 | protected function validateRuntimeMetadata($class, $parent) |
|
284 | |||
285 | /** |
||
286 | * {@inheritDoc} |
||
287 | */ |
||
288 | 433 | protected function newClassMetadataInstance($className) |
|
292 | |||
293 | /** |
||
294 | * Populates the discriminator value of the given metadata (if not set) by iterating over discriminator |
||
295 | * map classes and looking for a fitting one. |
||
296 | * |
||
297 | * @param ClassMetadata $metadata |
||
298 | * |
||
299 | * @return void |
||
300 | * |
||
301 | * @throws MappingException |
||
302 | */ |
||
303 | 422 | private function resolveDiscriminatorValue(ClassMetadata $metadata) |
|
334 | |||
335 | /** |
||
336 | * Adds a default discriminator map if no one is given |
||
337 | * |
||
338 | * If an entity is of any inheritance type and does not contain a |
||
339 | * discriminator map, then the map is generated automatically. This process |
||
340 | * is expensive computation wise. |
||
341 | * |
||
342 | * The automatically generated discriminator map contains the lowercase short name of |
||
343 | * each class as key. |
||
344 | * |
||
345 | * @param \Doctrine\ORM\Mapping\ClassMetadata $class |
||
346 | * |
||
347 | * @throws MappingException |
||
348 | */ |
||
349 | 1 | private function addDefaultDiscriminatorMap(ClassMetadata $class) |
|
374 | |||
375 | /** |
||
376 | * Gets the lower-case short name of a class. |
||
377 | * |
||
378 | * @param string $className |
||
379 | * |
||
380 | * @return string |
||
381 | */ |
||
382 | 1 | private function getShortName($className) |
|
383 | { |
||
384 | 1 | if (strpos($className, "\\") === false) { |
|
385 | return strtolower($className); |
||
386 | } |
||
387 | |||
388 | 1 | $parts = explode("\\", $className); |
|
389 | |||
390 | 1 | return strtolower(end($parts)); |
|
391 | } |
||
392 | |||
393 | /** |
||
394 | * Adds inherited fields to the subclass mapping. |
||
395 | * |
||
396 | * @param \Doctrine\ORM\Mapping\ClassMetadata $subClass |
||
397 | * @param \Doctrine\ORM\Mapping\ClassMetadata $parentClass |
||
398 | * |
||
399 | * @return void |
||
400 | */ |
||
401 | 128 | private function addInheritedFields(ClassMetadata $subClass, ClassMetadata $parentClass) |
|
416 | |||
417 | /** |
||
418 | * Adds inherited association mappings to the subclass mapping. |
||
419 | * |
||
420 | * @param \Doctrine\ORM\Mapping\ClassMetadata $subClass |
||
421 | * @param \Doctrine\ORM\Mapping\ClassMetadata $parentClass |
||
422 | * |
||
423 | * @return void |
||
424 | * |
||
425 | * @throws MappingException |
||
426 | */ |
||
427 | 128 | private function addInheritedRelations(ClassMetadata $subClass, ClassMetadata $parentClass) |
|
447 | |||
448 | 127 | private function addInheritedEmbeddedClasses(ClassMetadata $subClass, ClassMetadata $parentClass) |
|
461 | |||
462 | /** |
||
463 | * Adds nested embedded classes metadata to a parent class. |
||
464 | * |
||
465 | * @param ClassMetadata $subClass Sub embedded class metadata to add nested embedded classes metadata from. |
||
466 | * @param ClassMetadata $parentClass Parent class to add nested embedded classes metadata to. |
||
467 | * @param string $prefix Embedded classes' prefix to use for nested embedded classes field names. |
||
468 | */ |
||
469 | 11 | private function addNestedEmbeddedClasses(ClassMetadata $subClass, ClassMetadata $parentClass, $prefix) |
|
489 | |||
490 | /** |
||
491 | * Copy the table indices from the parent class superclass to the child class |
||
492 | * |
||
493 | * @param ClassMetadata $subClass |
||
494 | * @param ClassMetadata $parentClass |
||
495 | * |
||
496 | * @return void |
||
497 | */ |
||
498 | 127 | private function addInheritedIndexes(ClassMetadata $subClass, ClassMetadata $parentClass) |
|
516 | |||
517 | /** |
||
518 | * Adds inherited named queries to the subclass mapping. |
||
519 | * |
||
520 | * @since 2.2 |
||
521 | * |
||
522 | * @param \Doctrine\ORM\Mapping\ClassMetadata $subClass |
||
523 | * @param \Doctrine\ORM\Mapping\ClassMetadata $parentClass |
||
524 | * |
||
525 | * @return void |
||
526 | */ |
||
527 | 1 | private function addInheritedNamedQueries(ClassMetadata $subClass, ClassMetadata $parentClass) |
|
538 | |||
539 | /** |
||
540 | * Adds inherited named native queries to the subclass mapping. |
||
541 | * |
||
542 | * @since 2.3 |
||
543 | * |
||
544 | * @param \Doctrine\ORM\Mapping\ClassMetadata $subClass |
||
545 | * @param \Doctrine\ORM\Mapping\ClassMetadata $parentClass |
||
546 | * |
||
547 | * @return void |
||
548 | */ |
||
549 | 9 | private function addInheritedNamedNativeQueries(ClassMetadata $subClass, ClassMetadata $parentClass) |
|
563 | |||
564 | /** |
||
565 | * Adds inherited sql result set mappings to the subclass mapping. |
||
566 | * |
||
567 | * @since 2.3 |
||
568 | * |
||
569 | * @param \Doctrine\ORM\Mapping\ClassMetadata $subClass |
||
570 | * @param \Doctrine\ORM\Mapping\ClassMetadata $parentClass |
||
571 | * |
||
572 | * @return void |
||
573 | */ |
||
574 | 9 | private function addInheritedSqlResultSetMappings(ClassMetadata $subClass, ClassMetadata $parentClass) |
|
596 | |||
597 | /** |
||
598 | * Completes the ID generator mapping. If "auto" is specified we choose the generator |
||
599 | * most appropriate for the targeted database platform. |
||
600 | * |
||
601 | * @param ClassMetadataInfo $class |
||
602 | * |
||
603 | * @return void |
||
604 | * |
||
605 | * @throws ORMException |
||
606 | */ |
||
607 | 432 | private function completeIdGeneratorMapping(ClassMetadataInfo $class) |
|
709 | |||
710 | /** |
||
711 | * Inherits the ID generator mapping from a parent class. |
||
712 | * |
||
713 | * @param ClassMetadataInfo $class |
||
714 | * @param ClassMetadataInfo $parent |
||
715 | */ |
||
716 | 87 | private function inheritIdGeneratorMapping(ClassMetadataInfo $class, ClassMetadataInfo $parent) |
|
717 | { |
||
718 | 87 | if ($parent->isIdGeneratorSequence()) { |
|
719 | 3 | $class->setSequenceGeneratorDefinition($parent->sequenceGeneratorDefinition); |
|
720 | 84 | } elseif ($parent->isIdGeneratorTable()) { |
|
721 | $class->tableGeneratorDefinition = $parent->tableGeneratorDefinition; |
||
722 | } |
||
723 | |||
724 | 87 | if ($parent->generatorType) { |
|
725 | 87 | $class->setIdGeneratorType($parent->generatorType); |
|
726 | } |
||
727 | |||
728 | 87 | if ($parent->idGenerator) { |
|
729 | 87 | $class->setIdGenerator($parent->idGenerator); |
|
730 | } |
||
731 | 87 | } |
|
732 | |||
733 | /** |
||
734 | * {@inheritDoc} |
||
735 | */ |
||
736 | 2034 | protected function wakeupReflection(ClassMetadataInterface $class, ReflectionService $reflService) |
|
741 | |||
742 | /** |
||
743 | * {@inheritDoc} |
||
744 | */ |
||
745 | 438 | protected function initializeReflection(ClassMetadataInterface $class, ReflectionService $reflService) |
|
750 | |||
751 | /** |
||
752 | * {@inheritDoc} |
||
753 | */ |
||
754 | 4 | protected function getFqcnFromAlias($namespaceAlias, $simpleClassName) |
|
758 | |||
759 | /** |
||
760 | * {@inheritDoc} |
||
761 | */ |
||
762 | 237 | protected function getDriver() |
|
766 | |||
767 | /** |
||
768 | * {@inheritDoc} |
||
769 | */ |
||
770 | 429 | protected function isEntity(ClassMetadataInterface $class) |
|
774 | |||
775 | /** |
||
776 | * @return Platforms\AbstractPlatform |
||
777 | */ |
||
778 | 331 | private function getTargetPlatform() |
|
786 | } |
||
787 |
Unless you are absolutely sure that the expression can never be null because of other conditions, we strongly recommend to add an additional type check to your code: