bump core version and add test for null example serialization

Author: frantuma

.editorconfig

@@ -0,0 +1,20 @@
+# http://editorconfig.org
+
+# A special property that should be specified at the top of the file outside of
+# any sections. Set to true to stop .editor config file search on current file
+root = true
+
+[*]
+# Indentation style
+# Possible values - tab, space
+indent_style = space
+
+# File character encoding
+# Possible values - latin1, utf-8, utf-16be, utf-16le
+charset = utf-8
+
+[modules/swagger-parser-v3/src/test/resources/**/*.json]
+trim_trailing_whitespace = false
+
+[modules/swagger-parser-v3/src/test/resources/**/*.yaml]
+trim_trailing_whitespace = false

modules/swagger-parser-v3/src/test/java/io/swagger/v3/parser/test/OpenAPIV3ParserTest.java

@@ -232,7 +232,7 @@ public void testIssue251() throws IOException {
         assertTrue(parseResult.getOpenAPI().getComponents().getSchemas().size() == 2);
         assertTrue(parseResult.getOpenAPI().getPaths().get("/parse").getGet().getParameters().get(0).getSchema().get$ref().equals("#/components/schemas/Parse"));
     }
-    
+
     @Test
     public void testCantReadDeepProperties() {
         OpenAPIV3Parser parser = new OpenAPIV3Parser();
@@ -244,7 +244,7 @@ public void testCantReadDeepProperties() {
         Schema projects = (Schema) parseResult.getOpenAPI().getComponents().getSchemas().get("Project").getProperties().get("project_type");
         assertEquals(projects.getType(), "integer");
     }
-  
+
     @Test
     public void testIssueSameRefsDifferentModel() throws IOException {
         String pathFile = FileUtils.readFileToString(new File("src/test/resources/same-refs-different-model-domain.yaml"), "UTF-8");
@@ -2966,4 +2966,16 @@ public void testIssue1540() throws Exception{
         Assert.assertNotNull(testPutExtensions.get("x-order"));
         Assert.assertEquals((String)testPutExtensions.get("x-order"),"2147483647");
     }
+
+    @Test
+    public void testNullExample() throws Exception{
+        String yamlString = FileUtils.readFileToString(new File("src/test/resources/null-full-example.yaml"), "UTF-8");
+        String yamlStringResolved = FileUtils.readFileToString(new File("src/test/resources/null-full-example-resolved.yaml"), "UTF-8");
+        ParseOptions options = new ParseOptions();
+        options.setResolveFully(true);
+        options.setResolveCombinators(false);
+        OpenAPI openAPI = new OpenAPIV3Parser().readContents(yamlString, null, options).getOpenAPI();
+        Assert.assertNotNull(openAPI);
+        assertEquals(Yaml.pretty(openAPI), yamlStringResolved);
+    }
 }

modules/swagger-parser-v3/src/test/resources/null-example.yaml

@@ -0,0 +1,138 @@
+openapi: 3.0.2
+info:
+  title: VirtServer support for null examples
+  version: 1.0.0
+paths:
+
+  /object-with-null-example:
+    get:
+      description: Response should be `null`
+      responses:
+        '200':
+          description: Should be `null`
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ObjectWithNullExample'
+
+  /object-with-null-in-schema-example:
+    get:
+      description: 'Response should be `{..., "d": null}`'
+      responses:
+        '200':
+          description: 'Should be `{..., "d": null}`'
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ObjectWithNullInSchemaExample'
+
+  /object-with-null-property-example:
+    get:
+      description: 'Response should be `{"a": 5, "b": null}`'
+      responses:
+        '200':
+          description: 'Should be `{"a": 5, "b": null}`'
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ObjectWithNullPropertyExample'
+
+  /string-with-null-example:
+    get:
+      description: Response should be `null`
+      responses:
+        '200':
+          description: Should be `null`
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/StringWithNullExample'
+
+  /array-with-null-array-example:
+    get:
+      description: Response should be `null`
+      responses:
+        '200':
+          description: Should be `null`
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ArrayWithNullArrayExample'
+
+  /array-with-null-item-example:
+    get:
+      description: Response should be `[null]`
+      responses:
+        '200':
+          description: Should be `[null]`
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ArrayWithNullItemExample'
+
+  /arrey-with-null-in-array-example:
+    get:
+      description: Response should be `["foo", null]`
+      responses:
+        '200':
+          description: Should be `["foo", null]`
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ArrayWithNullInArrayExample'
+
+components:
+  schemas:
+
+    ObjectWithNullExample:
+      type: object
+      properties:
+        foo:
+          type: string
+      nullable: true
+      example: null
+
+    ObjectWithNullInSchemaExample:
+      type: object
+      example:
+        a: 5
+        b: test
+        c: true
+        d: null
+
+    ObjectWithNullPropertyExample:
+      type: object
+      properties:
+        a:
+          type: integer
+          example: 5
+        b:
+          type: string
+          nullable: true
+          example: null
+
+    StringWithNullExample:
+      type: string
+      nullable: true
+      example: null
+
+    ArrayWithNullArrayExample:
+      type: array
+      items:
+        type: string
+      nullable: true
+      example: null
+
+    ArrayWithNullItemExample:
+      type: array
+      items:
+        type: string
+        nullable: true
+        example: null
+
+    ArrayWithNullInArrayExample:
+      type: array
+      items:
+        type: string
+        nullable: true
+      example: [foo, null]