Add Swagger UI Options via config

[phillip-kruger]

This PR adds all the options from Swagger UI as config options. (see https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration/)

It supersede #6314.
Close #6314
Fix #5639
Fix #4766

from #5639

(f.y.i - @misaunde and @valones)

quarkus.swagger-ui.doc-expansion=full
quarkus.swagger-ui.display-request-duration=true

from #6314

(f.y.i - @yntelectual @Postremus @aoudiamoncef)

You can add multiple urls now:

quarkus.swagger-ui.urls.default=/openapi
quarkus.swagger-ui.urls.petstore=https://petstore.swagger.io/v2/swagger.json

This will create the dropdown in the header:

from #4766

(f.y.i - @btsibr @Agh42)

quarkus.swagger-ui.oauth2-redirect-url=/somesecure/page/oauth.html
quarkus.swagger-ui.validator-url=localhost

Other

Theme
You can now select any theme from https://github.com/ostranme/swagger-ui-themes, example:

quarkus.swagger-ui.theme=monokai

Footer
You can add a footer:

quarkus.swagger-ui.footer=© 2020 . Phillip Kruger

Title
You can set the HTML title

quarkus.swagger-ui.title=OpenAPI for Everyone

Default title will be: OpenAPI UI (Powered by Quarkus version-number-here)

All other options from swagger ui available via config.

In dev mode, the options will take effect immediately.

Signed-off-by:Phillip Kruger phillip.kruger@gmail.com

[gsmet]

This is VERY nice. I wanted that for so long.

I added several totally uninteresting comments related to doc (sorry!) :).

[phillip-kruger]

@gastaldi @gsmet - Thanks for the review. All issues fixed as requested. Please let me know if there is anything else.

[gastaldi]

Outstanding job @phillip-kruger ! Nice!

Changes addressed

[gsmet]

Glad we finally have this one in! Thanks!

[matus-m]

hi any chance this will make it into 1.9.x? Or do we need to wait for 1.10? Thanks

[gastaldi]

This is planned for 1.10. According to https://github.com/quarkusio/quarkus/wiki/Release-Planning, the first CR should be available on Nov 10th.

[enbohm]

Great feature really like it! One question though, is it possible to change the logo at the top of Swagger UI? Currently it is the 'Quarkus' logo displayed but I can't find a way to have a custom one. Thanks,

[phillip-kruger]

@enbohm - see https://quarkus.io/blog/stylish-api/

[enbohm]

@phillip-kruger awesome big thx! :)

[enbohm]

@phillip-kruger I got the logo customization working after a while (worked when Quarkus was running in dev-mode but not using an executable jar or native). I noticed that I needed to specify the prepare-goal in the execution-section of the quarkus-maven-plugin (I only had the build-goal earlier). Might be good to add this info an upcoming guide since a bit tricky to figure out :)

Otherwise it works like a charm now, great job!