Completed
Push — master ( 11f27c...4713a5 )
by Andreas
08:33
created

ClassMetadataFactory::initialize()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 6
Code Lines 4

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 5
CRAP Score 1

Importance

Changes 0
Metric Value
dl 0
loc 6
ccs 5
cts 5
cp 1
rs 9.4285
c 0
b 0
f 0
cc 1
eloc 4
nc 1
nop 0
crap 1
1
<?php
2
/*
3
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
4
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
5
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
6
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
7
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
8
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
9
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
10
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
11
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
12
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
13
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
14
 *
15
 * This software consists of voluntary contributions made by many individuals
16
 * and is licensed under the MIT license. For more information, see
17
 * <http://www.doctrine-project.org>.
18
 */
19
20
namespace Doctrine\ODM\MongoDB\Mapping;
21
22
use Doctrine\Common\Persistence\Mapping\AbstractClassMetadataFactory;
23
use Doctrine\Common\Persistence\Mapping\ClassMetadata as ClassMetadataInterface;
24
use Doctrine\Common\Persistence\Mapping\ReflectionService;
25
use Doctrine\ODM\MongoDB\Configuration;
26
use Doctrine\ODM\MongoDB\DocumentManager;
27
use Doctrine\ODM\MongoDB\Event\LoadClassMetadataEventArgs;
28
use Doctrine\ODM\MongoDB\Events;
29
use Doctrine\ODM\MongoDB\Id\AbstractIdGenerator;
30
use Doctrine\ODM\MongoDB\Id\AlnumGenerator;
31
use Doctrine\ODM\MongoDB\Id\AutoGenerator;
32
use Doctrine\ODM\MongoDB\Id\IncrementGenerator;
33
use Doctrine\ODM\MongoDB\Id\UuidGenerator;
34
35
/**
36
 * The ClassMetadataFactory is used to create ClassMetadata objects that contain all the
37
 * metadata mapping informations of a class which describes how a class should be mapped
38
 * to a document database.
39
 *
40
 * @since       1.0
41
 */
42
class ClassMetadataFactory extends AbstractClassMetadataFactory
43
{
44
    protected $cacheSalt = "\$MONGODBODMCLASSMETADATA";
45
46
    /** @var DocumentManager The DocumentManager instance */
47
    private $dm;
48
49
    /** @var Configuration The Configuration instance */
50
    private $config;
51
52
    /** @var \Doctrine\Common\Persistence\Mapping\Driver\MappingDriver The used metadata driver. */
53
    private $driver;
54
55
    /** @var \Doctrine\Common\EventManager The event manager instance */
56
    private $evm;
57
58
    /**
59
     * Sets the DocumentManager instance for this class.
60
     *
61
     * @param DocumentManager $dm The DocumentManager instance
62
     */
63 1681
    public function setDocumentManager(DocumentManager $dm)
64
    {
65 1681
        $this->dm = $dm;
66 1681
    }
67
68
    /**
69
     * Sets the Configuration instance
70
     *
71
     * @param Configuration $config
72
     */
73 1681
    public function setConfiguration(Configuration $config)
74
    {
75 1681
        $this->config = $config;
76 1681
    }
77
78
    /**
79
     * Lazy initialization of this stuff, especially the metadata driver,
80
     * since these are not needed at all when a metadata cache is active.
81
     */
82 1384
    protected function initialize()
83
    {
84 1384
        $this->driver = $this->config->getMetadataDriverImpl();
85 1384
        $this->evm = $this->dm->getEventManager();
86 1384
        $this->initialized = true;
87 1384
    }
88
89
    /**
90
     * {@inheritDoc}
91
     */
92
    protected function getFqcnFromAlias($namespaceAlias, $simpleClassName)
93
    {
94
        return $this->config->getDocumentNamespace($namespaceAlias) . '\\' . $simpleClassName;
95
    }
96
97
    /**
98
     * {@inheritDoc}
99
     */
100 897
    protected function getDriver()
101
    {
102 897
        return $this->driver;
103
    }
104
105
    /**
106
     * {@inheritDoc}
107
     */
108 1380
    protected function wakeupReflection(ClassMetadataInterface $class, ReflectionService $reflService)
109
    {
110 1380
    }
111
112
    /**
113
     * {@inheritDoc}
114
     */
115 1384
    protected function initializeReflection(ClassMetadataInterface $class, ReflectionService $reflService)
116
    {
117 1384
    }
118
119
    /**
120
     * {@inheritDoc}
121
     */
122 1380
    protected function isEntity(ClassMetadataInterface $class)
123
    {
124 1380
        return ! $class->isMappedSuperclass && ! $class->isEmbeddedDocument && ! $class->isQueryResultDocument;
0 ignored issues
show
Bug introduced by
Accessing isMappedSuperclass on the interface Doctrine\Common\Persistence\Mapping\ClassMetadata suggest that you code against a concrete implementation. How about adding an instanceof check?

If you access a property on an interface, you most likely code against a concrete implementation of the interface.

Available Fixes

  1. Adding an additional type check:

    interface SomeInterface { }
    class SomeClass implements SomeInterface {
        public $a;
    }
    
    function someFunction(SomeInterface $object) {
        if ($object instanceof SomeClass) {
            $a = $object->a;
        }
    }
    
  2. Changing the type hint:

    interface SomeInterface { }
    class SomeClass implements SomeInterface {
        public $a;
    }
    
    function someFunction(SomeClass $object) {
        $a = $object->a;
    }
    
Loading history...
Bug introduced by
Accessing isEmbeddedDocument on the interface Doctrine\Common\Persistence\Mapping\ClassMetadata suggest that you code against a concrete implementation. How about adding an instanceof check?

If you access a property on an interface, you most likely code against a concrete implementation of the interface.

Available Fixes

  1. Adding an additional type check:

    interface SomeInterface { }
    class SomeClass implements SomeInterface {
        public $a;
    }
    
    function someFunction(SomeInterface $object) {
        if ($object instanceof SomeClass) {
            $a = $object->a;
        }
    }
    
  2. Changing the type hint:

    interface SomeInterface { }
    class SomeClass implements SomeInterface {
        public $a;
    }
    
    function someFunction(SomeClass $object) {
        $a = $object->a;
    }
    
Loading history...
Bug introduced by
Accessing isQueryResultDocument on the interface Doctrine\Common\Persistence\Mapping\ClassMetadata suggest that you code against a concrete implementation. How about adding an instanceof check?

If you access a property on an interface, you most likely code against a concrete implementation of the interface.

Available Fixes

  1. Adding an additional type check:

    interface SomeInterface { }
    class SomeClass implements SomeInterface {
        public $a;
    }
    
    function someFunction(SomeInterface $object) {
        if ($object instanceof SomeClass) {
            $a = $object->a;
        }
    }
    
  2. Changing the type hint:

    interface SomeInterface { }
    class SomeClass implements SomeInterface {
        public $a;
    }
    
    function someFunction(SomeClass $object) {
        $a = $object->a;
    }
    
Loading history...
125
    }
126
127
    /**
128
     * {@inheritDoc}
129
     */
130 1384
    protected function doLoadMetadata($class, $parent, $rootEntityFound, array $nonSuperclassParents = array())
131
    {
132
        /** @var $class ClassMetadata */
133
        /** @var $parent ClassMetadata */
134 1384
        if ($parent) {
135 895
            $class->setInheritanceType($parent->inheritanceType);
136 895
            $class->setDiscriminatorField($parent->discriminatorField);
137 895
            $class->setDiscriminatorMap($parent->discriminatorMap);
138 895
            $class->setDefaultDiscriminatorValue($parent->defaultDiscriminatorValue);
139 895
            $class->setIdGeneratorType($parent->generatorType);
140 895
            $this->addInheritedFields($class, $parent);
0 ignored issues
show
Compatibility introduced by
$class of type object<Doctrine\Common\P...\Mapping\ClassMetadata> is not a sub-type of object<Doctrine\ODM\Mong...\Mapping\ClassMetadata>. It seems like you assume a concrete implementation of the interface Doctrine\Common\Persistence\Mapping\ClassMetadata to be always present.

This check looks for parameters that are defined as one type in their type hint or doc comment but seem to be used as a narrower type, i.e an implementation of an interface or a subclass.

Consider changing the type of the parameter or doing an instanceof check before assuming your parameter is of the expected type.

Loading history...
141 895
            $this->addInheritedRelations($class, $parent);
0 ignored issues
show
Compatibility introduced by
$class of type object<Doctrine\Common\P...\Mapping\ClassMetadata> is not a sub-type of object<Doctrine\ODM\Mong...\Mapping\ClassMetadata>. It seems like you assume a concrete implementation of the interface Doctrine\Common\Persistence\Mapping\ClassMetadata to be always present.

This check looks for parameters that are defined as one type in their type hint or doc comment but seem to be used as a narrower type, i.e an implementation of an interface or a subclass.

Consider changing the type of the parameter or doing an instanceof check before assuming your parameter is of the expected type.

Loading history...
142 895
            $this->addInheritedIndexes($class, $parent);
0 ignored issues
show
Compatibility introduced by
$class of type object<Doctrine\Common\P...\Mapping\ClassMetadata> is not a sub-type of object<Doctrine\ODM\Mong...\Mapping\ClassMetadata>. It seems like you assume a concrete implementation of the interface Doctrine\Common\Persistence\Mapping\ClassMetadata to be always present.

This check looks for parameters that are defined as one type in their type hint or doc comment but seem to be used as a narrower type, i.e an implementation of an interface or a subclass.

Consider changing the type of the parameter or doing an instanceof check before assuming your parameter is of the expected type.

Loading history...
143 895
            $this->setInheritedShardKey($class, $parent);
0 ignored issues
show
Compatibility introduced by
$class of type object<Doctrine\Common\P...\Mapping\ClassMetadata> is not a sub-type of object<Doctrine\ODM\Mong...\Mapping\ClassMetadata>. It seems like you assume a concrete implementation of the interface Doctrine\Common\Persistence\Mapping\ClassMetadata to be always present.

This check looks for parameters that are defined as one type in their type hint or doc comment but seem to be used as a narrower type, i.e an implementation of an interface or a subclass.

Consider changing the type of the parameter or doing an instanceof check before assuming your parameter is of the expected type.

Loading history...
144 895
            $class->setIdentifier($parent->identifier);
145 895
            $class->setVersioned($parent->isVersioned);
146 895
            $class->setVersionField($parent->versionField);
147 895
            $class->setLifecycleCallbacks($parent->lifecycleCallbacks);
148 895
            $class->setAlsoLoadMethods($parent->alsoLoadMethods);
149 895
            $class->setChangeTrackingPolicy($parent->changeTrackingPolicy);
150 895
            $class->setReadPreference($parent->readPreference, $parent->readPreferenceTags);
151 895
            $class->setWriteConcern($parent->writeConcern);
152 895
            if ($parent->isMappedSuperclass) {
153 830
                $class->setCustomRepositoryClass($parent->customRepositoryClassName);
154
            }
155
        }
156
157
        // Invoke driver
158
        try {
159 1384
            $this->driver->loadMetadataForClass($class->getName(), $class);
160 6
        } catch (\ReflectionException $e) {
161
            throw MappingException::reflectionFailure($class->getName(), $e);
162
        }
163
164 1380
        $this->validateIdentifier($class);
0 ignored issues
show
Compatibility introduced by
$class of type object<Doctrine\Common\P...\Mapping\ClassMetadata> is not a sub-type of object<Doctrine\ODM\Mong...\Mapping\ClassMetadata>. It seems like you assume a concrete implementation of the interface Doctrine\Common\Persistence\Mapping\ClassMetadata to be always present.

This check looks for parameters that are defined as one type in their type hint or doc comment but seem to be used as a narrower type, i.e an implementation of an interface or a subclass.

Consider changing the type of the parameter or doing an instanceof check before assuming your parameter is of the expected type.

Loading history...
165
166 1380
        if ($parent && $rootEntityFound && $parent->generatorType === $class->generatorType) {
0 ignored issues
show
Bug introduced by
Accessing generatorType on the interface Doctrine\Common\Persistence\Mapping\ClassMetadata suggest that you code against a concrete implementation. How about adding an instanceof check?

If you access a property on an interface, you most likely code against a concrete implementation of the interface.

Available Fixes

  1. Adding an additional type check:

    interface SomeInterface { }
    class SomeClass implements SomeInterface {
        public $a;
    }
    
    function someFunction(SomeInterface $object) {
        if ($object instanceof SomeClass) {
            $a = $object->a;
        }
    }
    
  2. Changing the type hint:

    interface SomeInterface { }
    class SomeClass implements SomeInterface {
        public $a;
    }
    
    function someFunction(SomeClass $object) {
        $a = $object->a;
    }
    
Loading history...
167 100
            if ($parent->generatorType) {
168 100
                $class->setIdGeneratorType($parent->generatorType);
169
            }
170 100
            if ($parent->generatorOptions) {
0 ignored issues
show
Bug Best Practice introduced by
The expression $parent->generatorOptions of type array is implicitly converted to a boolean; are you sure this is intended? If so, consider using ! empty($expr) instead to make it clear that you intend to check for an array without elements.

This check marks implicit conversions of arrays to boolean values in a comparison. While in PHP an empty array is considered to be equal (but not identical) to false, this is not always apparent.

Consider making the comparison explicit by using empty(..) or ! empty(...) instead.

Loading history...
171
                $class->setIdGeneratorOptions($parent->generatorOptions);
172
            }
173 100
            if ($parent->idGenerator) {
174 100
                $class->setIdGenerator($parent->idGenerator);
175
            }
176
        } else {
177 1380
            $this->completeIdGeneratorMapping($class);
0 ignored issues
show
Compatibility introduced by
$class of type object<Doctrine\Common\P...\Mapping\ClassMetadata> is not a sub-type of object<Doctrine\ODM\Mong...ping\ClassMetadataInfo>. It seems like you assume a concrete implementation of the interface Doctrine\Common\Persistence\Mapping\ClassMetadata to be always present.

This check looks for parameters that are defined as one type in their type hint or doc comment but seem to be used as a narrower type, i.e an implementation of an interface or a subclass.

Consider changing the type of the parameter or doing an instanceof check before assuming your parameter is of the expected type.

Loading history...
178
        }
179
180 1380
        if ($parent && $parent->isInheritanceTypeSingleCollection()) {
181 87
            $class->setDatabase($parent->getDatabase());
182 87
            $class->setCollection($parent->getCollection());
183
        }
184
185 1380
        $class->setParentClasses($nonSuperclassParents);
186
187 1380 View Code Duplication
        if ($this->evm->hasListeners(Events::loadClassMetadata)) {
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated across your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
188 2
            $eventArgs = new LoadClassMetadataEventArgs($class, $this->dm);
189 2
            $this->evm->dispatchEvent(Events::loadClassMetadata, $eventArgs);
190
        }
191 1380
    }
192
193
    /**
194
     * Validates the identifier mapping.
195
     *
196
     * @param ClassMetadata $class
197
     * @throws MappingException
198
     */
199 1380
    protected function validateIdentifier($class)
200
    {
201 1380
        if ( ! $class->identifier && ! $class->isMappedSuperclass && ! $class->isEmbeddedDocument && ! $class->isQueryResultDocument) {
202
            throw MappingException::identifierRequired($class->name);
203
        }
204 1380
    }
205
206
    /**
207
     * Creates a new ClassMetadata instance for the given class name.
208
     *
209
     * @param string $className
210
     * @return \Doctrine\ODM\MongoDB\Mapping\ClassMetadata
211
     */
212 1384
    protected function newClassMetadataInstance($className)
213
    {
214 1384
        return new ClassMetadata($className);
215
    }
216
217 1380
    private function completeIdGeneratorMapping(ClassMetadataInfo $class)
218
    {
219 1380
        $idGenOptions = $class->generatorOptions;
220 1380
        switch ($class->generatorType) {
221 1380
            case ClassMetadata::GENERATOR_TYPE_AUTO:
222 1310
                $class->setIdGenerator(new AutoGenerator());
223 1310
                break;
224 146 View Code Duplication
            case ClassMetadata::GENERATOR_TYPE_INCREMENT:
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated across your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
225 9
                $incrementGenerator = new IncrementGenerator();
226 9
                if (isset($idGenOptions['key'])) {
227
                    $incrementGenerator->setKey($idGenOptions['key']);
228
                }
229 9
                if (isset($idGenOptions['collection'])) {
230
                    $incrementGenerator->setCollection($idGenOptions['collection']);
231
                }
232 9
                if (isset($idGenOptions['startingId'])) {
233 1
                    $incrementGenerator->setStartingId((int) $idGenOptions['startingId']);
234
                }
235 9
                $class->setIdGenerator($incrementGenerator);
236 9
                break;
237 137
            case ClassMetadata::GENERATOR_TYPE_UUID:
238 4
                $uuidGenerator = new UuidGenerator();
239 4
                isset($idGenOptions['salt']) && $uuidGenerator->setSalt($idGenOptions['salt']);
240 4
                $class->setIdGenerator($uuidGenerator);
241 4
                break;
242 133 View Code Duplication
            case ClassMetadata::GENERATOR_TYPE_ALNUM:
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated across your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
243 1
                $alnumGenerator = new AlnumGenerator();
244 1
                if (isset($idGenOptions['pad'])) {
245
                    $alnumGenerator->setPad($idGenOptions['pad']);
246
                }
247 1
                if (isset($idGenOptions['chars'])) {
248 1
                    $alnumGenerator->setChars($idGenOptions['chars']);
249
                } elseif (isset($idGenOptions['awkwardSafe'])) {
250
                    $alnumGenerator->setAwkwardSafeMode($idGenOptions['awkwardSafe']);
251
                }
252
253 1
                $class->setIdGenerator($alnumGenerator);
254 1
                break;
255 132
            case ClassMetadata::GENERATOR_TYPE_CUSTOM:
256
                if (empty($idGenOptions['class'])) {
257
                    throw MappingException::missingIdGeneratorClass($class->name);
258
                }
259
260
                $customGenerator = new $idGenOptions['class'];
261
                unset($idGenOptions['class']);
262
                if ( ! $customGenerator instanceof AbstractIdGenerator) {
263
                    throw MappingException::classIsNotAValidGenerator(get_class($customGenerator));
264
                }
265
266
                $methods = get_class_methods($customGenerator);
267
                foreach ($idGenOptions as $name => $value) {
268
                    $method = 'set' . ucfirst($name);
269
                    if ( ! in_array($method, $methods)) {
270
                        throw MappingException::missingGeneratorSetter(get_class($customGenerator), $name);
271
                    }
272
273
                    $customGenerator->$method($value);
274
                }
275
                $class->setIdGenerator($customGenerator);
276
                break;
277 132
            case ClassMetadata::GENERATOR_TYPE_NONE;
278 132
                break;
279
            default:
280
                throw new MappingException('Unknown generator type: ' . $class->generatorType);
281
        }
282 1380
    }
283
284
    /**
285
     * Adds inherited fields to the subclass mapping.
286
     *
287
     * @param ClassMetadata $subClass
288
     * @param ClassMetadata $parentClass
289
     */
290 895
    private function addInheritedFields(ClassMetadata $subClass, ClassMetadata $parentClass)
291
    {
292 895
        foreach ($parentClass->fieldMappings as $fieldName => $mapping) {
293 119 View Code Duplication
            if ( ! isset($mapping['inherited']) && ! $parentClass->isMappedSuperclass) {
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated across your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
294 112
                $mapping['inherited'] = $parentClass->name;
295
            }
296 119
            if ( ! isset($mapping['declared'])) {
297 119
                $mapping['declared'] = $parentClass->name;
298
            }
299 119
            $subClass->addInheritedFieldMapping($mapping);
300
        }
301 895
        foreach ($parentClass->reflFields as $name => $field) {
302 119
            $subClass->reflFields[$name] = $field;
303
        }
304 895
    }
305
306
307
    /**
308
     * Adds inherited association mappings to the subclass mapping.
309
     *
310
     * @param \Doctrine\ODM\MongoDB\Mapping\ClassMetadata $subClass
311
     * @param \Doctrine\ODM\MongoDB\Mapping\ClassMetadata $parentClass
312
     *
313
     * @return void
314
     *
315
     * @throws MappingException
316
     */
317 895
    private function addInheritedRelations(ClassMetadata $subClass, ClassMetadata $parentClass)
318
    {
319 895
        foreach ($parentClass->associationMappings as $field => $mapping) {
320 68
            if ($parentClass->isMappedSuperclass) {
321 4
                $mapping['sourceDocument'] = $subClass->name;
322
            }
323
324 68 View Code Duplication
            if ( ! isset($mapping['inherited']) && ! $parentClass->isMappedSuperclass) {
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated across your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
325 64
                $mapping['inherited'] = $parentClass->name;
326
            }
327 68
            if ( ! isset($mapping['declared'])) {
328 68
                $mapping['declared'] = $parentClass->name;
329
            }
330 68
            $subClass->addInheritedAssociationMapping($mapping);
331
        }
332 895
    }
333
334
    /**
335
     * Adds inherited indexes to the subclass mapping.
336
     *
337
     * @param ClassMetadata $subClass
338
     * @param ClassMetadata $parentClass
339
     */
340 895
    private function addInheritedIndexes(ClassMetadata $subClass, ClassMetadata $parentClass)
341
    {
342 895
        foreach ($parentClass->indexes as $index) {
343 45
            $subClass->addIndex($index['keys'], $index['options']);
344
        }
345 895
    }
346
347
    /**
348
     * Adds inherited shard key to the subclass mapping.
349
     *
350
     * @param ClassMetadata $subClass
351
     * @param ClassMetadata $parentClass
352
     */
353 895
    private function setInheritedShardKey(ClassMetadata $subClass, ClassMetadata $parentClass)
354
    {
355 895
        if ($parentClass->isSharded()) {
356 5
            $subClass->setShardKey(
357 5
                $parentClass->shardKey['keys'],
358 5
                $parentClass->shardKey['options']
359
            );
360
        }
361 895
    }
362
}
363