Fix for issue 892

Warn message is missing when the path key doesn't start with slash

Author: saileshsingh

modules/swagger-parser-v3/src/main/java/io/swagger/v3/parser/util/OpenAPIDeserializer.java

@@ -524,6 +524,9 @@ public Paths getPaths(ObjectNode obj, String location, ParseResult result) {
                 if (!pathValue.getNodeType().equals(JsonNodeType.OBJECT)) {
                     result.invalidType(location, pathName, "object", pathValue);
                 } else {
+                    if(!pathName.startsWith("/")){
+                        result.warning(location," Resource "+pathName+ " should start with /");
+                    }
                     ObjectNode path = (ObjectNode) pathValue;
                     PathItem pathObj = getPathItem(path,String.format("%s.'%s'", location,pathName), result);
                     paths.put(pathName, pathObj);
@@ -2670,6 +2673,7 @@ protected static class ParseResult {
         private Map<Location, JsonNode> unsupported = new LinkedHashMap<>();
         private Map<Location, String> invalidType = new LinkedHashMap<>();
         private List<Location> missing = new ArrayList<>();
+        private List<Location> warnings = new ArrayList<>();
 
         public ParseResult() {
         }
@@ -2686,6 +2690,10 @@ public void missing(String location, String key) {
             missing.add(new Location(location, key));
         }
 
+        public void warning(String location, String key) {
+            warnings.add(new Location(location, key));
+        }
+
         public void invalidType(String location, String key, String expectedType, JsonNode value) {
             invalidType.put(new Location(location, key), expectedType);
         }
@@ -2715,6 +2723,11 @@ public List<String> getMessages() {
                 String message = "attribute " + location + l.key + " is missing";
                 messages.add(message);
             }
+            for (Location l : warnings) {
+                String location = l.location.equals("") ? "" : l.location + ".";
+                String message = "attribute " + location +l.key;
+                messages.add(message);
+            }
             for (Location l : unsupported.keySet()) {
                 String location = l.location.equals("") ? "" : l.location + ".";
                 String message = "attribute " + location + l.key + " is unsupported";

modules/swagger-parser/src/test/java/io/swagger/parser/OpenAPIParserTest.java

@@ -64,6 +64,15 @@ public void testSimple() {
         assertEquals(result.getOpenAPI().getOpenapi(), "3.0.1");
     }
 
+    @Test
+    public void testIssue892() {
+        SwaggerParseResult result = new OpenAPIParser().readLocation("issue892-main.yaml", null, null);
+
+        assertEquals(result.getMessages().size(),1);
+        assertNotNull(result.getOpenAPI());
+        assertEquals(result.getOpenAPI().getOpenapi(), "3.0.1");
+    }
+
     @Test
     public void testIssue768() {
         ParseOptions options = new ParseOptions();

modules/swagger-parser/src/test/resources/issue892-main.yaml

@@ -0,0 +1,22 @@
+openapi: 3.0.1
+info:
+  title: ping test
+  version: '1.0'
+servers:
+  - url: 'http://localhost:8000/'
+paths:
+  some/ping:
+    get:
+      operationId: pingGet
+      parameters:
+        - name: i
+          in: query
+          description: Test
+          required: true
+          schema:
+            $ref: './issue749-reference.yaml#/SomeId'
+      responses:
+        '201':
+          description: OK
+components:
+  schemas: {}