Closed johnament closed 1 year ago
Another benefit for build-time OpenAPI generation is that seucirty filters can get in the way. I've spent a few hours trying to get an existing application to whitelist these endpoints, and its complicated by there being a bunch of security filters already.
I tend to use https://github.com/kongchen/swagger-maven-plugin but it is a bit outdatedn nowadays regarding OpenApi standard and has no gradle support.
It tried this several times and I wonder how well other applications are designed so that one could effort to support starting up the application just for the sake of creating the openapi.json. I always stumble upon some runtime depencies causing trouble in such minimal profiles.
There are no plans for this feature.
If you feel it interesting for the community, please feel free to propose a PR.
We love springdoc. One thing we find a little annoying though is that to generate the documentation, the server must be running. Essentially the only thing the maven plugin does is calls the URL for the OpenAPI output and persists it to disk. While it checks the box that we can generate the documentation at build time, the overhead of needing to start the server in a dedicated phase of the build is a little much. So a couple of questions: