swagger-maven-plugin | Maven plugin to activate the Swagger Core library | REST library

We are using SpringDoc in our WebFlux project to annotate our APIs and serve OpenAPI documentation from a UI. However, now we need the OpenAPI file generated as part of the maven build.

SpringDoc has a plugin to fetch the file from a running service, where the service has been started by spring plugin, but our service requires a lot of stuff to be set up in order to run. We are doing this setup in our tests' @BeforeClass and don't want to extract that setup (and the corresponding cleanup) just so that the service can be started as part of the maven build. Plus we plan to eventually stop starting up the service for our tests and instead use mocks, so adding a test to retrieve the file from the running test is only a temporary solution (would like to not have to maintain startup code just in order to retrieve the OpenAPI doc).

I have tried using the swagger-maven-plugin from swagger-core, but it seems to require jaxrs, which we are not using. I have also looked into SpringFox, but it also does not offer the desired functionality.

Any ideas on how to generate OpenAPI documentation for a WebFlux project as part of the maven build without starting the service?

I have a Jersey application that's currently using Swagger 1.6

Below are the important segments from the pom file of the project

In my project I have some sub-resources, correctly implemented according to the Jersey framework guidelines.

However, I have a problem in generating the openapi.json file (generated by swagger-maven-plugin). In particular, I would like to be able to use the @Api swagger annotation on classes that implement sub-resources, to apply some properties, such as authorizations.

The problem is that if I use the @Api annotation on the sub-resource classes, swagger sees those classes not only as a sub-resources, but also as resources. The result is that in the openapi.json file, for each sub-resource, a same resource is generated (which should not exist).

The root resource:

I'm trying to document my api using the swagger-maven-plugin.

When I annotate a route param with @Parameter, it's well documented in the openapi generated file as long as it's not annotated with @BeanParam.

As stated in the swagger core documentation,

The @Parameter can be used in place of or together with the JAX-RS parameter annotations (@PathParam, @QueryParam, @HeaderParam, @FormParam and @BeanParam). While swagger-core / swagger-jaxrs2 scan these annotations by default, the @Parameter allows to define more details for the parameter.

How can I get my @BeanParam parameters documented in my openapi file?

Here is my pom.xml:

I'm trying to generate a API documentation/swagger client for a Java EE application using Swagger / OpenAPI 3.0, but one method keeps missing in the documentation. I created a sample project to clarify my problem:

New, less complex example:

I got an Interface with a List as a parameter for my REST endpoint: