Details

    • Type: Task
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: 2.0.8, 2.1.0
    • Component/s: extensions
    • Labels:
      None

      Description

      Since we introduced the support for Swagger (as an extension), I believe many have found it very useful.

      We are currently shipping a patched version of Swagger UI 2.0 (backed by Swagger Core 1.5), with JS support manually enabled for Matrix parameters - as such parameters are not officially supported by Swagger UI 2.0.

      Luckily, after long discussions, it seems that Matrix parameters eventually found their way through the OpenAPI specification, and Swagger UI 3.0.

      In order to profit from this, we need to generate an OpenAPI 3.0- compliant descriptor, as the current /rest/swagger.json is at 2.0 but, due to the presence of matrix parameters, doesn't load with Swagger UI 3.0.

      There is an ongoing effort in CXF to provide full support for OpenAPI 3.0, but the work has just started; moreover, this will only land in CXF 3.2 - hence our branch 2_0_X will not use it anyway.

      Another approach, again provided by CXF, is the SwaggerToOpenApiConversionFilter, which is essentially an in-line transformer from the swagger.json we already generate, to the new openapi.json in OpenAPI 3.0 format.

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                ilgrosso Francesco Chicchiriccò
                Reporter:
                ilgrosso Francesco Chicchiriccò
              • Votes:
                0 Vote for this issue
                Watchers:
                2 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: