Skip to content

Open API generator for Spring does not (?) support Open API 3 annotations #23

@aniewielska

Description

@aniewielska

The current situation of OpenAPI 3 vs 3 support:

  • TES spec is exclusively in OpenAPI 3
  • The current version of TESK uses a new version of OpenAPI Generator for Spring in the form of Maven Plugin
  • The generator and plugin accept specification in OpenAPI 3, but the generated annotations correspond to Swagger 2.
  • It does not seem at the moment to be possible to generate OpenAPI 3 models or at least it is not straightforward:
  • Issue 8703
  • Issue 5803
  • PR 6306
    and more.
    Additionally, there seems to be now an alternative to SpringFox in the form of SpringDoc
    Verdict: for now TESK will present OpenAPI 2 docs via UI and wait for support of OpenAPI3 in generator or an alternative solution.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions