9562658349

Committed 18 Jun 2024 09:35AM UTC coverage: 62.637% (+0.4%) from 62.272%

Build # 9562658349

Build Type

push

github

Committed by

soyuka

Commit Message

Merge 3.4

Run Details

52 of 55 new or added lines in 6 files covered. (94.55%)

236 existing lines in 20 files now uncovered.

11016 of 17587 relevant lines covered (62.64%)

60.45 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

90.0

/src/Symfony/EventListener/WriteListener.php

<?php

/*
 * This file is part of the API Platform project.
 *
 * (c) Kévin Dunglas <dunglas@gmail.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

declare(strict_types=1);

namespace ApiPlatform\Symfony\EventListener;

use ApiPlatform\Api\IriConverterInterface as LegacyIriConverterInterface;
use ApiPlatform\Api\ResourceClassResolverInterface as LegacyResourceClassResolverInterface;
use ApiPlatform\Api\UriVariablesConverterInterface as LegacyUriVariablesConverterInterface;
use ApiPlatform\Exception\InvalidIdentifierException;
use ApiPlatform\Metadata\Error;
use ApiPlatform\Metadata\Exception\InvalidUriVariableException;
use ApiPlatform\Metadata\HttpOperation;
use ApiPlatform\Metadata\IriConverterInterface;
use ApiPlatform\Metadata\Resource\Factory\ResourceMetadataCollectionFactoryInterface;
use ApiPlatform\Metadata\ResourceClassResolverInterface;
use ApiPlatform\Metadata\UriVariablesConverterInterface;
use ApiPlatform\Metadata\Util\ClassInfoTrait;
use ApiPlatform\Metadata\Util\CloneTrait;
use ApiPlatform\State\CallableProcessor;
use ApiPlatform\State\Processor\WriteProcessor;
use ApiPlatform\State\ProcessorInterface;
use ApiPlatform\State\UriVariablesResolverTrait;
use ApiPlatform\State\Util\OperationRequestInitiatorTrait;
use ApiPlatform\Symfony\Util\RequestAttributesExtractor;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\HttpKernel\Event\ViewEvent;
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;

/**
 * Bridges persistence and the API system.
 *
 * @author Kévin Dunglas <dunglas@gmail.com>
 * @author Baptiste Meyer <baptiste.meyer@gmail.com>
 */
final class WriteListener
{
    use ClassInfoTrait;
    use CloneTrait;
    use OperationRequestInitiatorTrait;
    use UriVariablesResolverTrait;

    private LegacyIriConverterInterface|IriConverterInterface|null $iriConverter = null;

    /**
     * @param ProcessorInterface<mixed, mixed> $processor
     */
    public function __construct(
        private readonly ProcessorInterface $processor,
        LegacyIriConverterInterface|IriConverterInterface|ResourceMetadataCollectionFactoryInterface|null $iriConverter = null,
        private readonly ResourceClassResolverInterface|LegacyResourceClassResolverInterface|null $resourceClassResolver = null,
        ?ResourceMetadataCollectionFactoryInterface $resourceMetadataCollectionFactory = null,
        LegacyUriVariablesConverterInterface|UriVariablesConverterInterface|null $uriVariablesConverter = null,
    ) {
        $this->uriVariablesConverter = $uriVariablesConverter;

        if ($processor instanceof CallableProcessor) {
            trigger_deprecation('api-platform/core', '3.3', 'Use a "%s" as first argument in "%s" instead of "%s".', WriteProcessor::class, self::class, $processor::class);
        }

        if ($iriConverter instanceof ResourceMetadataCollectionFactoryInterface) {
            $resourceMetadataCollectionFactory = $iriConverter;
        } else {
            $this->iriConverter = $iriConverter;
            trigger_deprecation('api-platform/core', '3.3', 'Use a "%s" as second argument in "%s" instead of "%s".', ResourceMetadataCollectionFactoryInterface::class, self::class, IriConverterInterface::class);
        }

        $this->resourceMetadataCollectionFactory = $resourceMetadataCollectionFactory;
    }

    /**
     * Persists, updates or delete data return by the controller if applicable.
     */
    public function onKernelView(ViewEvent $event): void
    {
        $controllerResult = $event->getControllerResult();
        $request = $event->getRequest();
        $operation = $this->initializeOperation($request);

        if (!($attributes = RequestAttributesExtractor::extractAttributes($request)) || !$attributes['persist']) {
            return;
        }

        if ($operation && (!$this->processor instanceof CallableProcessor && !$this->iriConverter)) {
            if (null === $operation->canWrite()) {
                $operation = $operation->withWrite(!$request->isMethodSafe());
            }

            $uriVariables = $request->attributes->get('_api_uri_variables') ?? [];
            if (!$uriVariables && !$operation instanceof Error && $operation instanceof HttpOperation) {
                try {
                    $uriVariables = $this->getOperationUriVariables($operation, $request->attributes->all(), $operation->getClass());
                } catch (InvalidIdentifierException|InvalidUriVariableException $e) {
                    throw new NotFoundHttpException('Invalid identifier value or configuration.', $e);
                }
            }

            $data = $this->processor->process($controllerResult, $operation, $uriVariables, [
                'request' => $request,
                'uri_variables' => $uriVariables,
                'resource_class' => $operation->getClass(),
                'previous_data' => false === $operation->canRead() ? null : $request->attributes->get('previous_data'),
            ]);

            if ($data) {
                $request->attributes->set('original_data', $data);
            }

            $event->setControllerResult($data);

            return;
        }

        // API Platform 3.2 has a MainController where everything is handled by processors/providers
        if ('api_platform.symfony.main_controller' === $operation?->getController() || $request->attributes->get('_api_platform_disable_listeners')) {
            return;
        }

        if (
            $controllerResult instanceof Response
            || $request->isMethodSafe()
            || !($attributes = RequestAttributesExtractor::extractAttributes($request))
        ) {
            return;
        }

        if (!$attributes['persist'] || !($operation?->canWrite() ?? true)) {
            return;
        }

        if (!$operation?->getProcessor()) {
            return;
        }

        $context = [
            'operation' => $operation,
            'resource_class' => $attributes['resource_class'],
            'previous_data' => $attributes['previous_data'] ?? null,
        ];

        try {
            $uriVariables = $this->getOperationUriVariables($operation, $request->attributes->all(), $attributes['resource_class']);
        } catch (InvalidIdentifierException $e) {
            throw new NotFoundHttpException('Invalid identifier value or configuration.', $e);
        }

        switch ($request->getMethod()) {
            case 'PUT':
            case 'PATCH':
            case 'POST':
                $persistResult = $this->processor->process($controllerResult, $operation, $uriVariables, $context);

                if ($persistResult) {
                    $controllerResult = $persistResult;
                    $event->setControllerResult($controllerResult);
                }

                if ($controllerResult instanceof Response) {
                    break;
                }

                $outputMetadata = $operation->getOutput() ?? ['class' => $attributes['resource_class']];
                $hasOutput = \is_array($outputMetadata) && \array_key_exists('class', $outputMetadata) && null !== $outputMetadata['class'];
                if (!$hasOutput) {
                    break;
                }

                if ($this->resourceClassResolver->isResourceClass($this->getObjectClass($controllerResult))) {
                    $request->attributes->set('_api_write_item_iri', $this->iriConverter->getIriFromResource($controllerResult));
                }

                break;
            case 'DELETE':
                $this->processor->process($controllerResult, $operation, $uriVariables, $context);
                $event->setControllerResult(null);
                break;
        }
    }
}

1	<?php
2
3	/*
4	* This file is part of the API Platform project.
5	*
6	* (c) Kévin Dunglas <dunglas@gmail.com>
7	*
8	* For the full copyright and license information, please view the LICENSE
9	* file that was distributed with this source code.
10	*/
11
12	declare(strict_types=1);
13
14	namespace ApiPlatform\Symfony\EventListener;
15
16	use ApiPlatform\Api\IriConverterInterface as LegacyIriConverterInterface;
17	use ApiPlatform\Api\ResourceClassResolverInterface as LegacyResourceClassResolverInterface;
18	use ApiPlatform\Api\UriVariablesConverterInterface as LegacyUriVariablesConverterInterface;
19	use ApiPlatform\Exception\InvalidIdentifierException;
20	use ApiPlatform\Metadata\Error;
21	use ApiPlatform\Metadata\Exception\InvalidUriVariableException;
22	use ApiPlatform\Metadata\HttpOperation;
23	use ApiPlatform\Metadata\IriConverterInterface;
24	use ApiPlatform\Metadata\Resource\Factory\ResourceMetadataCollectionFactoryInterface;
25	use ApiPlatform\Metadata\ResourceClassResolverInterface;
26	use ApiPlatform\Metadata\UriVariablesConverterInterface;
27	use ApiPlatform\Metadata\Util\ClassInfoTrait;
28	use ApiPlatform\Metadata\Util\CloneTrait;
29	use ApiPlatform\State\CallableProcessor;
30	use ApiPlatform\State\Processor\WriteProcessor;
31	use ApiPlatform\State\ProcessorInterface;
32	use ApiPlatform\State\UriVariablesResolverTrait;
33	use ApiPlatform\State\Util\OperationRequestInitiatorTrait;
34	use ApiPlatform\Symfony\Util\RequestAttributesExtractor;
35	use Symfony\Component\HttpFoundation\Response;
36	use Symfony\Component\HttpKernel\Event\ViewEvent;
37	use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
38
39	/**
40	* Bridges persistence and the API system.
41	*
42	* @author Kévin Dunglas <dunglas@gmail.com>
43	* @author Baptiste Meyer <baptiste.meyer@gmail.com>
44	*/
45	final class WriteListener
46	{
47	use ClassInfoTrait;
48	use CloneTrait;
49	use OperationRequestInitiatorTrait;
50	use UriVariablesResolverTrait;
51
52	private LegacyIriConverterInterface\|IriConverterInterface\|null $iriConverter = null;
53
54	/**
55	* @param ProcessorInterface<mixed, mixed> $processor
56	*/
57	public function __construct(
58	private readonly ProcessorInterface $processor,
59	LegacyIriConverterInterface\|IriConverterInterface\|ResourceMetadataCollectionFactoryInterface\|null $iriConverter = null,
60	private readonly ResourceClassResolverInterface\|LegacyResourceClassResolverInterface\|null $resourceClassResolver = null,
61	?ResourceMetadataCollectionFactoryInterface $resourceMetadataCollectionFactory = null,
62	LegacyUriVariablesConverterInterface\|UriVariablesConverterInterface\|null $uriVariablesConverter = null,
63	) {
64	$this->uriVariablesConverter = $uriVariablesConverter;	36✔
65
66	if ($processor instanceof CallableProcessor) {	36✔
67	trigger_deprecation('api-platform/core', '3.3', 'Use a "%s" as first argument in "%s" instead of "%s".', WriteProcessor::class, self::class, $processor::class);	×
68	}
69
70	if ($iriConverter instanceof ResourceMetadataCollectionFactoryInterface) {	36✔
71	$resourceMetadataCollectionFactory = $iriConverter;	×
72	} else {
73	$this->iriConverter = $iriConverter;	36✔
74	trigger_deprecation('api-platform/core', '3.3', 'Use a "%s" as second argument in "%s" instead of "%s".', ResourceMetadataCollectionFactoryInterface::class, self::class, IriConverterInterface::class);	36✔
75	}
76
77	$this->resourceMetadataCollectionFactory = $resourceMetadataCollectionFactory;	36✔
78	}
79
80	/**
81	* Persists, updates or delete data return by the controller if applicable.
82	*/
83	public function onKernelView(ViewEvent $event): void
84	{
85	$controllerResult = $event->getControllerResult();	36✔
86	$request = $event->getRequest();	36✔
87	$operation = $this->initializeOperation($request);	36✔
88
89	if (!($attributes = RequestAttributesExtractor::extractAttributes($request)) \|\| !$attributes['persist']) {	36✔
90	return;	8✔
91	}
92
93	if ($operation && (!$this->processor instanceof CallableProcessor && !$this->iriConverter)) {	28✔
94	if (null === $operation->canWrite()) {	4✔
95	$operation = $operation->withWrite(!$request->isMethodSafe());	4✔
96	}
97
98	$uriVariables = $request->attributes->get('_api_uri_variables') ?? [];	4✔
99	if (!$uriVariables && !$operation instanceof Error && $operation instanceof HttpOperation) {	4✔
100	try {
101	$uriVariables = $this->getOperationUriVariables($operation, $request->attributes->all(), $operation->getClass());	4✔
102	} catch (InvalidIdentifierException\|InvalidUriVariableException $e) {	×
103	throw new NotFoundHttpException('Invalid identifier value or configuration.', $e);	×
104	}
105	}
106
107	$data = $this->processor->process($controllerResult, $operation, $uriVariables, [	4✔
108	'request' => $request,	4✔
109	'uri_variables' => $uriVariables,	4✔
110	'resource_class' => $operation->getClass(),	4✔
111	'previous_data' => false === $operation->canRead() ? null : $request->attributes->get('previous_data'),	4✔
112	]);	4✔
113
114	if ($data) {	4✔
115	$request->attributes->set('original_data', $data);	4✔
116	}
117
118	$event->setControllerResult($data);	4✔
119
120	return;	4✔
121	}
122
123	// API Platform 3.2 has a MainController where everything is handled by processors/providers
124	if ('api_platform.symfony.main_controller' === $operation?->getController() \|\| $request->attributes->get('_api_platform_disable_listeners')) {	24✔
UNCOV 125	return;	×
126	}
127
128	if (
129	$controllerResult instanceof Response	24✔
130	\|\| $request->isMethodSafe()	24✔
131	\|\| !($attributes = RequestAttributesExtractor::extractAttributes($request))	24✔
132	) {
133	return;	4✔
134	}
135
136	if (!$attributes['persist'] \|\| !($operation?->canWrite() ?? true)) {	20✔
137	return;	4✔
138	}
139
140	if (!$operation?->getProcessor()) {	16✔
UNCOV 141	return;	×
142	}
143
144	$context = [	16✔
145	'operation' => $operation,	16✔
146	'resource_class' => $attributes['resource_class'],	16✔
147	'previous_data' => $attributes['previous_data'] ?? null,	16✔
148	];	16✔
149
150	try {
151	$uriVariables = $this->getOperationUriVariables($operation, $request->attributes->all(), $attributes['resource_class']);	16✔
152	} catch (InvalidIdentifierException $e) {	4✔
153	throw new NotFoundHttpException('Invalid identifier value or configuration.', $e);	4✔
154	}
155
156	switch ($request->getMethod()) {	12✔
157	case 'PUT':	12✔
158	case 'PATCH':	12✔
159	case 'POST':	12✔
160	$persistResult = $this->processor->process($controllerResult, $operation, $uriVariables, $context);	8✔
161
162	if ($persistResult) {	8✔
163	$controllerResult = $persistResult;	8✔
164	$event->setControllerResult($controllerResult);	8✔
165	}
166
167	if ($controllerResult instanceof Response) {	8✔
UNCOV 168	break;	×
169	}
170
171	$outputMetadata = $operation->getOutput() ?? ['class' => $attributes['resource_class']];	8✔
172	$hasOutput = \is_array($outputMetadata) && \array_key_exists('class', $outputMetadata) && null !== $outputMetadata['class'];	8✔
173	if (!$hasOutput) {	8✔
174	break;	4✔
175	}
176
177	if ($this->resourceClassResolver->isResourceClass($this->getObjectClass($controllerResult))) {	4✔
178	$request->attributes->set('_api_write_item_iri', $this->iriConverter->getIriFromResource($controllerResult));	4✔
179	}
180
181	break;	4✔
182	case 'DELETE':	4✔
183	$this->processor->process($controllerResult, $operation, $uriVariables, $context);	4✔
184	$event->setControllerResult(null);	4✔
185	break;	4✔
186	}
187	}
188	}

api-platform / core / 9562658349

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous