Implement an interface for IOpenApiReferenceable items with a target object

Author: MaggieKimani1

src/Microsoft.OpenApi/Interfaces/IOpenApiReferenceableWithTarget.cs

@@ -0,0 +1,17 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Microsoft.OpenApi.Interfaces
+{
+    /// <summary>
+    /// A generic interface for OpenApiReferenceable objects that have a target.
+    /// </summary>
+    /// <typeparam name="T"></typeparam>
+    public interface IOpenApiReferenceableWithTarget<T> : IOpenApiReferenceable
+    {
+        /// <summary>
+        /// Gets the resolved target object.
+        /// </summary>
+        T Target { get; }
+    }
+}

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

@@ -12,7 +12,7 @@ namespace Microsoft.OpenApi.Models.References
     /// <summary>
     /// Callback Object Reference: A reference to a map of possible out-of band callbacks related to the parent operation.
     /// </summary>
-    public class OpenApiCallbackReference : OpenApiCallback, IOpenApiReferenceable
+    public class OpenApiCallbackReference : OpenApiCallback, IOpenApiReferenceableWithTarget<OpenApiCallback>
     {
 #nullable enable
         internal OpenApiCallback _target;

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

@@ -12,7 +12,7 @@ namespace Microsoft.OpenApi.Models.References
     /// <summary>
     /// Example Object Reference.
     /// </summary>
-    public class OpenApiExampleReference : OpenApiExample, IOpenApiReferenceable
+    public class OpenApiExampleReference : OpenApiExample, IOpenApiReferenceableWithTarget<OpenApiExample>
     {
         internal OpenApiExample _target;
         private readonly OpenApiReference _reference;

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

@@ -12,7 +12,7 @@ namespace Microsoft.OpenApi.Models.References
     /// <summary>
     /// Header Object Reference.
     /// </summary>
-    public class OpenApiHeaderReference : OpenApiHeader, IOpenApiReferenceable
+    public class OpenApiHeaderReference : OpenApiHeader, IOpenApiReferenceableWithTarget<OpenApiHeader>
     {
         internal OpenApiHeader _target;
         private readonly OpenApiReference _reference;

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

@@ -11,7 +11,7 @@ namespace Microsoft.OpenApi.Models.References
     /// <summary>
     /// Link Object Reference.
     /// </summary>
-    public class OpenApiLinkReference : OpenApiLink, IOpenApiReferenceable
+    public class OpenApiLinkReference : OpenApiLink, IOpenApiReferenceableWithTarget<OpenApiLink>
     {
         internal OpenApiLink _target;
         private readonly OpenApiReference _reference;

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

@@ -12,7 +12,7 @@ namespace Microsoft.OpenApi.Models.References
     /// <summary>
     /// Parameter Object Reference.
     /// </summary>
-    public class OpenApiParameterReference : OpenApiParameter, IOpenApiReferenceable
+    public class OpenApiParameterReference : OpenApiParameter, IOpenApiReferenceableWithTarget<OpenApiParameter>
     {
         internal OpenApiParameter _target;
         private readonly OpenApiReference _reference;

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

@@ -11,7 +11,7 @@ namespace Microsoft.OpenApi.Models.References
     /// <summary>
     /// Path Item Object Reference: to describe the operations available on a single path.
     /// </summary>
-    public class OpenApiPathItemReference : OpenApiPathItem, IOpenApiReferenceable
+    public class OpenApiPathItemReference : OpenApiPathItem, IOpenApiReferenceableWithTarget<OpenApiPathItem>
     {
         internal OpenApiPathItem _target;
         private readonly OpenApiReference _reference;

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

@@ -11,7 +11,7 @@ namespace Microsoft.OpenApi.Models.References
     /// <summary>
     /// Request Body Object Reference.
     /// </summary>
-    public class OpenApiRequestBodyReference : OpenApiRequestBody, IOpenApiReferenceable
+    public class OpenApiRequestBodyReference : OpenApiRequestBody, IOpenApiReferenceableWithTarget<OpenApiRequestBody>
     {
         internal OpenApiRequestBody _target;
         private readonly OpenApiReference _reference;

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

@@ -11,7 +11,7 @@ namespace Microsoft.OpenApi.Models.References
     /// <summary>
     /// Response Object Reference.
     /// </summary>
-    public class OpenApiResponseReference : OpenApiResponse, IOpenApiReferenceable
+    public class OpenApiResponseReference : OpenApiResponse, IOpenApiReferenceableWithTarget<OpenApiResponse>
     {
         internal OpenApiResponse _target;
         private readonly OpenApiReference _reference;

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

@@ -12,7 +12,7 @@ namespace Microsoft.OpenApi.Models.References
     /// <summary>
     /// Schema reference object
     /// </summary>
-    public class OpenApiSchemaReference : OpenApiSchema, IOpenApiReferenceable
+    public class OpenApiSchemaReference : OpenApiSchema, IOpenApiReferenceableWithTarget<OpenApiSchema>
     {
 #nullable enable
         private OpenApiSchema? _target;

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

@@ -11,7 +11,7 @@ namespace Microsoft.OpenApi.Models.References
     /// <summary>
     /// Security Scheme Object Reference.
     /// </summary>
-    public class OpenApiSecuritySchemeReference : OpenApiSecurityScheme, IOpenApiReferenceable
+    public class OpenApiSecuritySchemeReference : OpenApiSecurityScheme, IOpenApiReferenceableWithTarget<OpenApiSecurityScheme>
     {
         internal OpenApiSecurityScheme _target;
         private readonly OpenApiReference _reference;

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

@@ -12,7 +12,7 @@ namespace Microsoft.OpenApi.Models.References
     /// <summary>
     /// Tag Object Reference
     /// </summary>
-    public class OpenApiTagReference : OpenApiTag, IOpenApiReferenceable
+    public class OpenApiTagReference : OpenApiTag, IOpenApiReferenceableWithTarget<OpenApiTag>
     {
         internal OpenApiTag _target;