[CAMEL-17326] camel-rest-swagger: Resolve Swagger references

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 3.13.0
• Fix Version/s: 3.15.0
• Component/s: camel-rest-swagger
• Estimated Complexity: Unknown
• Assignee: Unassigned
• Reporter: Jeremy Ross
• Created: 13/Dec/21 19:59
• Updated: 14/Dec/21 06:27
• Resolved: 14/Dec/21 06:27

Description

Swagger supports references in the form of JSON References.

E.g., a swagger spec could contain a set of reusable parameter definitions:

"parameters": {
  "offset": {
    "description": "Indicates how many items should be skipped before returning results.",
    "in": "query",
    "name": "offset",
    "required": false,
    "default": 0,
    "format": "int32",
    "type": "integer"
  }
}

Then later in a path/operation definition, reference that parameter definition:

"parameters": [
  {
    "$ref": "#/parameters/offset"
  }
]

We should have an option to resolve these references so they are usable from Camel.

Issue Links

• links to: GitHub Pull Request #6536