More cleans for the DOM classes

Author: xuzhg

src/Microsoft.OpenApi.Readers/V3/OpenApiExampleDeserializer.cs

@@ -32,7 +32,7 @@ internal static partial class OpenApiV3Deserializer
             {
                 "value", (o, n) =>
                 {
-                    o.Value = n.GetScalarValue();
+                    o.Value = n.CreateAny();
                 }
             },
         };

src/Microsoft.OpenApi/Models/OpenApiEncoding.cs

@@ -77,16 +77,10 @@ internal override void WriteAsV3(IOpenApiWriter writer)
             writer.WriteProperty(OpenApiConstants.Style, Style?.GetDisplayName());
 
             // explode
-            if (Explode != null)
-            {
-                writer.WriteProperty(OpenApiConstants.Explode, Explode.Value, false);
-            }
+             writer.WriteProperty(OpenApiConstants.Explode, Explode, false);
 
             // allowReserved
-            if (AllowReserved != null)
-            {
-                writer.WriteProperty(OpenApiConstants.AllowReserved, AllowReserved.Value, false);
-            }
+            writer.WriteProperty(OpenApiConstants.AllowReserved, AllowReserved, false);
 
             // extensions
             writer.WriteExtensions(Extensions);

src/Microsoft.OpenApi/Models/OpenApiExample.cs

@@ -31,7 +31,7 @@ public class OpenApiExample : OpenApiElement, IOpenApiReference, IOpenApiExtensi
         /// exclusive. To represent examples of media types that cannot naturally represented 
         /// in JSON or YAML, use a string value to contain the example, escaping where necessary.
         /// </summary>
-        public string Value { get; set; }
+        public IOpenApiAny Value { get; set; }
 
         /// <summary>
         /// A URL that points to the literal example. 
@@ -71,19 +71,22 @@ internal override void WriteAsV3(IOpenApiWriter writer)
             else
             {
                 writer.WriteStartObject();
-                writer.WriteProperty("summary", Summary);
-                writer.WriteProperty("description", Description);
-
-                if (Value != null)
-                {
-                    writer.WritePropertyName("value");
-                    writer.WriteRaw(Value);
-                } else if (ExternalValue != null)
-                {
-                    writer.WriteProperty("externalValue", ExternalValue);
-                }
 
+                // summary
+                writer.WriteProperty(OpenApiConstants.Summary, Summary);
+
+                // description
+                writer.WriteProperty(OpenApiConstants.Description, Description);
+
+                // value
+                writer.WriteOptionalObject(OpenApiConstants.Value, Value, (w, v) => w.WriteAny(v));
+
+                // externalValue
+                writer.WriteProperty(OpenApiConstants.ExternalValue, ExternalValue);
+
+                // extensions
                 writer.WriteExtensions(Extensions);
+
                 writer.WriteEndObject();
             }
         }

src/Microsoft.OpenApi/Models/OpenApiExternalDocs.cs

@@ -56,10 +56,13 @@ private void WriteInternal(IOpenApiWriter writer)
 
             writer.WriteStartObject();
 
+            // description
             writer.WriteProperty(OpenApiConstants.Description, Description);
 
+            // url
             writer.WriteProperty(OpenApiConstants.Url, Url?.OriginalString);
 
+            // extensions
             writer.WriteExtensions(Extensions);
 
             writer.WriteEndObject();

src/Microsoft.OpenApi/Models/OpenApiMediaType.cs

@@ -80,7 +80,7 @@ internal override void WriteAsV3(IOpenApiWriter writer)
         /// </summary>
         internal override void WriteAsV2(IOpenApiWriter writer)
         {
-            // nothing here
+            // Media type does not exist in V2.
         }
     }
 }