Merge remote-tracking branch 'origin/master' into dm/securityrefs

Author: darrelmiller

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

@@ -87,7 +87,7 @@ internal static partial class OpenApiV3Deserializer
                 {
                     "examples", (o, n) =>
                     {
-                        o.Examples = ((ListNode)n).Select(s => LoadExample(s)).ToList();
+                        o.Examples = n.CreateMap(LoadExample);
                     }
                 },
                 {

src/Microsoft.OpenApi/Models/OpenApiParameter.cs

@@ -101,7 +101,7 @@ public class OpenApiParameter : IOpenApiSerializable, IOpenApiReferenceable, IOp
         /// Furthermore, if referencing a schema which contains an example,
         /// the examples value SHALL override the example provided by the schema.
         /// </summary>
-        public IList<OpenApiExample> Examples { get; set; } = new List<OpenApiExample>();
+        public IDictionary<string,OpenApiExample> Examples { get; set; } = new Dictionary<string,OpenApiExample>();
 
         /// <summary>
         /// Example of the media type. The example SHOULD match the specified schema and encoding properties
@@ -189,7 +189,7 @@ public void SerializeAsV3WithoutReference(IOpenApiWriter writer)
             writer.WriteOptionalObject(OpenApiConstants.Example, Example, (w, s) => w.WriteAny(s));
 
             // examples
-            writer.WriteOptionalCollection(OpenApiConstants.Examples, Examples, (w, e) => e.SerializeAsV3(w));
+            writer.WriteOptionalMap(OpenApiConstants.Examples, Examples, (w, e) => e.SerializeAsV3(w));
 
             // content
             writer.WriteOptionalMap(OpenApiConstants.Content, Content, (w, c) => c.SerializeAsV3(w));

src/Microsoft.OpenApi/Services/OpenApiWalker.cs

@@ -532,6 +532,8 @@ internal void Walk(OpenApiParameter parameter)
             _visitor.Visit(parameter);
             Walk(OpenApiConstants.Schema, () => Walk(parameter.Schema));
             Walk(OpenApiConstants.Content, () => Walk(parameter.Content));
+            Walk(OpenApiConstants.Examples, () => Walk(parameter.Examples));
+
             Walk(parameter as IOpenApiExtensible);
         }
 

test/Microsoft.OpenApi.Tests/Models/OpenApiParameterTests.cs

@@ -47,9 +47,9 @@ public class OpenApiParameterTests
                 Title = "title2",
                 Description = "description2"
             },
-            Examples = new List<OpenApiExample>
+            Examples = new Dictionary<string,OpenApiExample>
             {
-                new OpenApiExample
+                ["test"] = new OpenApiExample
                 {
                     Summary = "summary3",
                     Description = "description3"
@@ -97,12 +97,12 @@ public void SerializeAdvancedParameterAsV3JsonWorks()
     ""title"": ""title2"",
     ""description"": ""description2""
   },
-  ""examples"": [
-    {
+  ""examples"": {
+    ""test"": {
       ""summary"": ""summary3"",
       ""description"": ""description3""
     }
-  ]
+  }
 }";
 
             // Act