Merge pull request #2338 from microsoft/chore/rename-openApiAny

chore: rename OpenApiAny to JsonNodeExtension

Author: MaggieKimani1

docs/upgrade-guide-2.md

@@ -203,7 +203,7 @@ var openApiObject = new OpenApiObject
     }
 };
 var parameter = new OpenApiParameter();
-parameter.Extensions.Add("x-foo", new OpenApiAny(openApiObject));
+parameter.Extensions.Add("x-foo", openApiObject);
 
 ```
 
@@ -223,7 +223,7 @@ var openApiObject = new JsonObject
     }
 };
 var parameter = new OpenApiParameter();
-parameter.Extensions.Add("x-foo", new OpenApiAny(openApiObject));
+parameter.Extensions.Add("x-foo", new JsonNodeExtension(openApiObject));
 
 ```
 

src/Microsoft.OpenApi.Hidi/Extensions/OpenApiExtensibleExtensions.cs

@@ -1,4 +1,4 @@
-using Microsoft.OpenApi.Any;
+using Microsoft.OpenApi.Extensions;
 using Microsoft.OpenApi.Interfaces;
 using System.Collections.Generic;
 using System.Text.Json.Nodes;
@@ -15,7 +15,7 @@ internal static class OpenApiExtensibleExtensions
         /// <returns>A <see cref="string"/> value matching the provided extensionKey. Return null when extensionKey is not found. </returns>
         internal static string GetExtension(this Dictionary<string, IOpenApiExtension> extensions, string extensionKey)
         {
-            if (extensions.TryGetValue(extensionKey, out var value) && value is OpenApiAny { Node: JsonValue castValue } && castValue.TryGetValue<string>(out var stringValue))
+            if (extensions.TryGetValue(extensionKey, out var value) && value is JsonNodeExtension { Node: JsonValue castValue } && castValue.TryGetValue<string>(out var stringValue))
             {
                 return stringValue;
             }

src/Microsoft.OpenApi/Any/OpenApiAny.cs renamed to src/Microsoft.OpenApi/Extensions/JsonNodeExtension.cs

@@ -5,20 +5,20 @@
 using Microsoft.OpenApi.Interfaces;
 using Microsoft.OpenApi.Writers;
 
-namespace Microsoft.OpenApi.Any
+namespace Microsoft.OpenApi.Extensions
 {
     /// <summary>
     /// A wrapper class for JsonNode
     /// </summary>
-    public class OpenApiAny : IOpenApiElement, IOpenApiExtension
+    public class JsonNodeExtension : IOpenApiElement, IOpenApiExtension
     {
         private readonly JsonNode jsonNode;
 
         /// <summary>
-        /// Initializes the <see cref="OpenApiAny"/> class.
+        /// Initializes the <see cref="JsonNodeExtension"/> class.
         /// </summary>
         /// <param name="jsonNode"></param>
-        public OpenApiAny(JsonNode jsonNode)
+        public JsonNodeExtension(JsonNode jsonNode)
         {
             this.jsonNode = jsonNode;
         }
@@ -29,7 +29,7 @@ public OpenApiAny(JsonNode jsonNode)
         public JsonNode Node { get { return jsonNode; } }
 
         /// <summary>
-        /// Writes out the OpenApiAny type.
+        /// Writes out the JsonNodeExtension type.
         /// </summary>
         /// <param name="writer"></param>
         /// <param name="specVersion"></param>

src/Microsoft.OpenApi/MicrosoftExtensions/OpenApiDeprecationExtension.cs

@@ -5,7 +5,6 @@
 
 using System;
 using Microsoft.OpenApi.Extensions;
-using Microsoft.OpenApi.Any;
 using Microsoft.OpenApi.Interfaces;
 using Microsoft.OpenApi.Writers;
 using System.Text.Json.Nodes;
@@ -103,7 +102,7 @@ jsonNode is not JsonValue jsonValue ||
         return null;
     }
     /// <summary>
-    /// Parses the <see cref="OpenApiAny"/> to <see cref="OpenApiDeprecationExtension"/>.
+    /// Parses the <see cref="JsonNodeExtension"/> to <see cref="OpenApiDeprecationExtension"/>.
     /// </summary>
     /// <param name="source">The source object.</param>
     /// <returns>The <see cref="OpenApiDeprecationExtension"/>.</returns>

src/Microsoft.OpenApi/MicrosoftExtensions/OpenApiPrimaryErrorMessageExtension.cs

@@ -5,7 +5,7 @@
 
 using System;
 using System.Text.Json.Nodes;
-using Microsoft.OpenApi.Any;
+using Microsoft.OpenApi.Extensions;
 using Microsoft.OpenApi.Interfaces;
 using Microsoft.OpenApi.Writers;
 
@@ -34,7 +34,7 @@ public void Write(IOpenApiWriter writer, OpenApiSpecVersion specVersion)
     public bool IsPrimaryErrorMessage { get; set; }
 
     /// <summary>
-    /// Parses the <see cref="OpenApiAny"/> to <see cref="OpenApiPrimaryErrorMessageExtension"/>.
+    /// Parses the <see cref="JsonNodeExtension"/> to <see cref="OpenApiPrimaryErrorMessageExtension"/>.
     /// </summary>
     /// <param name="source">The source object.</param>
     /// <returns>The <see cref="OpenApiPrimaryErrorMessageExtension"/>.</returns>

src/Microsoft.OpenApi/MicrosoftExtensions/OpenApiReservedParameterExtension.cs

@@ -5,7 +5,7 @@
 
 using System;
 using System.Text.Json.Nodes;
-using Microsoft.OpenApi.Any;
+using Microsoft.OpenApi.Extensions;
 using Microsoft.OpenApi.Interfaces;
 using Microsoft.OpenApi.Writers;
 
@@ -35,7 +35,7 @@ public bool? IsReserved
         get; set;
     }
     /// <summary>
-    /// Parses the <see cref="OpenApiAny"/> to <see cref="OpenApiReservedParameterExtension"/>.
+    /// Parses the <see cref="JsonNodeExtension"/> to <see cref="OpenApiReservedParameterExtension"/>.
     /// </summary>
     /// <param name="source">The source object.</param>
     /// <returns>The <see cref="OpenApiReservedParameterExtension"/>.</returns>

src/Microsoft.OpenApi/Models/OpenApiRequestBody.cs

@@ -4,7 +4,6 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using Microsoft.OpenApi.Any;
 using Microsoft.OpenApi.Extensions;
 using Microsoft.OpenApi.Interfaces;
 using Microsoft.OpenApi.Models.Interfaces;
@@ -110,7 +109,7 @@ public IOpenApiParameter ConvertToBodyParameter(IOpenApiWriter writer)
             // Clone extensions so we can remove the x-bodyName extensions from the output V2 model.
             if (bodyParameter.Extensions is not null && 
                 bodyParameter.Extensions.TryGetValue(OpenApiConstants.BodyName, out var bodyNameExtension) &&
-                bodyNameExtension is OpenApiAny bodyName)
+                bodyNameExtension is JsonNodeExtension bodyName)
             {
                 bodyParameter.Name = string.IsNullOrEmpty(bodyName.Node.ToString()) ? "body" : bodyName.Node.ToString();
                 bodyParameter.Extensions.Remove(OpenApiConstants.BodyName);

src/Microsoft.OpenApi/Models/OpenApiSchema.cs

@@ -6,7 +6,6 @@
 using System.Linq;
 using System.Text.Json;
 using System.Text.Json.Nodes;
-using Microsoft.OpenApi.Any;
 using Microsoft.OpenApi.Extensions;
 using Microsoft.OpenApi.Helpers;
 using Microsoft.OpenApi.Interfaces;
@@ -755,7 +754,7 @@ private void SerializeTypeProperty(JsonSchemaType? type, IOpenApiWriter writer,
             var isNullable = (Type.HasValue && Type.Value.HasFlag(JsonSchemaType.Null)) ||
                                 Extensions is not null &&
                                 Extensions.TryGetValue(OpenApiConstants.NullableExtension, out var nullExtRawValue) &&
-                                nullExtRawValue is OpenApiAny { Node: JsonNode jsonNode } &&
+                                nullExtRawValue is JsonNodeExtension { Node: JsonNode jsonNode } &&
                                 jsonNode.GetValueKind() is JsonValueKind.True;
             if (type is null)
             {

src/Microsoft.OpenApi/Reader/ParseNodes/AnyMapFieldMapParameter.cs

@@ -27,7 +27,7 @@ public AnyMapFieldMapParameter(
         }
 
         /// <summary>
-        /// Function to retrieve the property that is a map from string to an inner element containing IOpenApiAny.
+        /// Function to retrieve the property that is a map from string to an inner element.
         /// </summary>
         public Func<T, Dictionary<string, U>?> PropertyMapGetter { get; }
 

src/Microsoft.OpenApi/Reader/ParseNodes/MapNode.cs

@@ -9,8 +9,8 @@
 using System.Text.Json;
 using System.Text.Json.Nodes;
 using System.Text.Json.Serialization;
-using Microsoft.OpenApi.Any;
 using Microsoft.OpenApi.Exceptions;
+using Microsoft.OpenApi.Extensions;
 using Microsoft.OpenApi.Models;
 
 namespace Microsoft.OpenApi.Reader.ParseNodes
@@ -191,7 +191,7 @@ public override string GetRaw()
         }
 
         /// <summary>
-        /// Create an <see cref="OpenApiAny"/>
+        /// Create an <see cref="JsonNodeExtension"/>
         /// </summary>
         /// <returns>The created Json object.</returns>
         public override JsonNode CreateAny()