chore: fixes the reference copy conundrum

baywet · baywet · commit 0a686fd06270 · 2025-06-06T09:29:00.000-04:00
Signed-off-by: Vincent Biret &lt;vibiret@microsoft.com&gt;
diff --git a/src/Microsoft.OpenApi/Models/References/BaseOpenApiReferenceHolder.cs b/src/Microsoft.OpenApi/Models/References/BaseOpenApiReferenceHolder.cs
@@ -30,6 +30,12 @@ public T? RecursiveTarget
             };
         }
     }
+    /// <summary>
+    /// Copy the reference as a target element with overrides.
+    /// </summary>
+    /// <param name="sourceReference">The source reference to copy</param>
+    /// <returns>The copy of the reference</returns>
+    protected abstract V CopyReference(V sourceReference);
 
     /// <summary>
     /// Copy constructor
@@ -38,7 +44,7 @@ public T? RecursiveTarget
     protected BaseOpenApiReferenceHolder(BaseOpenApiReferenceHolder<T, U, V> source)
     {
         Utils.CheckArgumentNull(source);
-        Reference = new(source.Reference);
+        Reference = CopyReference(source.Reference);
         //no need to copy summary and description as if they are not overridden, they will be fetched from the target
         //if they are, the reference copy will handle it
     }
diff --git a/src/Microsoft.OpenApi/Models/References/OpenApiCallbackReference.cs b/src/Microsoft.OpenApi/Models/References/OpenApiCallbackReference.cs
@@ -20,16 +20,16 @@ public class OpenApiCallbackReference : BaseOpenApiReferenceHolder<OpenApiCallba
         /// 1. an absolute/relative file path, for example:  ../commons/pet.json
         /// 2. a Url, for example: http://localhost/pet.json
         /// </param>
-        public OpenApiCallbackReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null):base(referenceId, hostDocument, ReferenceType.Callback, externalResource)
+        public OpenApiCallbackReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null) : base(referenceId, hostDocument, ReferenceType.Callback, externalResource)
         {
         }
         /// <summary>
         /// Copy constructor
         /// </summary>
         /// <param name="callback">The reference to copy</param>
-        private OpenApiCallbackReference(OpenApiCallbackReference callback):base(callback)
+        private OpenApiCallbackReference(OpenApiCallbackReference callback) : base(callback)
         {
-            
+
         }
 
         /// <inheritdoc/>
@@ -56,5 +56,10 @@ public IOpenApiCallback CreateShallowCopy()
         {
             return new OpenApiCallbackReference(this);
         }
+        /// <inheritdoc/>
+        protected override OpenApiReference CopyReference(OpenApiReference sourceReference)
+        {
+            return new OpenApiReference(sourceReference);
+        }
     }
 }
diff --git a/src/Microsoft.OpenApi/Models/References/OpenApiExampleReference.cs b/src/Microsoft.OpenApi/Models/References/OpenApiExampleReference.cs
@@ -21,14 +21,14 @@ public class OpenApiExampleReference : BaseOpenApiReferenceHolder<OpenApiExample
         /// 1. a absolute/relative file path, for example:  ../commons/pet.json
         /// 2. a Url, for example: http://localhost/pet.json
         /// </param>
-        public OpenApiExampleReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null):base(referenceId, hostDocument, ReferenceType.Example, externalResource)
+        public OpenApiExampleReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null) : base(referenceId, hostDocument, ReferenceType.Example, externalResource)
         {
         }
         /// <summary>
         /// Copy constructor
         /// </summary>
         /// <param name="example">The example reference to copy</param>
-        private OpenApiExampleReference(OpenApiExampleReference example):base(example)
+        private OpenApiExampleReference(OpenApiExampleReference example) : base(example)
         {
         }
 
@@ -73,5 +73,10 @@ public IOpenApiExample CreateShallowCopy()
         {
             return new OpenApiExampleReference(this);
         }
+        /// <inheritdoc/>
+        protected override OpenApiReference CopyReference(OpenApiReference sourceReference)
+        {
+            return new OpenApiReference(sourceReference);
+        }
     }
 }
diff --git a/src/Microsoft.OpenApi/Models/References/OpenApiHeaderReference.cs b/src/Microsoft.OpenApi/Models/References/OpenApiHeaderReference.cs
@@ -21,15 +21,15 @@ public class OpenApiHeaderReference : BaseOpenApiReferenceHolder<OpenApiHeader,
         /// 1. a absolute/relative file path, for example:  ../commons/pet.json
         /// 2. a Url, for example: http://localhost/pet.json
         /// </param>
-        public OpenApiHeaderReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null):base(referenceId, hostDocument, ReferenceType.Header, externalResource)
+        public OpenApiHeaderReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null) : base(referenceId, hostDocument, ReferenceType.Header, externalResource)
         {
         }
 
         /// <summary>
         /// Copy constructor
         /// </summary>
         /// <param name="header">The <see cref="OpenApiHeaderReference"/> object to copy</param>
-        private OpenApiHeaderReference(OpenApiHeaderReference header):base(header)
+        private OpenApiHeaderReference(OpenApiHeaderReference header) : base(header)
         {
         }
 
@@ -84,5 +84,10 @@ public IOpenApiHeader CreateShallowCopy()
         {
             return new OpenApiHeaderReference(this);
         }
+        /// <inheritdoc/>
+        protected override OpenApiReference CopyReference(OpenApiReference sourceReference)
+        {
+            return new OpenApiReference(sourceReference);
+        }
     }
 }
diff --git a/src/Microsoft.OpenApi/Models/References/OpenApiLinkReference.cs b/src/Microsoft.OpenApi/Models/References/OpenApiLinkReference.cs
@@ -20,14 +20,14 @@ public class OpenApiLinkReference : BaseOpenApiReferenceHolder<OpenApiLink, IOpe
         /// 1. a absolute/relative file path, for example:  ../commons/pet.json
         /// 2. a Url, for example: http://localhost/pet.json
         /// </param>
-        public OpenApiLinkReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null):base(referenceId, hostDocument, ReferenceType.Link, externalResource)
+        public OpenApiLinkReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null) : base(referenceId, hostDocument, ReferenceType.Link, externalResource)
         {
         }
         /// <summary>
         /// Copy constructor.
         /// </summary>
         /// <param name="reference">The reference to copy</param>
-        private OpenApiLinkReference(OpenApiLinkReference reference):base(reference)
+        private OpenApiLinkReference(OpenApiLinkReference reference) : base(reference)
         {
         }
 
@@ -73,5 +73,10 @@ public IOpenApiLink CreateShallowCopy()
         {
             return new OpenApiLinkReference(this);
         }
+        /// <inheritdoc/>
+        protected override OpenApiReference CopyReference(OpenApiReference sourceReference)
+        {
+            return new OpenApiReference(sourceReference);
+        }
     }
 }
diff --git a/src/Microsoft.OpenApi/Models/References/OpenApiParameterReference.cs b/src/Microsoft.OpenApi/Models/References/OpenApiParameterReference.cs
@@ -90,5 +90,11 @@ public IOpenApiParameter CreateShallowCopy()
         {
             return new OpenApiParameterReference(this);
         }
+
+        /// <inheritdoc/>
+        protected override OpenApiReference CopyReference(OpenApiReference sourceReference)
+        {
+            return new OpenApiReference(sourceReference);
+        }
     }
 }
diff --git a/src/Microsoft.OpenApi/Models/References/OpenApiPathItemReference.cs b/src/Microsoft.OpenApi/Models/References/OpenApiPathItemReference.cs
@@ -22,17 +22,17 @@ public class OpenApiPathItemReference : BaseOpenApiReferenceHolder<OpenApiPathIt
         /// 1. a absolute/relative file path, for example:  ../commons/pet.json
         /// 2. a Url, for example: http://localhost/pet.json
         /// </param>
-        public OpenApiPathItemReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null): base(referenceId, hostDocument, ReferenceType.PathItem, externalResource)
+        public OpenApiPathItemReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null) : base(referenceId, hostDocument, ReferenceType.PathItem, externalResource)
         {
         }
 
         /// <summary>
         /// Copy constructor
         /// </summary>
         /// <param name="pathItem">The reference to copy</param>
-        private OpenApiPathItemReference(OpenApiPathItemReference pathItem):base(pathItem)
+        private OpenApiPathItemReference(OpenApiPathItemReference pathItem) : base(pathItem)
         {
-            
+
         }
 
         /// <inheritdoc/>
@@ -78,5 +78,10 @@ public override void SerializeAsV2(IOpenApiWriter writer)
         {
             Reference.SerializeAsV2(writer);
         }
+        /// <inheritdoc/>
+        protected override OpenApiReference CopyReference(OpenApiReference sourceReference)
+        {
+            return new OpenApiReference(sourceReference);
+        }
     }
 }
diff --git a/src/Microsoft.OpenApi/Models/References/OpenApiRequestBodyReference.cs b/src/Microsoft.OpenApi/Models/References/OpenApiRequestBodyReference.cs
@@ -21,16 +21,16 @@ public class OpenApiRequestBodyReference : BaseOpenApiReferenceHolder<OpenApiReq
         /// 1. a absolute/relative file path, for example:  ../commons/pet.json
         /// 2. a Url, for example: http://localhost/pet.json
         /// </param>
-        public OpenApiRequestBodyReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null):base(referenceId, hostDocument, ReferenceType.RequestBody, externalResource)
+        public OpenApiRequestBodyReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null) : base(referenceId, hostDocument, ReferenceType.RequestBody, externalResource)
         {
         }
         /// <summary>
         /// Copy constructor
         /// </summary>
         /// <param name="openApiRequestBodyReference">The reference to copy</param>
-        private OpenApiRequestBodyReference(OpenApiRequestBodyReference openApiRequestBodyReference):base(openApiRequestBodyReference)
+        private OpenApiRequestBodyReference(OpenApiRequestBodyReference openApiRequestBodyReference) : base(openApiRequestBodyReference)
         {
-            
+
         }
 
         /// <inheritdoc/>
@@ -88,5 +88,10 @@ public IOpenApiRequestBody CreateShallowCopy()
         {
             return new OpenApiRequestBodyReference(this);
         }
+        /// <inheritdoc/>
+        protected override OpenApiReference CopyReference(OpenApiReference sourceReference)
+        {
+            return new OpenApiReference(sourceReference);
+        }
     }
 }
diff --git a/src/Microsoft.OpenApi/Models/References/OpenApiResponseReference.cs b/src/Microsoft.OpenApi/Models/References/OpenApiResponseReference.cs
@@ -20,16 +20,16 @@ public class OpenApiResponseReference : BaseOpenApiReferenceHolder<OpenApiRespon
         /// 1. a absolute/relative file path, for example:  ../commons/pet.json
         /// 2. a Url, for example: http://localhost/pet.json
         /// </param>
-        public OpenApiResponseReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null):base(referenceId, hostDocument, ReferenceType.Response, externalResource)
+        public OpenApiResponseReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null) : base(referenceId, hostDocument, ReferenceType.Response, externalResource)
         {
         }
         /// <summary>
         /// Copy constructor
         /// </summary>
         /// <param name="openApiResponseReference">The reference to copy</param>
-        private OpenApiResponseReference(OpenApiResponseReference openApiResponseReference):base(openApiResponseReference)
+        private OpenApiResponseReference(OpenApiResponseReference openApiResponseReference) : base(openApiResponseReference)
         {
-            
+
         }
 
         /// <inheritdoc/>
@@ -62,5 +62,10 @@ public IOpenApiResponse CreateShallowCopy()
         {
             return new OpenApiResponseReference(this);
         }
+        /// <inheritdoc/>
+        protected override OpenApiReference CopyReference(OpenApiReference sourceReference)
+        {
+            return new OpenApiReference(sourceReference);
+        }
     }
 }
diff --git a/src/Microsoft.OpenApi/Models/References/OpenApiSchemaReference.cs b/src/Microsoft.OpenApi/Models/References/OpenApiSchemaReference.cs
@@ -167,7 +167,7 @@ public bool Deprecated
         /// <inheritdoc/>
         public override void SerializeAsV31(IOpenApiWriter writer)
         {
-            SerializeAsWithoutLoops(writer, (w, element) => 
+            SerializeAsWithoutLoops(writer, (w, element) =>
             {
                 if (element is IOpenApiSchema s)
                 {
@@ -223,5 +223,10 @@ public IOpenApiSchema CreateShallowCopy()
         {
             return new OpenApiSchemaReference(this);
         }
+        /// <inheritdoc/>
+        protected override JsonSchemaReference CopyReference(JsonSchemaReference sourceReference)
+        {
+            return new JsonSchemaReference(sourceReference);
+        }
     }
 }
diff --git a/src/Microsoft.OpenApi/Models/References/OpenApiSecuritySchemeReference.cs b/src/Microsoft.OpenApi/Models/References/OpenApiSecuritySchemeReference.cs
@@ -17,16 +17,16 @@ public class OpenApiSecuritySchemeReference : BaseOpenApiReferenceHolder<OpenApi
         /// <param name="referenceId">The reference Id.</param>
         /// <param name="hostDocument">The host OpenAPI document.</param>
         /// <param name="externalResource">The externally referenced file.</param>
-        public OpenApiSecuritySchemeReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null):base(referenceId, hostDocument, ReferenceType.SecurityScheme, externalResource)
+        public OpenApiSecuritySchemeReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null) : base(referenceId, hostDocument, ReferenceType.SecurityScheme, externalResource)
         {
         }
         /// <summary>
         /// Copy constructor
         /// </summary>
         /// <param name="openApiSecuritySchemeReference">The reference to copy</param>
-        private OpenApiSecuritySchemeReference(OpenApiSecuritySchemeReference openApiSecuritySchemeReference):base(openApiSecuritySchemeReference)
+        private OpenApiSecuritySchemeReference(OpenApiSecuritySchemeReference openApiSecuritySchemeReference) : base(openApiSecuritySchemeReference)
         {
-            
+
         }
 
         /// <inheritdoc/>
@@ -71,5 +71,10 @@ public IOpenApiSecurityScheme CreateShallowCopy()
         {
             return new OpenApiSecuritySchemeReference(this);
         }
+        /// <inheritdoc/>
+        protected override OpenApiReference CopyReference(OpenApiReference sourceReference)
+        {
+            return new OpenApiReference(sourceReference);
+        }
     }
 }
diff --git a/src/Microsoft.OpenApi/Models/References/OpenApiTagReference.cs b/src/Microsoft.OpenApi/Models/References/OpenApiTagReference.cs
@@ -32,16 +32,16 @@ public override IOpenApiTag? Target
         /// 1. a absolute/relative file path, for example:  ../commons/pet.json
         /// 2. a Url, for example: http://localhost/pet.json
         /// </param>
-        public OpenApiTagReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null):base(referenceId, hostDocument, ReferenceType.Tag, externalResource)
+        public OpenApiTagReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null) : base(referenceId, hostDocument, ReferenceType.Tag, externalResource)
         {
         }
         /// <summary>
         /// Copy constructor
         /// </summary>
         /// <param name="openApiTagReference">The reference to copy</param>
-        private OpenApiTagReference(OpenApiTagReference openApiTagReference):base(openApiTagReference)
+        private OpenApiTagReference(OpenApiTagReference openApiTagReference) : base(openApiTagReference)
         {
-            
+
         }
 
         /// <inheritdoc/>
@@ -69,5 +69,10 @@ public IOpenApiTag CreateShallowCopy()
         {
             return new OpenApiTagReference(this);
         }
+        /// <inheritdoc/>
+        protected override OpenApiReference CopyReference(OpenApiReference sourceReference)
+        {
+            return new OpenApiReference(sourceReference);
+        }
     }
 }
diff --git a/test/Microsoft.OpenApi.Tests/Models/References/OpenApiSchemaReferenceTests.cs b/test/Microsoft.OpenApi.Tests/Models/References/OpenApiSchemaReferenceTests.cs
@@ -59,7 +59,6 @@ public void SchemaReferenceWithAnnotationsShouldWork()
                 Deprecated = true,
                 Default = JsonValue.Create("override default"),
                 Examples = new List<JsonNode> { JsonValue.Create("override example") },
-                Summary = "Reference Summary"
             };
 
             // Assert
@@ -71,7 +70,6 @@ public void SchemaReferenceWithAnnotationsShouldWork()
             Assert.Equal("override default", schemaReference.Default?.GetValue<string>());
             Assert.Single(schemaReference.Examples);
             Assert.Equal("override example", schemaReference.Examples.First()?.GetValue<string>());
-            Assert.Equal("Reference Summary", schemaReference.Summary);
         }
 
         [Fact]
@@ -119,7 +117,6 @@ public void SchemaReferenceWithoutAnnotationsShouldFallbackToTarget()
             Assert.Equal("target default", schemaReference.Default?.GetValue<string>());
             Assert.Single(schemaReference.Examples);
             Assert.Equal("target example", schemaReference.Examples.First()?.GetValue<string>());
-            Assert.Null(schemaReference.Summary); // Summary has no target fallback
         }
 
         [Theory]
@@ -132,7 +129,6 @@ public async Task SerializeSchemaReferenceAsV31JsonWorks(bool produceTerseOutput
             {
                 Title = "Reference Title",
                 Description = "Reference Description",
-                Summary = "Reference Summary",
                 ReadOnly = true,
                 WriteOnly = false,
                 Deprecated = true,
@@ -161,7 +157,6 @@ public async Task SerializeSchemaReferenceAsV3JsonWorks(bool produceTerseOutput)
             {
                 Title = "Reference Title",
                 Description = "Reference Description",
-                Summary = "Reference Summary",
                 ReadOnly = true,
                 WriteOnly = false,
                 Deprecated = true,
@@ -249,7 +244,6 @@ public void ParseSchemaReferenceWithAnnotationsWorks()
             // Test that reference annotations override target values
             Assert.Equal("Pet Response Schema", schemaRef.Title);
             Assert.Equal("A pet object returned from the API", schemaRef.Description);
-            Assert.Equal("Pet Response", schemaRef.Summary);
             Assert.True(schemaRef.Deprecated);
             Assert.True(schemaRef.ReadOnly);
             Assert.False(schemaRef.WriteOnly);
@@ -263,4 +257,4 @@ public void ParseSchemaReferenceWithAnnotationsWorks()
             Assert.Equal("Original Pet Description", targetSchema.Description);
         }
     }
-}
+}

Original file line number	Diff line number	Diff line change
`@@ -30,6 +30,12 @@ public T? RecursiveTarget`
`30`	`30`	`};`
`31`	`31`	`}`
`32`	`32`	`}`
	`33`	`+ /// <summary>`
	`34`	`+ /// Copy the reference as a target element with overrides.`
	`35`	`+ /// </summary>`
	`36`	`+ /// <param name="sourceReference">The source reference to copy</param>`
	`37`	`+ /// <returns>The copy of the reference</returns>`
	`38`	`+ protected abstract V CopyReference(V sourceReference);`
`33`	`39`
`34`	`40`	`/// <summary>`
`35`	`41`	`/// Copy constructor`
`@@ -38,7 +44,7 @@ public T? RecursiveTarget`
`38`	`44`	`protected BaseOpenApiReferenceHolder(BaseOpenApiReferenceHolder<T, U, V> source)`
`39`	`45`	`{`
`40`	`46`	`Utils.CheckArgumentNull(source);`
`41`		`- Reference = new(source.Reference);`
	`47`	`+ Reference = CopyReference(source.Reference);`
`42`	`48`	`//no need to copy summary and description as if they are not overridden, they will be fetched from the target`
`43`	`49`	`//if they are, the reference copy will handle it`
`44`	`50`	`}`
Original file line number	Diff line number	Diff line change
`@@ -20,16 +20,16 @@ public class OpenApiCallbackReference : BaseOpenApiReferenceHolder<OpenApiCallba`
`20`	`20`	`/// 1. an absolute/relative file path, for example: ../commons/pet.json`
`21`	`21`	`/// 2. a Url, for example: http://localhost/pet.json`
`22`	`22`	`/// </param>`
`23`		`- public OpenApiCallbackReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null):base(referenceId, hostDocument, ReferenceType.Callback, externalResource)`
	`23`	`+ public OpenApiCallbackReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null) : base(referenceId, hostDocument, ReferenceType.Callback, externalResource)`
`24`	`24`	`{`
`25`	`25`	`}`
`26`	`26`	`/// <summary>`
`27`	`27`	`/// Copy constructor`
`28`	`28`	`/// </summary>`
`29`	`29`	`/// <param name="callback">The reference to copy</param>`
`30`		`- private OpenApiCallbackReference(OpenApiCallbackReference callback):base(callback)`
	`30`	`+ private OpenApiCallbackReference(OpenApiCallbackReference callback) : base(callback)`
`31`	`31`	`{`
`32`		`-`
	`32`	`+`
`33`	`33`	`}`
`34`	`34`
`35`	`35`	`/// <inheritdoc/>`
`@@ -56,5 +56,10 @@ public IOpenApiCallback CreateShallowCopy()`
`56`	`56`	`{`
`57`	`57`	`return new OpenApiCallbackReference(this);`
`58`	`58`	`}`
	`59`	`+ /// <inheritdoc/>`
	`60`	`+ protected override OpenApiReference CopyReference(OpenApiReference sourceReference)`
	`61`	`+ {`
	`62`	`+ return new OpenApiReference(sourceReference);`
	`63`	`+ }`
`59`	`64`	`}`
`60`	`65`	`}`
Original file line number	Diff line number	Diff line change
`@@ -21,14 +21,14 @@ public class OpenApiExampleReference : BaseOpenApiReferenceHolder<OpenApiExample`
`21`	`21`	`/// 1. a absolute/relative file path, for example: ../commons/pet.json`
`22`	`22`	`/// 2. a Url, for example: http://localhost/pet.json`
`23`	`23`	`/// </param>`
`24`		`- public OpenApiExampleReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null):base(referenceId, hostDocument, ReferenceType.Example, externalResource)`
	`24`	`+ public OpenApiExampleReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null) : base(referenceId, hostDocument, ReferenceType.Example, externalResource)`
`25`	`25`	`{`
`26`	`26`	`}`
`27`	`27`	`/// <summary>`
`28`	`28`	`/// Copy constructor`
`29`	`29`	`/// </summary>`
`30`	`30`	`/// <param name="example">The example reference to copy</param>`
`31`		`- private OpenApiExampleReference(OpenApiExampleReference example):base(example)`
	`31`	`+ private OpenApiExampleReference(OpenApiExampleReference example) : base(example)`
`32`	`32`	`{`
`33`	`33`	`}`
`34`	`34`
`@@ -73,5 +73,10 @@ public IOpenApiExample CreateShallowCopy()`
`73`	`73`	`{`
`74`	`74`	`return new OpenApiExampleReference(this);`
`75`	`75`	`}`
	`76`	`+ /// <inheritdoc/>`
	`77`	`+ protected override OpenApiReference CopyReference(OpenApiReference sourceReference)`
	`78`	`+ {`
	`79`	`+ return new OpenApiReference(sourceReference);`
	`80`	`+ }`
`76`	`81`	`}`
`77`	`82`	`}`
Original file line number	Diff line number	Diff line change
`@@ -21,15 +21,15 @@ public class OpenApiHeaderReference : BaseOpenApiReferenceHolder<OpenApiHeader,`
`21`	`21`	`/// 1. a absolute/relative file path, for example: ../commons/pet.json`
`22`	`22`	`/// 2. a Url, for example: http://localhost/pet.json`
`23`	`23`	`/// </param>`
`24`		`- public OpenApiHeaderReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null):base(referenceId, hostDocument, ReferenceType.Header, externalResource)`
	`24`	`+ public OpenApiHeaderReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null) : base(referenceId, hostDocument, ReferenceType.Header, externalResource)`
`25`	`25`	`{`
`26`	`26`	`}`
`27`	`27`
`28`	`28`	`/// <summary>`
`29`	`29`	`/// Copy constructor`
`30`	`30`	`/// </summary>`
`31`	`31`	`/// <param name="header">The <see cref="OpenApiHeaderReference"/> object to copy</param>`
`32`		`- private OpenApiHeaderReference(OpenApiHeaderReference header):base(header)`
	`32`	`+ private OpenApiHeaderReference(OpenApiHeaderReference header) : base(header)`
`33`	`33`	`{`
`34`	`34`	`}`
`35`	`35`
`@@ -84,5 +84,10 @@ public IOpenApiHeader CreateShallowCopy()`
`84`	`84`	`{`
`85`	`85`	`return new OpenApiHeaderReference(this);`
`86`	`86`	`}`
	`87`	`+ /// <inheritdoc/>`
	`88`	`+ protected override OpenApiReference CopyReference(OpenApiReference sourceReference)`
	`89`	`+ {`
	`90`	`+ return new OpenApiReference(sourceReference);`
	`91`	`+ }`
`87`	`92`	`}`
`88`	`93`	`}`
Original file line number	Diff line number	Diff line change
`@@ -20,14 +20,14 @@ public class OpenApiLinkReference : BaseOpenApiReferenceHolder<OpenApiLink, IOpe`
`20`	`20`	`/// 1. a absolute/relative file path, for example: ../commons/pet.json`
`21`	`21`	`/// 2. a Url, for example: http://localhost/pet.json`
`22`	`22`	`/// </param>`
`23`		`- public OpenApiLinkReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null):base(referenceId, hostDocument, ReferenceType.Link, externalResource)`
	`23`	`+ public OpenApiLinkReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null) : base(referenceId, hostDocument, ReferenceType.Link, externalResource)`
`24`	`24`	`{`
`25`	`25`	`}`
`26`	`26`	`/// <summary>`
`27`	`27`	`/// Copy constructor.`
`28`	`28`	`/// </summary>`
`29`	`29`	`/// <param name="reference">The reference to copy</param>`
`30`		`- private OpenApiLinkReference(OpenApiLinkReference reference):base(reference)`
	`30`	`+ private OpenApiLinkReference(OpenApiLinkReference reference) : base(reference)`
`31`	`31`	`{`
`32`	`32`	`}`
`33`	`33`
`@@ -73,5 +73,10 @@ public IOpenApiLink CreateShallowCopy()`
`73`	`73`	`{`
`74`	`74`	`return new OpenApiLinkReference(this);`
`75`	`75`	`}`
	`76`	`+ /// <inheritdoc/>`
	`77`	`+ protected override OpenApiReference CopyReference(OpenApiReference sourceReference)`
	`78`	`+ {`
	`79`	`+ return new OpenApiReference(sourceReference);`
	`80`	`+ }`
`76`	`81`	`}`
`77`	`82`	`}`
Original file line number	Diff line number	Diff line change
`@@ -90,5 +90,11 @@ public IOpenApiParameter CreateShallowCopy()`
`90`	`90`	`{`
`91`	`91`	`return new OpenApiParameterReference(this);`
`92`	`92`	`}`
	`93`	`+`
	`94`	`+ /// <inheritdoc/>`
	`95`	`+ protected override OpenApiReference CopyReference(OpenApiReference sourceReference)`
	`96`	`+ {`
	`97`	`+ return new OpenApiReference(sourceReference);`
	`98`	`+ }`
`93`	`99`	`}`
`94`	`100`	`}`
Original file line number	Diff line number	Diff line change
`@@ -22,17 +22,17 @@ public class OpenApiPathItemReference : BaseOpenApiReferenceHolder<OpenApiPathIt`
`22`	`22`	`/// 1. a absolute/relative file path, for example: ../commons/pet.json`
`23`	`23`	`/// 2. a Url, for example: http://localhost/pet.json`
`24`	`24`	`/// </param>`
`25`		`- public OpenApiPathItemReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null): base(referenceId, hostDocument, ReferenceType.PathItem, externalResource)`
	`25`	`+ public OpenApiPathItemReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null) : base(referenceId, hostDocument, ReferenceType.PathItem, externalResource)`
`26`	`26`	`{`
`27`	`27`	`}`
`28`	`28`
`29`	`29`	`/// <summary>`
`30`	`30`	`/// Copy constructor`
`31`	`31`	`/// </summary>`
`32`	`32`	`/// <param name="pathItem">The reference to copy</param>`
`33`		`- private OpenApiPathItemReference(OpenApiPathItemReference pathItem):base(pathItem)`
	`33`	`+ private OpenApiPathItemReference(OpenApiPathItemReference pathItem) : base(pathItem)`
`34`	`34`	`{`
`35`		`-`
	`35`	`+`
`36`	`36`	`}`
`37`	`37`
`38`	`38`	`/// <inheritdoc/>`
`@@ -78,5 +78,10 @@ public override void SerializeAsV2(IOpenApiWriter writer)`
`78`	`78`	`{`
`79`	`79`	`Reference.SerializeAsV2(writer);`
`80`	`80`	`}`
	`81`	`+ /// <inheritdoc/>`
	`82`	`+ protected override OpenApiReference CopyReference(OpenApiReference sourceReference)`
	`83`	`+ {`
	`84`	`+ return new OpenApiReference(sourceReference);`
	`85`	`+ }`
`81`	`86`	`}`
`82`	`87`	`}`
Original file line number	Diff line number	Diff line change
`@@ -21,16 +21,16 @@ public class OpenApiRequestBodyReference : BaseOpenApiReferenceHolder<OpenApiReq`
`21`	`21`	`/// 1. a absolute/relative file path, for example: ../commons/pet.json`
`22`	`22`	`/// 2. a Url, for example: http://localhost/pet.json`
`23`	`23`	`/// </param>`
`24`		`- public OpenApiRequestBodyReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null):base(referenceId, hostDocument, ReferenceType.RequestBody, externalResource)`
	`24`	`+ public OpenApiRequestBodyReference(string referenceId, OpenApiDocument? hostDocument = null, string? externalResource = null) : base(referenceId, hostDocument, ReferenceType.RequestBody, externalResource)`
`25`	`25`	`{`
`26`	`26`	`}`
`27`	`27`	`/// <summary>`
`28`	`28`	`/// Copy constructor`
`29`	`29`	`/// </summary>`
`30`	`30`	`/// <param name="openApiRequestBodyReference">The reference to copy</param>`
`31`		`- private OpenApiRequestBodyReference(OpenApiRequestBodyReference openApiRequestBodyReference):base(openApiRequestBodyReference)`
	`31`	`+ private OpenApiRequestBodyReference(OpenApiRequestBodyReference openApiRequestBodyReference) : base(openApiRequestBodyReference)`
`32`	`32`	`{`
`33`		`-`
	`33`	`+`
`34`	`34`	`}`
`35`	`35`
`36`	`36`	`/// <inheritdoc/>`
`@@ -88,5 +88,10 @@ public IOpenApiRequestBody CreateShallowCopy()`
`88`	`88`	`{`
`89`	`89`	`return new OpenApiRequestBodyReference(this);`
`90`	`90`	`}`
	`91`	`+ /// <inheritdoc/>`
	`92`	`+ protected override OpenApiReference CopyReference(OpenApiReference sourceReference)`
	`93`	`+ {`
	`94`	`+ return new OpenApiReference(sourceReference);`
	`95`	`+ }`
`91`	`96`	`}`
`92`	`97`	`}`
Original file line number	Diff line number	Diff line change
`@@ -167,7 +167,7 @@ public bool Deprecated`
`167`	`167`	`/// <inheritdoc/>`
`168`	`168`	`public override void SerializeAsV31(IOpenApiWriter writer)`
`169`	`169`	`{`
`170`		`- SerializeAsWithoutLoops(writer, (w, element) =>`
	`170`	`+ SerializeAsWithoutLoops(writer, (w, element) =>`
`171`	`171`	`{`
`172`	`172`	`if (element is IOpenApiSchema s)`
`173`	`173`	`{`
`@@ -223,5 +223,10 @@ public IOpenApiSchema CreateShallowCopy()`
`223`	`223`	`{`
`224`	`224`	`return new OpenApiSchemaReference(this);`
`225`	`225`	`}`
	`226`	`+ /// <inheritdoc/>`
	`227`	`+ protected override JsonSchemaReference CopyReference(JsonSchemaReference sourceReference)`
	`228`	`+ {`
	`229`	`+ return new JsonSchemaReference(sourceReference);`
	`230`	`+ }`
`226`	`231`	`}`
`227`	`232`	`}`