javalin / javalin-openapi

Annotation processor for compile-time OpenAPI & JsonSchema, with out-of-the-box support for Javalin 5.x, Swagger & ReDoc
https://github.com/javalin/javalin-openapi/wiki
Apache License 2.0
45 stars 17 forks source link

Programatically Define Documentation #219

Closed MrThreepwood closed 3 months ago

MrThreepwood commented 4 months ago

All our projects were previously programmatically defining our open api docs with javalin. Has support for that been dropped? How do you do that now?

dzikoysk commented 3 months ago

Hey, sorry for late response - I missed this question. Technically it was not dropped, because this is just a completely different plugin that replaced the old now and I simply never implemented that. It was already requested tho, and progress can be tracked here:

The problem here is that currently, this plugin works at compile-time, so it requires basically rewriting the whole docs builder in order to have it supported.

I started prototyping something a while ago, but I didn't have time to go back to this, especially that it'd most likely require some breaking changes, so it's probably a matter of fruther major Javalin version, like 7+.