Completed
Pull Request — master (#771)
by
unknown
41:43
created

GraphNavigator::accept()   F

Complexity

Conditions 55
Paths > 20000

Size

Total Lines 182
Code Lines 99

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 111
CRAP Score 55.6307

Importance

Changes 0
Metric Value
dl 0
loc 182
ccs 111
cts 118
cp 0.9407
rs 2
c 0
b 0
f 0
cc 55
eloc 99
nc 32089
nop 3
crap 55.6307

How to fix   Long Method    Complexity   

Long Method

Small methods make your code easier to understand, in particular if combined with a good name. Besides, if your method is small, finding a good name is usually much easier.

For example, if you find yourself adding comments to a method's body, this is usually a good sign to extract the commented part to a new method, and use the comment as a starting point when coming up with a good name for this new method.

Commonly applied refactorings include:

1
<?php
2
3
/*
4
 * Copyright 2016 Johannes M. Schmitt <[email protected]>
5
 *
6
 * Licensed under the Apache License, Version 2.0 (the "License");
7
 * you may not use this file except in compliance with the License.
8
 * You may obtain a copy of the License at
9
 *
10
 *     http://www.apache.org/licenses/LICENSE-2.0
11
 *
12
 * Unless required by applicable law or agreed to in writing, software
13
 * distributed under the License is distributed on an "AS IS" BASIS,
14
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15
 * See the License for the specific language governing permissions and
16
 * limitations under the License.
17
 */
18
19
namespace JMS\Serializer;
20
21
use JMS\Serializer\Construction\ObjectConstructorInterface;
22
use JMS\Serializer\EventDispatcher\EventDispatcherInterface;
23
use JMS\Serializer\EventDispatcher\ObjectEvent;
24
use JMS\Serializer\EventDispatcher\PreDeserializeEvent;
25
use JMS\Serializer\EventDispatcher\PreSerializeEvent;
26
use JMS\Serializer\Exception\ExpressionLanguageRequiredException;
27
use JMS\Serializer\Exception\InvalidArgumentException;
28
use JMS\Serializer\Exception\RuntimeException;
29
use JMS\Serializer\Exclusion\ExpressionLanguageExclusionStrategy;
30
use JMS\Serializer\Expression\ExpressionEvaluatorInterface;
31
use JMS\Serializer\Handler\HandlerRegistryInterface;
32
use JMS\Serializer\Metadata\ClassMetadata;
33
use Metadata\MetadataFactoryInterface;
34
35
/**
36
 * Handles traversal along the object graph.
37
 *
38
 * This class handles traversal along the graph, and calls different methods
39
 * on visitors, or custom handlers to process its nodes.
40
 *
41
 * @author Johannes M. Schmitt <[email protected]>
42
 */
43
final class GraphNavigator
44
{
45
    const DIRECTION_SERIALIZATION = 1;
46
    const DIRECTION_DESERIALIZATION = 2;
47
48
    /**
49
     * @var ExpressionLanguageExclusionStrategy
50
     */
51
    private $expressionExclusionStrategy;
52
53
    private $dispatcher;
54
    private $metadataFactory;
55
    private $handlerRegistry;
56
    private $objectConstructor;
57
58
    /**
59
     * Parses a direction string to one of the direction constants.
60
     *
61
     * @param string $dirStr
62
     *
63
     * @return integer
64
     */
65 6
    public static function parseDirection($dirStr)
66
    {
67 6
        switch (strtolower($dirStr)) {
68 6
            case 'serialization':
69 6
                return self::DIRECTION_SERIALIZATION;
70
71 3
            case 'deserialization':
72 3
                return self::DIRECTION_DESERIALIZATION;
73
74
            default:
75
                throw new InvalidArgumentException(sprintf('The direction "%s" does not exist.', $dirStr));
76
        }
77
    }
78
79 399
    public function __construct(
80
        MetadataFactoryInterface $metadataFactory,
81
        HandlerRegistryInterface $handlerRegistry,
82
        ObjectConstructorInterface $objectConstructor,
83
        EventDispatcherInterface $dispatcher = null,
84
        ExpressionEvaluatorInterface $expressionEvaluator = null
85
    )
86
    {
87 399
        $this->dispatcher = $dispatcher;
88 399
        $this->metadataFactory = $metadataFactory;
89 399
        $this->handlerRegistry = $handlerRegistry;
90 399
        $this->objectConstructor = $objectConstructor;
91 399
        if ($expressionEvaluator) {
92 32
            $this->expressionExclusionStrategy = new ExpressionLanguageExclusionStrategy($expressionEvaluator);
93 32
        }
94 399
    }
95
96
    /**
97
     * Called for each node of the graph that is being traversed.
98
     *
99
     * @param mixed $data the data depends on the direction, and type of visitor
100
     * @param null|array $type array has the format ["name" => string, "params" => array]
101
     * @param Context $context
102
     * @return mixed the return value depends on the direction, and type of visitor
103
     */
104 372
    public function accept($data, array $type = null, Context $context)
105
    {
106 372
        $visitor = $context->getVisitor();
107
108
        // If the type was not given, we infer the most specific type from the
109
        // input data in serialization mode.
110 372
        if (null === $type) {
111 322
            if ($context instanceof DeserializationContext) {
112
                throw new RuntimeException('The type must be given for all properties when deserializing.');
113 8
            }
114
115 322
            $typeName = gettype($data);
116 322
            if ('object' === $typeName) {
117 233
                $typeName = get_class($data);
118 233
            }
119
120 322
            $type = array('name' => $typeName, 'params' => array());
121 322
        }
122
        // If the data is null, we have to force the type to null regardless of the input in order to
123
        // guarantee correct handling of null values, and not have any internal auto-casting behavior.
124 265
        else if ($context instanceof SerializationContext && null === $data) {
125 20
            $type = array('name' => 'NULL', 'params' => array());
126 20
        }
127
128
        // Sometimes data can convey null but is not of a null type.
129
        // Visitors can have the power to add this custom null evaluation
130
        if ($visitor instanceof VisitorInterface
131 372
            && $visitor instanceof NullEvaluatorInterface
132 372
            && $visitor->evaluatesToNull($data) === true
133 372
        ) {
134 7
            $type = array('name' => 'NULL', 'params' => array());
135 7
        }
136
137 372
        switch ($type['name']) {
138 372
            case 'NULL':
139 48
                return $visitor->visitNull($data, $type, $context);
140
141 359
            case 'string':
142 211
                return $visitor->visitString($data, $type, $context);
143
144 353
            case 'int':
145 353
            case 'integer':
146 65
                return $visitor->visitInteger($data, $type, $context);
147
148 348
            case 'boolean':
149 22
                return $visitor->visitBoolean($data, $type, $context);
150
151 337
            case 'double':
152 337
            case 'float':
153 34
                return $visitor->visitDouble($data, $type, $context);
154
155 322
            case 'array':
156 139
                return $visitor->visitArray($data, $type, $context);
157
158 256
            case 'resource':
159 1
                $msg = 'Resources are not supported in serialized data.';
160 1
                if ($context instanceof SerializationContext && null !== $path = $context->getPath()) {
161
                    $msg .= ' Path: ' . $path;
162
                }
163
164 1
                throw new RuntimeException($msg);
165
166 255
            default:
167
                // TODO: The rest of this method needs some refactoring.
168 255
                if ($context instanceof SerializationContext) {
169 237
                    if (null !== $data) {
170 237
                        if ($context->isVisiting($data)) {
171 3
                            return null;
172
                        }
173 237
                        $context->startVisiting($data);
174 237
                    }
175
176
                    // If we're serializing a polymorphic type, then we'll be interested in the
177
                    // metadata for the actual type of the object, not the base class.
178 237
                    if (class_exists($type['name'], false) || interface_exists($type['name'], false)) {
179 237
                        if (is_subclass_of($data, $type['name'], false)) {
0 ignored issues
show
Bug introduced by
Due to PHP Bug #53727, is_subclass_of might return inconsistent results on some PHP versions if $type['name'] can be an interface. If so, you could instead use ReflectionClass::implementsInterface.
Loading history...
180 6
                            $type = array('name' => get_class($data), 'params' => array());
181 6
                        }
182 237
                    }
183 255
                } elseif ($context instanceof DeserializationContext) {
184 72
                    $context->increaseDepth();
185 72
                }
186
187
                // Trigger pre-serialization callbacks, and listeners if they exist.
188
                // Dispatch pre-serialization event before handling data to have ability change type in listener
189 255
                if ($context instanceof SerializationContext) {
190 237
                    if (null !== $this->dispatcher && $this->dispatcher->hasListeners('serializer.pre_serialize', $type['name'], $context->getFormat())) {
191 232
                        $this->dispatcher->dispatch('serializer.pre_serialize', $type['name'], $context->getFormat(), $event = new PreSerializeEvent($context, $data, $type));
192 232
                        $type = $event->getType();
193 232
                    }
194 255
                } elseif ($context instanceof DeserializationContext) {
195 72
                    if (null !== $this->dispatcher && $this->dispatcher->hasListeners('serializer.pre_deserialize', $type['name'], $context->getFormat())) {
196
                        $this->dispatcher->dispatch('serializer.pre_deserialize', $type['name'], $context->getFormat(), $event = new PreDeserializeEvent($context, $data, $type));
197
                        $type = $event->getType();
198
                        $data = $event->getData();
199
                    }
200 72
                }
201
202
                // First, try whether a custom handler exists for the given type. This is done
203
                // before loading metadata because the type name might not be a class, but
204
                // could also simply be an artifical type.
205 255
                if (null !== $handler = $this->handlerRegistry->getHandler($context->getDirection(), $type['name'], $context->getFormat())) {
206 62
                    $rs = call_user_func($handler, $visitor, $data, $type, $context);
207 62
                    $this->leaveScope($context, $data);
208
209 62
                    return $rs;
210
                }
211
212 227
                $exclusionStrategy = $context->getExclusionStrategy();
213
214
                /** @var $metadata ClassMetadata */
215 227
                $metadata = $this->metadataFactory->getMetadataForClass($type['name']);
216
217 224
                if ($metadata->usingExpression && !$this->expressionExclusionStrategy) {
218 3
                    throw new ExpressionLanguageRequiredException("To use conditional exclude/expose in {$metadata->name} you must configure the expression language.");
219
                }
220
221 221
                if ($context instanceof DeserializationContext && !empty($metadata->discriminatorMap) && $type['name'] === $metadata->discriminatorBaseClass) {
222 13
                    $metadata = $this->resolveMetadata($data, $metadata);
223 11
                }
224
225 219
                if (null !== $exclusionStrategy && $exclusionStrategy->shouldSkipClass($metadata, $context)) {
0 ignored issues
show
Documentation introduced by
$metadata is of type object<Metadata\ClassHie...ableClassMetadata>|null, but the function expects a object<JMS\Serializer\Metadata\ClassMetadata>.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
226 6
                    $this->leaveScope($context, $data);
227
228 6
                    return null;
229
                }
230
231 219
                $context->pushClassMetadata($metadata);
0 ignored issues
show
Documentation introduced by
$metadata is of type object<Metadata\ClassHie...ableClassMetadata>|null, but the function expects a object<JMS\Serializer\Metadata\ClassMetadata>.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
232
233 219
                if ($context instanceof SerializationContext) {
234 204
                    foreach ($metadata->preSerializeMethods as $method) {
235 3
                        $method->invoke($data);
236 204
                    }
237 204
                }
238
239 219
                $object = $data;
240 219
                if ($context instanceof DeserializationContext) {
241 61
                    $object = $this->objectConstructor->construct($visitor, $metadata, $data, $type, $context);
0 ignored issues
show
Documentation introduced by
$metadata is of type object<Metadata\ClassHie...ableClassMetadata>|null, but the function expects a object<JMS\Serializer\Metadata\ClassMetadata>.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
242 61
                }
243
244 219
                if (isset($metadata->handlerCallbacks[$context->getDirection()][$context->getFormat()])) {
245 3
                    $rs = $object->{$metadata->handlerCallbacks[$context->getDirection()][$context->getFormat()]}(
246 3
                        $visitor,
247 3
                        $context instanceof SerializationContext ? null : $data,
248
                        $context
249 3
                    );
250 3
                    $this->afterVisitingObject($metadata, $object, $type, $context);
0 ignored issues
show
Documentation introduced by
$metadata is of type object<Metadata\ClassHie...MergeableClassMetadata>, but the function expects a object<JMS\Serializer\Metadata\ClassMetadata>.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
251
252 3
                    return $context instanceof SerializationContext ? $rs : $object;
253
                }
254
255 216
                $visitor->startVisitingObject($metadata, $object, $type, $context);
0 ignored issues
show
Documentation introduced by
$metadata is of type object<Metadata\ClassHie...MergeableClassMetadata>, but the function expects a object<JMS\Serializer\Metadata\ClassMetadata>.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
256 216
                foreach ($metadata->propertyMetadata as $propertyMetadata) {
257 214
                    if (null !== $exclusionStrategy && $exclusionStrategy->shouldSkipProperty($propertyMetadata, $context)) {
258 17
                        continue;
259
                    }
260
261 214
                    if (null !== $this->expressionExclusionStrategy && $this->expressionExclusionStrategy->shouldSkipProperty($propertyMetadata, $context)) {
262 23
                        continue;
263
                    }
264
265 214
                    if ($context instanceof DeserializationContext && $propertyMetadata->readOnly) {
266 17
                        continue;
267
                    }
268
269 214
                    $context->pushPropertyMetadata($propertyMetadata);
270 214
                    $visitor->visitProperty($propertyMetadata, $data, $context);
271 210
                    $context->popPropertyMetadata();
272 212
                }
273
274 210
                if ($context instanceof SerializationContext) {
275 196
                    $this->afterVisitingObject($metadata, $data, $type, $context);
0 ignored issues
show
Documentation introduced by
$metadata is of type object<Metadata\ClassHie...MergeableClassMetadata>, but the function expects a object<JMS\Serializer\Metadata\ClassMetadata>.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
276
277 196
                    return $visitor->endVisitingObject($metadata, $data, $type, $context);
0 ignored issues
show
Documentation introduced by
$metadata is of type object<Metadata\ClassHie...MergeableClassMetadata>, but the function expects a object<JMS\Serializer\Metadata\ClassMetadata>.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
278
                }
279
280 61
                $rs = $visitor->endVisitingObject($metadata, $data, $type, $context);
0 ignored issues
show
Documentation introduced by
$metadata is of type object<Metadata\ClassHie...MergeableClassMetadata>, but the function expects a object<JMS\Serializer\Metadata\ClassMetadata>.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
281 61
                $this->afterVisitingObject($metadata, $rs, $type, $context);
0 ignored issues
show
Documentation introduced by
$metadata is of type object<Metadata\ClassHie...MergeableClassMetadata>, but the function expects a object<JMS\Serializer\Metadata\ClassMetadata>.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
282
283 61
                return $rs;
284 255
        }
285
    }
286
287 13
    private function resolveMetadata($data, ClassMetadata $metadata)
288
    {
289 13
        switch (true) {
290 13
            case is_array($data) && isset($data[$metadata->discriminatorFieldName]):
291 5
                $typeValue = (string)$data[$metadata->discriminatorFieldName];
292 5
                break;
293
294
            // Check XML attribute for discriminatorFieldName
295 8
            case is_object($data) && $metadata->xmlDiscriminatorAttribute && isset($data[$metadata->discriminatorFieldName]):
296 1
                $typeValue = (string)$data[$metadata->discriminatorFieldName];
297 1
                break;
298
299
            // Check XML element with namespace for discriminatorFieldName
300 7
            case is_object($data) && !$metadata->xmlDiscriminatorAttribute && null !== $metadata->xmlDiscriminatorNamespace && isset($data->children($metadata->xmlDiscriminatorNamespace)->{$metadata->discriminatorFieldName}):
301 1
                $typeValue = (string)$data->children($metadata->xmlDiscriminatorNamespace)->{$metadata->discriminatorFieldName};
302 1
                break;
303
304
            // Check XML element for discriminatorFieldName
305 6
            case is_object($data) && isset($data->{$metadata->discriminatorFieldName}):
306 4
                $typeValue = (string)$data->{$metadata->discriminatorFieldName};
307 4
                break;
308
309 2
            default:
310 2
                throw new \LogicException(sprintf(
311 2
                    'The discriminator field name "%s" for base-class "%s" was not found in input data.',
312 2
                    $metadata->discriminatorFieldName,
313 2
                    $metadata->name
314 2
                ));
315 2
        }
316
317 11
        if (!isset($metadata->discriminatorMap[$typeValue])) {
318
            throw new \LogicException(sprintf(
319
                'The type value "%s" does not exist in the discriminator map of class "%s". Available types: %s',
320
                $typeValue,
321
                $metadata->name,
322
                implode(', ', array_keys($metadata->discriminatorMap))
323
            ));
324
        }
325
326 11
        return $this->metadataFactory->getMetadataForClass($metadata->discriminatorMap[$typeValue]);
327
    }
328
329 241
    private function leaveScope(Context $context, $data)
330
    {
331 241
        if ($context instanceof SerializationContext) {
332 226
            $context->stopVisiting($data);
333 241
        } elseif ($context instanceof DeserializationContext) {
334 69
            $context->decreaseDepth();
335 69
        }
336 241
    }
337
338 213
    private function afterVisitingObject(ClassMetadata $metadata, $object, array $type, Context $context)
339
    {
340 213
        $this->leaveScope($context, $object);
341 213
        $context->popClassMetadata();
342
343 213
        if ($context instanceof SerializationContext) {
344 199
            foreach ($metadata->postSerializeMethods as $method) {
345 3
                $method->invoke($object);
346 199
            }
347
348 199
            if (null !== $this->dispatcher && $this->dispatcher->hasListeners('serializer.post_serialize', $metadata->name, $context->getFormat())) {
349 2
                $this->dispatcher->dispatch('serializer.post_serialize', $metadata->name, $context->getFormat(), new ObjectEvent($context, $object, $type));
350 2
            }
351
352 199
            return;
353
        }
354
355 63
        foreach ($metadata->postDeserializeMethods as $method) {
356 4
            $method->invoke($object);
357 63
        }
358
359 63
        if (null !== $this->dispatcher && $this->dispatcher->hasListeners('serializer.post_deserialize', $metadata->name, $context->getFormat())) {
360 1
            $this->dispatcher->dispatch('serializer.post_deserialize', $metadata->name, $context->getFormat(), new ObjectEvent($context, $object, $type));
361 1
        }
362 63
    }
363
}
364