Use serializedName in Swagger UI Links section

Author: maxtorete

src/Metadata/Property/Factory/SerializerPropertyMetadataFactory.php

@@ -61,6 +61,11 @@ public function create(string $resourceClass, string $property, array $options =
             return $propertyMetadata;
         }
 
+        $serializerMetadataAttributes = $this->serializerClassMetadataFactory->getMetadataFor($resourceClass)->getAttributesMetadata();
+        if (null !== ($serializedName = $serializerMetadataAttributes[$property]->getSerializedName())) {
+            $propertyMetadata = $propertyMetadata->withSerializedName($serializedName);
+        }
+
         $propertyMetadata = $this->transformReadWrite($propertyMetadata, $resourceClass, $property, $normalizationGroups, $denormalizationGroups);
 
         return $this->transformLinkStatus($propertyMetadata, $normalizationGroups, $denormalizationGroups);

src/Metadata/Property/PropertyMetadata.php

@@ -35,8 +35,9 @@ final class PropertyMetadata
     private $attributes;
     private $subresource;
     private $initializable;
+    private $serializedName;
 
-    public function __construct(Type $type = null, string $description = null, bool $readable = null, bool $writable = null, bool $readableLink = null, bool $writableLink = null, bool $required = null, bool $identifier = null, string $iri = null, $childInherited = null, array $attributes = null, SubresourceMetadata $subresource = null, bool $initializable = null)
+    public function __construct(Type $type = null, string $description = null, bool $readable = null, bool $writable = null, bool $readableLink = null, bool $writableLink = null, bool $required = null, bool $identifier = null, string $iri = null, $childInherited = null, array $attributes = null, SubresourceMetadata $subresource = null, bool $initializable = null, string $serializedName = null)
     {
         $this->type = $type;
         $this->description = $description;
@@ -51,6 +52,7 @@ public function __construct(Type $type = null, string $description = null, bool
         $this->attributes = $attributes;
         $this->subresource = $subresource;
         $this->initializable = $initializable;
+        $this->serializedName = $serializedName;
     }
 
     /**
@@ -343,4 +345,23 @@ public function withInitializable(bool $initializable): self
 
         return $metadata;
     }
+
+    /**
+     * Gets custom serialized name of this property.
+     */
+    public function getSerializedName(): ?string
+    {
+        return $this->serializedName;
+    }
+
+    /**
+     * Returns a new instance with the given serialized name.
+     */
+    public function withSerializedName(string $serializedName = null): self
+    {
+        $metadata = clone $this;
+        $metadata->serializedName = $serializedName;
+
+        return $metadata;
+    }
 }

src/Swagger/Serializer/DocumentationNormalizer.php

@@ -791,6 +791,7 @@ private function getLinkObject(string $resourceClass, string $operationId, strin
                 continue;
             }
 
+            $propertyName = $propertyMetadata->getSerializedName() ?? $propertyName;
             $linkObject['parameters'][$propertyName] = sprintf('$response.body#/%s', $propertyName);
             $identifiers[] = $propertyName;
         }