Initial OpenAPI support for Vert.x

[phillip-kruger]

This PR adds initial support for Vert.x @Route to be included in the OpenAPI schema generation.

Fixes #10670

Fixes #8435

Signed-off-by: Phillip Kruger [email protected]

[cescoffier]

LGTM!

[gastaldi]

Fixes #10670

Fixes #8435

[mkouba]

I'm sorry for my ignorance but what's the scope of the initial OpenAPI support for Vert.x? I mean there are no OpenAPI annotations in the tests, no docs...

[phillip-kruger]

Hi @mkouba - this is generating openapi from the new vertx @Route. At this point, the only OpenAPI annotations we add, is when we can not automatically figure out something, like for example on a void return. Most tests for this is in SmallRye. Happy to add more tests here if needed.

[mkouba]

Ok, thanks Phillip!

So these are the important asserts 😄
https://github.com/quarkusio/quarkus/pull/10944/files#diff-720d8a9d7f47f0d3a806e32b5aefa169R37
https://github.com/quarkusio/quarkus/pull/10944/files#diff-d9dfefbe9d3dd228363dcd18f2656b79R39

How about the docs? Do you plan to send a follow-up PR and update the Reactive Routes guide?

[phillip-kruger]

@mkouba - yes I can definitely update the docs as well. Happy to do it in this PR or a next. Might be easier in a next as this one is green already :)

[phillip-kruger]

Here is the resources being test in SmallRye:

https://github.com/smallrye/smallrye-open-api/tree/master/extension-vertx/src/test/java/test/io/smallrye/openapi/runtime/scanner/resources

Any OpenAPI annotations should also work, but we can definably add more tests for that. It's get's fully tested in the Jax-rs tests, and the Spring and Vert.x only test their annotations.