Springdoc v2 with Spring 6 (without Spring Boot)

[ML-Marco]

While the documentation for v1 had a FAQ entry on how to use the library in a project without Spring Boot, this entry no longer exists in the v2 documentation.

Does this mean the project is no longer useable in applications that only make use of the Spring Framework 6 without Spring Boot 3?

I think it'd be helpful for others if the answer to this question could be added to the documentation, in case it's not already there and I missed it.

[bnasslahsen]

@ML-Marco,

Currently, there has been no such a request to use Spring 6.
But technically, there no reason why it shouldn't work.

If you have any Minimal, Reproducible Example - with HelloController that needs to use springdoc v2, feel free to share.

[ML-Marco]

@bnasslahsen
I have created a minimal project with Spring 6, Jetty 11 and a TestController here: https://github.com/ML-Marco/springdoc-with-spring-6

Maybe you can add this to the list of examples. I'm sure this can be helpful for others too.

Two more questions: It seems to be required to specify springdoc.swagger-ui.version. Otherwise the SwaggerResourceResolver will look in the wrong place. Can this be optimized to default to the version that you specify in the parent pom for the webjar?

Do you have a feeling for how complicated it would be to refactor the project so that Spring Boot is an optional dependency and not a required one? There is no real alternative when it comes to Swagger and Spring and I think that there are more projects out there that only use Spring Framework 6 (without Spring Boot). Adding the Spring Boot dependency just for this library adds quite a lot of classes.

[bnasslahsen]

@ML-Marco,

I have attached a sample working sample, where you do not have to reference the springdoc.swagger-ui.version.
springdoc-with-spring-6.zip

swagger-ui: http://localhost:1337/swagger-ui.html
api-docs url: http://localhost:1337/v3/api-docs

Let me know if it works for you.
Once it's validated, we can update the documentation accordingly.

[ML-Marco]

@bnasslahsen

Thanks for that. It's working and what I was missing was the registration of SpringDocUIConfiguration which sets the correct Swagger UI version.

I updated my repository.

[bnasslahsen]

@ML-Marco,

Thank you for your feedback.
We will then update the FAQ very sonne with the guidance as well.