fix: examples not resolved when path parameter in reference chain (#2244)

Author: jhemelhof

modules/swagger-parser-v3/src/main/java/io/swagger/v3/parser/processors/ExternalRefProcessor.java

@@ -968,7 +968,7 @@ private void processRefExamples(Map<String, Example> examples, String $ref) {
             if (example.get$ref() != null) {
                 RefFormat ref = computeRefFormat(example.get$ref());
                 if (isAnExternalRefFormat(ref)) {
-                    processRefExample(example, $ref);
+                    processRefExample(example, file);
                 } else {
                     processRefToExternalExample(file + example.get$ref(), RefFormat.RELATIVE);
                 }

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

@@ -3362,6 +3362,20 @@ public void testIssue2081() {
         assertEquals(openAPI.getComponents().getSchemas().get("PetCreate").getProperties().size(), 2);
     }
 
+    @Test(description = "should resolve nested referenced examples even when parent reference contains path parameter")
+    public void testIssue2244() {
+        OpenAPIV3Parser openApiParser = new OpenAPIV3Parser();
+        ParseOptions options = new ParseOptions();
+        options.setResolve(true);
+        SwaggerParseResult parseResult = openApiParser.readLocation("issue-2244/openapi.yaml", null, options);
+        OpenAPI openAPI = parseResult.getOpenAPI();
+
+        assertNotNull(openAPI.getComponents().getExamples(), "should have resolved the component examples");
+        Set<String> exampleNames = new HashSet<>();
+        exampleNames.add("ReproducerExample");
+        assertEquals(openAPI.getComponents().getExamples().keySet(), exampleNames);
+    }
+
     @Test(description = "responses should be inline")
     public void testFullyResolveResponses() {
         ParseOptions options = new ParseOptions();

modules/swagger-parser-v3/src/test/resources/issue-2244/components.yaml

@@ -0,0 +1,13 @@
+openapi: 3.0.3
+
+components:
+  schemas:
+    ReproducerObject:
+      type: object
+      properties:
+        id:
+          type: integer
+  examples:
+    ReproducerExample:
+      value:
+        id: 1

modules/swagger-parser-v3/src/test/resources/issue-2244/openapi.yaml

@@ -0,0 +1,10 @@
+openapi: 3.0.3
+
+info:
+  title: Reproducer
+  description: Reproducer for the issue
+  version: 1.0.0
+
+paths:
+  /reproducers/{id}:
+    $ref: "operations.yaml#/paths/~1reproducers~1{id}"

modules/swagger-parser-v3/src/test/resources/issue-2244/operations.yaml

@@ -0,0 +1,16 @@
+openapi: 3.0.3
+
+paths:
+  /reproducers/{id}:
+    post:
+      description: Reproducer
+      responses:
+        "200":
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "components.yaml#/components/schemas/ReproducerObject"
+              examples:
+                normal:
+                  $ref: "components.yaml#/components/examples/ReproducerExample"