Skip to content

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

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.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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