fix: shallow copy for example

Signed-off-by: Vincent Biret <[email protected]>

Author: baywet

src/Microsoft.OpenApi/Models/Interfaces/IOpenApiExample.cs

@@ -7,7 +7,7 @@ namespace Microsoft.OpenApi.Models.Interfaces;
 /// Defines the base properties for the example object.
 /// This interface is provided for type assertions but should not be implemented by package consumers beyond automatic mocking.
 /// </summary>
-public interface IOpenApiExample : IOpenApiDescribedElement, IOpenApiSummarizedElement, IOpenApiSerializable, IOpenApiReadOnlyExtensible
+public interface IOpenApiExample : IOpenApiDescribedElement, IOpenApiSummarizedElement, IOpenApiSerializable, IOpenApiReadOnlyExtensible, IShallowCopyable<IOpenApiExample>
 {
     /// <summary>
     /// Embedded literal example. The value field and externalValue field are mutually

src/Microsoft.OpenApi/Models/OpenApiExample.cs

@@ -39,7 +39,7 @@ public OpenApiExample() { }
         /// Initializes a copy of <see cref="OpenApiExample"/> object
         /// </summary>
         /// <param name="example">The <see cref="IOpenApiExample"/> object</param>
-        public OpenApiExample(IOpenApiExample example)
+        internal OpenApiExample(IOpenApiExample example)
         {
             Utils.CheckArgumentNull(example);
             Summary = example.Summary ?? Summary;
@@ -90,5 +90,11 @@ public void SerializeAsV2(IOpenApiWriter writer)
         {
             SerializeInternal(writer, OpenApiSpecVersion.OpenApi2_0);
         }
+
+        /// <inheritdoc/>
+        public IOpenApiExample CreateShallowCopy()
+        {
+            return new OpenApiExample(this);
+        }
     }
 }

src/Microsoft.OpenApi/Models/References/OpenApiExampleReference.cs

@@ -29,14 +29,6 @@ public OpenApiExampleReference(string referenceId, OpenApiDocument hostDocument,
         {
         }
 
-        /// <summary>
-        /// Copy constructor
-        /// </summary>
-        /// <param name="example">The reference to copy.</param>
-        public OpenApiExampleReference(OpenApiExampleReference example):base(example)
-        {
-        }
-
         internal OpenApiExampleReference(OpenApiExample target, string referenceId):base(target, referenceId, ReferenceType.Example)
         {
         }
@@ -88,5 +80,13 @@ public override void SerializeAsV2(IOpenApiWriter writer)
             // examples components are not supported in OAS 2.0
             Reference.SerializeAsV2(writer);
         }
+
+        /// <inheritdoc/>
+        public IOpenApiExample CreateShallowCopy()
+        {
+            return _target is null ?
+                new OpenApiExampleReference(Reference.Id, Reference.HostDocument, Reference.ExternalResource) :
+                new OpenApiExampleReference(_target, Reference.Id);
+        }
     }
 }