Fix documentation for programmatic RouterFunctions about springdoc.github.io HOT 4 CLOSED

To further clarify this. I'm just trying to add openapi details programmatically. I currently have annotations on my RouterFunctions and HandlerFunctions. But a lot of these are exactly the same except for operationId and return types, so I'm trying to create some generic functions to apply the openapi information to them. To do this, I need to use the programmatic openapi interface. The only way I can see to do this is with the org.springdoc.core.fn.builders.apiresponse.Builder api and somehow attach it to the RouterFunction. But i don't see any way to do that, since the methods in the examples don't exist in the latest spring webflux.

from springdoc.github.io.

Hey, so I think this is a documentation issue. On the main springdoc page for the programmatic openapi feature, you should point out that the route() method in your example is not the normal route() method from functional spring webflux routing. Looking more closely at the example code and javadocs, I see you have a SpringdocRouteBuilder.route() that is completely different than the normal spring RouterFunctions.route() method that people are used to calling.

The fact these are different methods isn't mentioned in your documentation, and since you do a static import in the example code, it was really easy to miss.

from springdoc.github.io.

@johnellinwood,

If you have bugs in the documentation, please feel free to update directly the related .adoc files.

from springdoc.github.io.

closed as no activity

from springdoc.github.io.