Cherrypicked GraphQL changes from 4.6

Author: mnocon

code_samples/api/graphql/config/services.yaml

@@ -0,0 +1,5 @@
+services:
+    App\GraphQL\Schema\MyFieldDefinitionMapper:
+        decorates: Ibexa\GraphQL\Schema\Domain\Content\Mapper\FieldDefinition\DecoratingFieldDefinitionMapper
+        arguments:
+            $innerMapper: '@.inner'

code_samples/api/graphql/src/GraphQL/Schema/MyCustomFieldDefinitionMapper.php

@@ -0,0 +1,37 @@
+<?php declare(strict_types=1);
+
+namespace App\GraphQL\Schema;
+
+use Ibexa\Contracts\Core\Repository\Values\ContentType\ContentType;
+use Ibexa\Contracts\Core\Repository\Values\ContentType\FieldDefinition;
+use Ibexa\Contracts\GraphQL\Schema\Domain\Content\Mapper\FieldDefinition\FieldDefinitionMapper;
+use Ibexa\GraphQL\Schema\Domain\Content\Mapper\FieldDefinition\DecoratingFieldDefinitionMapper;
+use Symfony\Component\Serializer\NameConverter\CamelCaseToSnakeCaseNameConverter;
+
+class MyFieldDefinitionMapper extends DecoratingFieldDefinitionMapper implements FieldDefinitionMapper
+{
+    protected function getFieldTypeIdentifier(): string
+    {
+        return 'my_field_type';
+    }
+
+    public function mapToFieldValueInputType(ContentType $contentType, FieldDefinition $fieldDefinition): ?string
+    {
+        if (!$this->canMap($fieldDefinition)) {
+            return parent::mapToFieldValueInputType($contentType, $fieldDefinition);
+        }
+
+        return $this->nameMyFieldInputType($contentType, $fieldDefinition);
+    }
+
+    private function nameMyFieldInputType(ContentType $contentType, FieldDefinition $fieldDefinition): string
+    {
+        $converter = new CamelCaseToSnakeCaseNameConverter(null, false);
+
+        return sprintf(
+            '%s%sInput',
+            $converter->denormalize($contentType->identifier),
+            $converter->denormalize($fieldDefinition->identifier)
+        );
+    }
+}

code_samples/api/graphql/src/GraphQL/Schema/MyFieldDefinitionMapper.php

@@ -50,21 +50,17 @@ The `FieldDefinitionMapper` API uses service decorators.
 To register your own mapper, make it decorate the `Ibexa\GraphQL\Schema\Domain\Content\Mapper\FieldDefinition\DecoratingFieldDefinitionMapper` service:
 
 ```yaml
-services:
-    App\GraphQL\Schema\MyCustomFieldDefinitionMapper:
-        decorates: Ibexa\GraphQL\Schema\Domain\Content\Mapper\FieldDefinition\DecoratingFieldDefinitionMapper
-        arguments:
-            $innerMapper: '@.inner'
+[[= include_file('code_samples/api/graphql/config/services.yaml') =]]
 ```
 
 The `$innerMapper` argument passes the decorated mapper to the constructor.
 You can use the `DecoratingFieldDefinitionMapper` from the `graphql` package.
 It requires that you implement the `getFieldTypeIdentifier` method to tell which field type is covered by the mapper.
 
-Add `MyCustomFieldDefinitionMapper.php` mapper to `src/GraphQL/Schema`:
+Add `MyFieldDefinitionMapper.php` mapper to `src/GraphQL/Schema`:
 
 ``` php
-[[= include_file('code_samples/api/graphql/src/GraphQL/Schema/MyCustomFieldDefinitionMapper.php') =]]
+[[= include_file('code_samples/api/graphql/src/GraphQL/Schema/MyFieldDefinitionMapper.php', 0, 16) =]][[= include_file('code_samples/api/graphql/src/GraphQL/Schema/MyFieldDefinitionMapper.php', 36, 37) =]]
 ```
 
 The `FieldDefinitionMapper` interface defines following methods:
@@ -79,59 +75,12 @@ When a mapper method is decorated, you need to call the decorated service method
 To do that, you need to replace `mapXXX` by the method it's in:
 
 ```php
-        if (!$this->canMap($fieldDefinition)) {
-             return parent::mapToFieldValueType($fieldDefinition);
-         }
+[[= include_file('code_samples/api/graphql/src/GraphQL/Schema/MyFieldDefinitionMapper.php', 19, 22, remove_indent=True) =]]
 ```
 
 It's required for every implemented method, so that other mappers are called for the other field types.
 
-The [`RelationFieldDefinitionMapper`](https://github.com/ibexa/graphql/blob/main/src/lib/Schema/Domain/Content/Mapper/FieldDefinition/RelationFieldDefinitionMapper.php) example:
-
-```php hl_lines="14"
-class RelationFieldDefinitionMapper extends DecoratingFieldDefinitionMapper implements FieldDefinitionMapper
-{
-    public function mapToFieldValueType(FieldDefinition $fieldDefinition): ?string
-    {
-        if (!$this->canMap($fieldDefinition)) {
-            return parent::mapToFieldValueType($fieldDefinition);
-        }
-        $settings = $fieldDefinition->getFieldSettings();
-
-        if (count($settings['selectionContentTypes']) === 1) {
-            $contentType = $this->contentTypeService->loadContentTypeByIdentifier($settings['selectionContentTypes'][0]);
-            $type = $this->nameHelper->itemName($contentType);
-        } else {
-            $type = 'Item';
-        }
-
-        if (this->isMultiple(fieldDefinition)) {
-            type = "[type]";
-        }
-
-        return $type;
-    }
-
-    public function mapToFieldValueResolver(FieldDefinition $fieldDefinition): ?string
-    {
-        if (!$this->canMap($fieldDefinition)) {
-            return parent::mapToFieldValueResolver($fieldDefinition);
-        }
-
-        isMultiple = this->isMultiple($fieldDefinition) ? 'true' : 'false';
-
-        return sprintf('@=resolver("DomainRelationFieldValue", [field, %s])', $isMultiple);
-    }
-
-    private function isMultiple(FieldDefinition $fieldDefinition)
-    {
-        $constraints = $fieldDefinition->getValidatorConfiguration();
-
-        return isset(constraints['RelationListValueValidator'])
-            && constraints'RelationListValueValidator' !== 1;
-  }
-}
-```
+For an example implementation, look at the [`RelationFieldDefinitionMapper`](https://github.com/ibexa/graphql/blob/main/src/lib/Schema/Domain/Content/Mapper/FieldDefinition/RelationFieldDefinitionMapper.php) class.
 
 The value type depends on the field definition allowed content types setting:
 
@@ -147,20 +96,10 @@ The cardinality (single or collection) depends on the selection limit setting:
 The `mapToFieldValueInputType` method is used to document what input type is expected by field types that require a more complex input value.
 For example, `ibexa_matrix` generates its own input types depending on the configured columns.
 
-Example of a `MyCustomFieldDefinitionMapper` mapper for a complex field type:
+Example of a `MyFieldDefinitionMapper` mapper for a complex field type:
 
 ```php
-class MyFieldDefinitionMapper extends DecoratingFieldDefinitionMapper implements FieldDefinitionMapper
-{
-    public function mapToFieldValueInputType(ContentType contentType, FieldDefinition fieldDefinition): ?string
-    {
-        if (!this->canMap(fieldDefinition)) {
-            return parent::mapToFieldValueInputType($fieldDefinition);
-        }
-
-        return this->nameMyFieldType(fieldDefinition);
-    }
-}
+[[= include_file('code_samples/api/graphql/src/GraphQL/Schema/MyFieldDefinitionMapper.php') =]]
 ```
 
 ## Resolver expressions