Debian Codegraph @

vendor/zircote/swagger-php/src/Processors/AugmentRequestBody.php

raw
1 <?php declare(strict_types=1);
2
3 /**
4 * @license Apache 2.0
5 */
6
7 namespace OpenApi\Processors;
8
9 use OpenApi\Analysis;
10 use OpenApi\Annotations as OA;
11 use OpenApi\Context;
12 use OpenApi\Generator;
13 use OpenApi\GeneratorAwareInterface;
14 use OpenApi\GeneratorAwareTrait;
15
16 /**
17 * Use the RequestBody context to extract useful information and inject that into the annotation.
18 */
19 class AugmentRequestBody implements GeneratorAwareInterface
20 {
21 use GeneratorAwareTrait;
22
23 public function __invoke(Analysis $analysis): void
24 {
25 $requestBodies = $analysis->getAnnotationsOfType(OA\RequestBody::class);
26
27 $this->augmentRequestBody($analysis, $requestBodies);
28 }
29
30 /**
31 * @param array<OA\RequestBody> $requestBodies
32 */
33 protected function augmentRequestBody(Analysis $analysis, array $requestBodies): void
34 {
35 foreach ($requestBodies as $requestBody) {
36 if (!$requestBody->isRoot(OA\RequestBody::class)) {
37 continue;
38 }
39
40 $context = $requestBody->_context;
41 if (Generator::isDefault($requestBody->request)) {
42 if ($context->is('class')) {
43 $requestBody->request = $requestBody->_context->class;
44 } elseif ($context->is('interface')) {
45 $requestBody->request = $requestBody->_context->interface;
46 } elseif ($context->is('trait')) {
47 $requestBody->request = $requestBody->_context->trait;
48 } elseif ($context->is('enum')) {
49 $requestBody->request = $requestBody->_context->enum;
50 }
51 }
52
53 if ($context->reflector instanceof \ReflectionParameter) {
54 $schema = new OA\Schema(['_context' => new Context(['reflector' => $context->reflector], $context)]);
55 $this->generator->getTypeResolver()->augmentSchemaType($analysis, $schema, OA\RequestBody::class);
56
57 if (Generator::isDefault($requestBody->ref)) {
58 $requestBody->ref = $schema->ref;
59 }
60
61 if (Generator::isDefault($requestBody->required)) {
62 $requestBody->required = !$schema->isNullable();
63 }
64 }
65 }
66 }
67 }