[Swagger] Added support for customizing the Definition key

Author: lyrixx

src/Swagger/Serializer/DocumentationNormalizer.php

@@ -275,6 +275,7 @@ private function updateGetOperation(\ArrayObject $pathOperation, array $mimeType
         $serializerContext = $this->getSerializerContext($operationType, false, $resourceMetadata, $operationName);
         $responseDefinitionKey = $this->getDefinition($definitions, $resourceMetadata, $resourceClass, $serializerContext);
 
+
         $pathOperation['produces'] ?? $pathOperation['produces'] = $mimeTypes;
 
         if (OperationType::COLLECTION === $operationType) {
@@ -442,7 +443,11 @@ private function updateDeleteOperation(\ArrayObject $pathOperation, string $reso
      */
     private function getDefinition(\ArrayObject $definitions, ResourceMetadata $resourceMetadata, string $resourceClass, array $serializerContext = null): string
     {
-        $definitionKey = $this->getDefinitionKey($resourceMetadata->getShortName(), (array) ($serializerContext[AbstractNormalizer::GROUPS] ?? []));
+        if (isset($serializerContext['definition_name'])) {
+            $definitionKey = sprintf('%s-%s', $resourceMetadata->getShortName(), $serializerContext['definition_name']);
+        } else {
+            $definitionKey = $this->getDefinitionKey($resourceMetadata->getShortName(), (array) ($serializerContext[AbstractNormalizer::GROUPS] ?? []));
+        }
 
         if (!isset($definitions[$definitionKey])) {
             $definitions[$definitionKey] = [];  // Initialize first to prevent infinite loop