Completed
Pull Request — master (#1620)
by Maciej
09:01
created

ClassMetadataFactory::getDriver()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 4
Code Lines 2

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 2
CRAP Score 1

Importance

Changes 0
Metric Value
dl 0
loc 4
ccs 2
cts 2
cp 1
rs 10
c 0
b 0
f 0
cc 1
eloc 2
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 1147
    public function setDocumentManager(DocumentManager $dm)
64
    {
65 1147
        $this->dm = $dm;
66 1147
    }
67
68
    /**
69
     * Sets the Configuration instance
70
     *
71
     * @param Configuration $config
72
     */
73 1147
    public function setConfiguration(Configuration $config)
74
    {
75 1147
        $this->config = $config;
76 1147
    }
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 903
    protected function initialize()
83
    {
84 903
        $this->driver = $this->config->getMetadataDriverImpl();
85 903
        $this->evm = $this->dm->getEventManager();
86 903
        $this->initialized = true;
87 903
    }
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 371
    protected function getDriver()
101
    {
102 371
        return $this->driver;
103
    }
104
105
    /**
106
     * {@inheritDoc}
107
     */
108 899
    protected function wakeupReflection(ClassMetadataInterface $class, ReflectionService $reflService)
109
    {
110 899
    }
111
112
    /**
113
     * {@inheritDoc}
114
     */
115 903
    protected function initializeReflection(ClassMetadataInterface $class, ReflectionService $reflService)
116
    {
117 903
    }
118
119
    /**
120
     * {@inheritDoc}
121
     */
122 899
    protected function isEntity(ClassMetadataInterface $class)
123
    {
124 899
        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 903
    protected function doLoadMetadata($class, $parent, $rootEntityFound, array $nonSuperclassParents = array())
131
    {
132
        /** @var $class ClassMetadata */
133
        /** @var $parent ClassMetadata */
134 903
        if ($parent) {
135 369
            $class->setInheritanceType($parent->inheritanceType);
136 369
            $class->setDiscriminatorField($parent->discriminatorField);
137 369
            $class->setDiscriminatorMap($parent->discriminatorMap);
138 369
            $class->setDefaultDiscriminatorValue($parent->defaultDiscriminatorValue);
139 369
            $class->setIdGeneratorType($parent->generatorType);
140 369
            $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 369
            $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 369
            $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 369
            $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 369
            $class->setIdentifier($parent->identifier);
145 369
            $class->setVersioned($parent->isVersioned);
146 369
            $class->setVersionField($parent->versionField);
147 369
            $class->setLifecycleCallbacks($parent->lifecycleCallbacks);
148 369
            $class->setAlsoLoadMethods($parent->alsoLoadMethods);
149 369
            $class->setChangeTrackingPolicy($parent->changeTrackingPolicy);
150 369
            $class->setReadPreference($parent->readPreference, $parent->readPreferenceTags);
151 369
            $class->setWriteConcern($parent->writeConcern);
152 369
            $class->setFile($parent->getFile());
153 369
            if ($parent->isMappedSuperclass) {
154 303
                $class->setCustomRepositoryClass($parent->customRepositoryClassName);
155
            }
156
        }
157
158
        // Invoke driver
159
        try {
160 903
            $this->driver->loadMetadataForClass($class->getName(), $class);
161 6
        } catch (\ReflectionException $e) {
162
            throw MappingException::reflectionFailure($class->getName(), $e);
163
        }
164
165 899
        $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...
166
167 899
        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...
168 111
            if ($parent->generatorType) {
169 111
                $class->setIdGeneratorType($parent->generatorType);
170
            }
171 111
            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...
172
                $class->setIdGeneratorOptions($parent->generatorOptions);
173
            }
174 111
            if ($parent->idGenerator) {
175 111
                $class->setIdGenerator($parent->idGenerator);
176
            }
177
        } else {
178 899
            $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...
179
        }
180
181 899
        if ($parent && $parent->isInheritanceTypeSingleCollection()) {
182 96
            $class->setDatabase($parent->getDatabase());
183 96
            $class->setCollection($parent->getCollection());
184
        }
185
186 899
        $class->setParentClasses($nonSuperclassParents);
187
188 899 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...
189 2
            $eventArgs = new LoadClassMetadataEventArgs($class, $this->dm);
190 2
            $this->evm->dispatchEvent(Events::loadClassMetadata, $eventArgs);
191
        }
192 899
    }
193
194
    /**
195
     * Validates the identifier mapping.
196
     *
197
     * @param ClassMetadata $class
198
     * @throws MappingException
199
     */
200 899
    protected function validateIdentifier($class)
201
    {
202 899
        if ( ! $class->identifier && ! $class->isMappedSuperclass && ! $class->isEmbeddedDocument && ! $class->isQueryResultDocument) {
203
            throw MappingException::identifierRequired($class->name);
204
        }
205 899
    }
206
207
    /**
208
     * Creates a new ClassMetadata instance for the given class name.
209
     *
210
     * @param string $className
211
     * @return \Doctrine\ODM\MongoDB\Mapping\ClassMetadata
212
     */
213 903
    protected function newClassMetadataInstance($className)
214
    {
215 903
        return new ClassMetadata($className);
216
    }
217
218 899
    private function completeIdGeneratorMapping(ClassMetadataInfo $class)
219
    {
220 899
        $idGenOptions = $class->generatorOptions;
221 899
        switch ($class->generatorType) {
222 899
            case ClassMetadata::GENERATOR_TYPE_AUTO:
223 829
                $class->setIdGenerator(new AutoGenerator());
224 829
                break;
225 150
            case ClassMetadata::GENERATOR_TYPE_INCREMENT:
226 8
                $incrementGenerator = new IncrementGenerator();
227 8
                if (isset($idGenOptions['key'])) {
228
                    $incrementGenerator->setKey($idGenOptions['key']);
229
                }
230 8
                if (isset($idGenOptions['collection'])) {
231
                    $incrementGenerator->setCollection($idGenOptions['collection']);
232
                }
233 8
                $class->setIdGenerator($incrementGenerator);
234 8
                break;
235 142
            case ClassMetadata::GENERATOR_TYPE_UUID:
236 4
                $uuidGenerator = new UuidGenerator();
237 4
                isset($idGenOptions['salt']) && $uuidGenerator->setSalt($idGenOptions['salt']);
238 4
                $class->setIdGenerator($uuidGenerator);
239 4
                break;
240 138
            case ClassMetadata::GENERATOR_TYPE_ALNUM:
241 1
                $alnumGenerator = new AlnumGenerator();
242 1
                if (isset($idGenOptions['pad'])) {
243
                    $alnumGenerator->setPad($idGenOptions['pad']);
244
                }
245 1
                if (isset($idGenOptions['chars'])) {
246 1
                    $alnumGenerator->setChars($idGenOptions['chars']);
247
                } elseif (isset($idGenOptions['awkwardSafe'])) {
248
                    $alnumGenerator->setAwkwardSafeMode($idGenOptions['awkwardSafe']);
249
                }
250
251 1
                $class->setIdGenerator($alnumGenerator);
252 1
                break;
253 137
            case ClassMetadata::GENERATOR_TYPE_CUSTOM:
254
                if (empty($idGenOptions['class'])) {
255
                    throw MappingException::missingIdGeneratorClass($class->name);
256
                }
257
258
                $customGenerator = new $idGenOptions['class'];
259
                unset($idGenOptions['class']);
260
                if ( ! $customGenerator instanceof AbstractIdGenerator) {
261
                    throw MappingException::classIsNotAValidGenerator(get_class($customGenerator));
262
                }
263
264
                $methods = get_class_methods($customGenerator);
265
                foreach ($idGenOptions as $name => $value) {
266
                    $method = 'set' . ucfirst($name);
267
                    if ( ! in_array($method, $methods)) {
268
                        throw MappingException::missingGeneratorSetter(get_class($customGenerator), $name);
269
                    }
270
271
                    $customGenerator->$method($value);
272
                }
273
                $class->setIdGenerator($customGenerator);
274
                break;
275 137
            case ClassMetadata::GENERATOR_TYPE_NONE;
276 137
                break;
277
            default:
278
                throw new MappingException('Unknown generator type: ' . $class->generatorType);
279
        }
280 899
    }
281
282
    /**
283
     * Adds inherited fields to the subclass mapping.
284
     *
285
     * @param ClassMetadata $subClass
286
     * @param ClassMetadata $parentClass
287
     */
288 369
    private function addInheritedFields(ClassMetadata $subClass, ClassMetadata $parentClass)
289
    {
290 369
        foreach ($parentClass->fieldMappings as $fieldName => $mapping) {
291 129 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...
292 123
                $mapping['inherited'] = $parentClass->name;
293
            }
294 129
            if ( ! isset($mapping['declared'])) {
295 129
                $mapping['declared'] = $parentClass->name;
296
            }
297 129
            $subClass->addInheritedFieldMapping($mapping);
298
        }
299 369
        foreach ($parentClass->reflFields as $name => $field) {
300 129
            $subClass->reflFields[$name] = $field;
301
        }
302 369
    }
303
304
305
    /**
306
     * Adds inherited association mappings to the subclass mapping.
307
     *
308
     * @param \Doctrine\ODM\MongoDB\Mapping\ClassMetadata $subClass
309
     * @param \Doctrine\ODM\MongoDB\Mapping\ClassMetadata $parentClass
310
     *
311
     * @return void
312
     *
313
     * @throws MappingException
314
     */
315 369
    private function addInheritedRelations(ClassMetadata $subClass, ClassMetadata $parentClass)
316
    {
317 369
        foreach ($parentClass->associationMappings as $field => $mapping) {
318 77
            if ($parentClass->isMappedSuperclass) {
319 3
                $mapping['sourceDocument'] = $subClass->name;
320
            }
321
322 77 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...
323 74
                $mapping['inherited'] = $parentClass->name;
324
            }
325 77
            if ( ! isset($mapping['declared'])) {
326 77
                $mapping['declared'] = $parentClass->name;
327
            }
328 77
            $subClass->addInheritedAssociationMapping($mapping);
329
        }
330 369
    }
331
332
    /**
333
     * Adds inherited indexes to the subclass mapping.
334
     *
335
     * @param ClassMetadata $subClass
336
     * @param ClassMetadata $parentClass
337
     */
338 369
    private function addInheritedIndexes(ClassMetadata $subClass, ClassMetadata $parentClass)
339
    {
340 369
        foreach ($parentClass->indexes as $index) {
341 53
            $subClass->addIndex($index['keys'], $index['options']);
342
        }
343 369
    }
344
345
    /**
346
     * Adds inherited shard key to the subclass mapping.
347
     *
348
     * @param ClassMetadata $subClass
349
     * @param ClassMetadata $parentClass
350
     */
351 369
    private function setInheritedShardKey(ClassMetadata $subClass, ClassMetadata $parentClass)
352
    {
353 369
        if ($parentClass->isSharded()) {
354 5
            $subClass->setShardKey(
355 5
                $parentClass->shardKey['keys'],
356 5
                $parentClass->shardKey['options']
357
            );
358
        }
359 369
    }
360
}
361