6981542872

Committed 24 Nov 2023 01:48PM UTC coverage: 37.261% (-0.02%) from 37.284%

Build # 6981542872

Build Type

push

github

Committed by

web-flow

Commit Message

feat(graphql): support enum collection as property (#5955)

Co-authored-by: josef.wagner <josef.wagner@hf-solutions.co>

Run Details

0 of 40 new or added lines in 6 files covered. (0.0%)

2 existing lines in 2 files now uncovered.

10287 of 27608 relevant lines covered (37.26%)

20.52 hits per line

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

0.0

/src/GraphQl/Type/TypeConverter.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\GraphQl\Type;

use ApiPlatform\Metadata\Exception\InvalidArgumentException;
use ApiPlatform\Metadata\Exception\OperationNotFoundException;
use ApiPlatform\Metadata\Exception\ResourceClassNotFoundException;
use ApiPlatform\Metadata\GraphQl\Operation;
use ApiPlatform\Metadata\GraphQl\Query;
use ApiPlatform\Metadata\Property\Factory\PropertyMetadataFactoryInterface;
use ApiPlatform\Metadata\Resource\Factory\ResourceMetadataCollectionFactoryInterface;
use GraphQL\Error\SyntaxError;
use GraphQL\Language\AST\ListTypeNode;
use GraphQL\Language\AST\NamedTypeNode;
use GraphQL\Language\AST\NonNullTypeNode;
use GraphQL\Language\AST\TypeNode;
use GraphQL\Language\Parser;
use GraphQL\Type\Definition\NullableType;
use GraphQL\Type\Definition\Type as GraphQLType;
use Symfony\Component\PropertyInfo\Type;

/**
 * Converts a type to its GraphQL equivalent.
 *
 * @author Alan Poulain <contact@alanpoulain.eu>
 */
final class TypeConverter implements TypeConverterInterface
{
    public function __construct(private readonly TypeBuilderEnumInterface|TypeBuilderInterface $typeBuilder, private readonly TypesContainerInterface $typesContainer, private readonly ResourceMetadataCollectionFactoryInterface $resourceMetadataCollectionFactory, private readonly PropertyMetadataFactoryInterface $propertyMetadataFactory)
    {
        if ($typeBuilder instanceof TypeBuilderInterface) {
            @trigger_error(sprintf('$typeBuilder argument of TypeConverter implementing "%s" is deprecated since API Platform 3.1. It has to implement "%s" instead.', TypeBuilderInterface::class, TypeBuilderEnumInterface::class), \E_USER_DEPRECATED);
        }
    }

    /**
     * {@inheritdoc}
     */
    public function convertType(Type $type, bool $input, Operation $rootOperation, string $resourceClass, string $rootResource, ?string $property, int $depth): GraphQLType|string|null
    {
        switch ($type->getBuiltinType()) {
            case Type::BUILTIN_TYPE_BOOL:
                return GraphQLType::boolean();
            case Type::BUILTIN_TYPE_INT:
                return GraphQLType::int();
            case Type::BUILTIN_TYPE_FLOAT:
                return GraphQLType::float();
            case Type::BUILTIN_TYPE_STRING:
                return GraphQLType::string();
            case Type::BUILTIN_TYPE_ARRAY:
            case Type::BUILTIN_TYPE_ITERABLE:
                if ($resourceType = $this->getResourceType($type, $input, $rootOperation, $rootResource, $property, $depth)) {
                    return $resourceType;
                }

                return 'Iterable';
            case Type::BUILTIN_TYPE_OBJECT:
                if (is_a($type->getClassName(), \DateTimeInterface::class, true)) {
                    return GraphQLType::string();
                }

                return $this->getResourceType($type, $input, $rootOperation, $rootResource, $property, $depth);
            default:
                return null;
        }
    }

    /**
     * {@inheritdoc}
     */
    public function resolveType(string $type): ?GraphQLType
    {
        try {
            $astTypeNode = Parser::parseType($type);
        } catch (SyntaxError $e) {
            throw new InvalidArgumentException(sprintf('"%s" is not a valid GraphQL type.', $type), 0, $e);
        }

        if ($graphQlType = $this->resolveAstTypeNode($astTypeNode, $type)) {
            return $graphQlType;
        }

        throw new InvalidArgumentException(sprintf('The type "%s" was not resolved.', $type));
    }

    private function getResourceType(Type $type, bool $input, Operation $rootOperation, string $rootResource, ?string $property, int $depth): ?GraphQLType
    {
        if (
            $this->typeBuilder->isCollection($type)
            && $collectionValueType = $type->getCollectionValueTypes()[0] ?? null
        ) {
            $resourceClass = $collectionValueType->getClassName();
        } else {
            $resourceClass = $type->getClassName();
        }

        if (null === $resourceClass) {
            return null;
        }

        try {
            $resourceMetadataCollection = $this->resourceMetadataCollectionFactory->create($resourceClass);
        } catch (ResourceClassNotFoundException) {
            return null;
        }

        $hasGraphQl = false;
        foreach ($resourceMetadataCollection as $resourceMetadata) {
            if (null !== $resourceMetadata->getGraphQlOperations()) {
                $hasGraphQl = true;
                break;
            }
        }

        if (isset($resourceMetadataCollection[0]) && 'Node' === $resourceMetadataCollection[0]->getShortName()) {
            throw new \UnexpectedValueException('A "Node" resource cannot be used with GraphQL because the type is already used by the Relay specification.');
        }

        if (!$hasGraphQl) {
            if (is_a($resourceClass, \BackedEnum::class, true)) {
                // Remove the condition in API Platform 4.
                if ($this->typeBuilder instanceof TypeBuilderEnumInterface) {
                    $operation = null;
                    try {
                        $resourceMetadataCollection = $this->resourceMetadataCollectionFactory->create($resourceClass);
                        $operation = $resourceMetadataCollection->getOperation();
                    } catch (ResourceClassNotFoundException|OperationNotFoundException) {
                    }
                    /** @var Query $enumOperation */
                    $enumOperation = (new Query())
                        ->withClass($resourceClass)
                        ->withShortName($operation?->getShortName() ?? (new \ReflectionClass($resourceClass))->getShortName())
                        ->withDescription($operation?->getDescription());

                    return $this->typeBuilder->getEnumType($enumOperation);
                }
            }

            return null;
        }

        $propertyMetadata = null;
        if ($property) {
            $context = [
                'normalization_groups' => $rootOperation->getNormalizationContext()['groups'] ?? null,
                'denormalization_groups' => $rootOperation->getDenormalizationContext()['groups'] ?? null,
            ];
            $propertyMetadata = $this->propertyMetadataFactory->create($rootResource, $property, $context);
        }

        if ($input && $depth > 0 && (!$propertyMetadata || !$propertyMetadata->isWritableLink())) {
            return GraphQLType::string();
        }

        $operationName = $rootOperation->getName();
        $isCollection = $this->typeBuilder->isCollection($type);

        // We're retrieving the type of a property which is a relation to the root resource.
        if ($resourceClass !== $rootResource && $rootOperation instanceof Query) {
            $operationName = $isCollection ? 'collection_query' : 'item_query';
        }

        try {
            $operation = $resourceMetadataCollection->getOperation($operationName);
        } catch (OperationNotFoundException) {
            $operation = $resourceMetadataCollection->getOperation($isCollection ? 'collection_query' : 'item_query');
        }
        if (!$operation instanceof Operation) {
            throw new OperationNotFoundException();
        }

        return $this->typeBuilder->getResourceObjectType($resourceClass, $resourceMetadataCollection, $operation, $input, false, $depth);
    }

    private function resolveAstTypeNode(TypeNode $astTypeNode, string $fromType): ?GraphQLType
    {
        if ($astTypeNode instanceof NonNullTypeNode) {
            /** @var NullableType|null $nullableAstTypeNode */
            $nullableAstTypeNode = $this->resolveNullableAstTypeNode($astTypeNode->type, $fromType);

            return $nullableAstTypeNode ? GraphQLType::nonNull($nullableAstTypeNode) : null;
        }

        return $this->resolveNullableAstTypeNode($astTypeNode, $fromType);
    }

    private function resolveNullableAstTypeNode(TypeNode $astTypeNode, string $fromType): ?GraphQLType
    {
        if ($astTypeNode instanceof ListTypeNode) {
            /** @var TypeNode $astTypeNodeElement */
            $astTypeNodeElement = $astTypeNode->type;

            return GraphQLType::listOf($this->resolveAstTypeNode($astTypeNodeElement, $fromType));
        }

        if (!$astTypeNode instanceof NamedTypeNode) {
            return null;
        }

        $typeName = $astTypeNode->name->value;

        return match ($typeName) {
            GraphQLType::STRING => GraphQLType::string(),
            GraphQLType::INT => GraphQLType::int(),
            GraphQLType::BOOLEAN => GraphQLType::boolean(),
            GraphQLType::FLOAT => GraphQLType::float(),
            GraphQLType::ID => GraphQLType::id(),
            default => $this->typesContainer->has($typeName) ? $this->typesContainer->get($typeName) : null,
        };
    }
}

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\GraphQl\Type;
15
16	use ApiPlatform\Metadata\Exception\InvalidArgumentException;
17	use ApiPlatform\Metadata\Exception\OperationNotFoundException;
18	use ApiPlatform\Metadata\Exception\ResourceClassNotFoundException;
19	use ApiPlatform\Metadata\GraphQl\Operation;
20	use ApiPlatform\Metadata\GraphQl\Query;
21	use ApiPlatform\Metadata\Property\Factory\PropertyMetadataFactoryInterface;
22	use ApiPlatform\Metadata\Resource\Factory\ResourceMetadataCollectionFactoryInterface;
23	use GraphQL\Error\SyntaxError;
24	use GraphQL\Language\AST\ListTypeNode;
25	use GraphQL\Language\AST\NamedTypeNode;
26	use GraphQL\Language\AST\NonNullTypeNode;
27	use GraphQL\Language\AST\TypeNode;
28	use GraphQL\Language\Parser;
29	use GraphQL\Type\Definition\NullableType;
30	use GraphQL\Type\Definition\Type as GraphQLType;
31	use Symfony\Component\PropertyInfo\Type;
32
33	/**
34	* Converts a type to its GraphQL equivalent.
35	*
36	* @author Alan Poulain <contact@alanpoulain.eu>
37	*/
38	final class TypeConverter implements TypeConverterInterface
39	{
40	public function __construct(private readonly TypeBuilderEnumInterface\|TypeBuilderInterface $typeBuilder, private readonly TypesContainerInterface $typesContainer, private readonly ResourceMetadataCollectionFactoryInterface $resourceMetadataCollectionFactory, private readonly PropertyMetadataFactoryInterface $propertyMetadataFactory)
41	{
42	if ($typeBuilder instanceof TypeBuilderInterface) {	×
43	@trigger_error(sprintf('$typeBuilder argument of TypeConverter implementing "%s" is deprecated since API Platform 3.1. It has to implement "%s" instead.', TypeBuilderInterface::class, TypeBuilderEnumInterface::class), \E_USER_DEPRECATED);	×
44	}
45	}
46
47	/**
48	* {@inheritdoc}
49	*/
50	public function convertType(Type $type, bool $input, Operation $rootOperation, string $resourceClass, string $rootResource, ?string $property, int $depth): GraphQLType\|string\|null
51	{
52	switch ($type->getBuiltinType()) {	×
53	case Type::BUILTIN_TYPE_BOOL:
54	return GraphQLType::boolean();	×
55	case Type::BUILTIN_TYPE_INT:
56	return GraphQLType::int();	×
57	case Type::BUILTIN_TYPE_FLOAT:
58	return GraphQLType::float();	×
59	case Type::BUILTIN_TYPE_STRING:
60	return GraphQLType::string();	×
61	case Type::BUILTIN_TYPE_ARRAY:
62	case Type::BUILTIN_TYPE_ITERABLE:
63	if ($resourceType = $this->getResourceType($type, $input, $rootOperation, $rootResource, $property, $depth)) {	×
64	return $resourceType;	×
65	}
66
67	return 'Iterable';	×
68	case Type::BUILTIN_TYPE_OBJECT:
69	if (is_a($type->getClassName(), \DateTimeInterface::class, true)) {	×
70	return GraphQLType::string();	×
71	}
72
NEW 73	return $this->getResourceType($type, $input, $rootOperation, $rootResource, $property, $depth);	×
74	default:
75	return null;	×
76	}
77	}
78
79	/**
80	* {@inheritdoc}
81	*/
82	public function resolveType(string $type): ?GraphQLType
83	{
84	try {
85	$astTypeNode = Parser::parseType($type);	×
86	} catch (SyntaxError $e) {	×
87	throw new InvalidArgumentException(sprintf('"%s" is not a valid GraphQL type.', $type), 0, $e);	×
88	}
89
90	if ($graphQlType = $this->resolveAstTypeNode($astTypeNode, $type)) {	×
91	return $graphQlType;	×
92	}
93
94	throw new InvalidArgumentException(sprintf('The type "%s" was not resolved.', $type));	×
95	}
96
97	private function getResourceType(Type $type, bool $input, Operation $rootOperation, string $rootResource, ?string $property, int $depth): ?GraphQLType
98	{
99	if (
100	$this->typeBuilder->isCollection($type)	×
101	&& $collectionValueType = $type->getCollectionValueTypes()[0] ?? null	×
102	) {
103	$resourceClass = $collectionValueType->getClassName();	×
104	} else {
105	$resourceClass = $type->getClassName();	×
106	}
107
108	if (null === $resourceClass) {	×
109	return null;	×
110	}
111
112	try {
113	$resourceMetadataCollection = $this->resourceMetadataCollectionFactory->create($resourceClass);	×
114	} catch (ResourceClassNotFoundException) {	×
115	return null;	×
116	}
117
118	$hasGraphQl = false;	×
119	foreach ($resourceMetadataCollection as $resourceMetadata) {	×
120	if (null !== $resourceMetadata->getGraphQlOperations()) {	×
121	$hasGraphQl = true;	×
122	break;	×
123	}
124	}
125
126	if (isset($resourceMetadataCollection[0]) && 'Node' === $resourceMetadataCollection[0]->getShortName()) {	×
127	throw new \UnexpectedValueException('A "Node" resource cannot be used with GraphQL because the type is already used by the Relay specification.');	×
128	}
129
130	if (!$hasGraphQl) {	×
NEW 131	if (is_a($resourceClass, \BackedEnum::class, true)) {	×
132	// Remove the condition in API Platform 4.
NEW 133	if ($this->typeBuilder instanceof TypeBuilderEnumInterface) {	×
NEW 134	$operation = null;	×
135	try {
NEW 136	$resourceMetadataCollection = $this->resourceMetadataCollectionFactory->create($resourceClass);	×
NEW 137	$operation = $resourceMetadataCollection->getOperation();	×
NEW 138	} catch (ResourceClassNotFoundException\|OperationNotFoundException) {	×
139	}
140	/** @var Query $enumOperation */
NEW 141	$enumOperation = (new Query())	×
NEW 142	->withClass($resourceClass)	×
NEW 143	->withShortName($operation?->getShortName() ?? (new \ReflectionClass($resourceClass))->getShortName())	×
NEW 144	->withDescription($operation?->getDescription());	×
145
NEW 146	return $this->typeBuilder->getEnumType($enumOperation);	×
147	}
148	}
149
UNCOV 150	return null;	×
151	}
152
153	$propertyMetadata = null;	×
154	if ($property) {	×
155	$context = [	×
156	'normalization_groups' => $rootOperation->getNormalizationContext()['groups'] ?? null,	×
157	'denormalization_groups' => $rootOperation->getDenormalizationContext()['groups'] ?? null,	×
158	];	×
159	$propertyMetadata = $this->propertyMetadataFactory->create($rootResource, $property, $context);	×
160	}
161
162	if ($input && $depth > 0 && (!$propertyMetadata \|\| !$propertyMetadata->isWritableLink())) {	×
163	return GraphQLType::string();	×
164	}
165
166	$operationName = $rootOperation->getName();	×
167	$isCollection = $this->typeBuilder->isCollection($type);	×
168
169	// We're retrieving the type of a property which is a relation to the root resource.
170	if ($resourceClass !== $rootResource && $rootOperation instanceof Query) {	×
171	$operationName = $isCollection ? 'collection_query' : 'item_query';	×
172	}
173
174	try {
175	$operation = $resourceMetadataCollection->getOperation($operationName);	×
176	} catch (OperationNotFoundException) {	×
177	$operation = $resourceMetadataCollection->getOperation($isCollection ? 'collection_query' : 'item_query');	×
178	}
179	if (!$operation instanceof Operation) {	×
180	throw new OperationNotFoundException();	×
181	}
182
183	return $this->typeBuilder->getResourceObjectType($resourceClass, $resourceMetadataCollection, $operation, $input, false, $depth);	×
184	}
185
186	private function resolveAstTypeNode(TypeNode $astTypeNode, string $fromType): ?GraphQLType
187	{
188	if ($astTypeNode instanceof NonNullTypeNode) {	×
189	/** @var NullableType\|null $nullableAstTypeNode */
190	$nullableAstTypeNode = $this->resolveNullableAstTypeNode($astTypeNode->type, $fromType);	×
191
192	return $nullableAstTypeNode ? GraphQLType::nonNull($nullableAstTypeNode) : null;	×
193	}
194
195	return $this->resolveNullableAstTypeNode($astTypeNode, $fromType);	×
196	}
197
198	private function resolveNullableAstTypeNode(TypeNode $astTypeNode, string $fromType): ?GraphQLType
199	{
200	if ($astTypeNode instanceof ListTypeNode) {	×
201	/** @var TypeNode $astTypeNodeElement */
202	$astTypeNodeElement = $astTypeNode->type;	×
203
204	return GraphQLType::listOf($this->resolveAstTypeNode($astTypeNodeElement, $fromType));	×
205	}
206
207	if (!$astTypeNode instanceof NamedTypeNode) {	×
208	return null;	×
209	}
210
211	$typeName = $astTypeNode->name->value;	×
212
213	return match ($typeName) {	×
214	GraphQLType::STRING => GraphQLType::string(),	×
215	GraphQLType::INT => GraphQLType::int(),	×
216	GraphQLType::BOOLEAN => GraphQLType::boolean(),	×
217	GraphQLType::FLOAT => GraphQLType::float(),	×
218	GraphQLType::ID => GraphQLType::id(),	×
219	default => $this->typesContainer->has($typeName) ? $this->typesContainer->get($typeName) : null,	×
220	};	×
221	}
222	}

api-platform / core / 6981542872

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