spring-plugin-core:1.2.0 from 2015…
# springb
bjonnh
04/25/2019, 5:40 PMspring-plugin-core:1.2.0 from 2015…
s
sdeleuze
04/25/2019, 6:33 PMSpringFox seems unmaintained, did anybody try https://github.com/OpenAPITools/openapi-generator?
m
Mike
04/25/2019, 6:56 PMAre you referring to this project? Github was 2 months ago. https://springfox.github.io/springfox/
If so, the openapi-generator is for a different thing, isn’t it?
Isn’t Spring Fox for publishing a spec from annotations on the classes?
Whereas openapi-generator is for generating code given a spec already. So the 2 approaches to only defining the API once.
If you want to generate code given an api, then I can highly recommend the openapi-generator.
b
bjonnh
04/25/2019, 7:06 PMI'm using springfox to generate a swagger file for my orchid documentation (live api experimentation)
s
sdeleuze
04/25/2019, 7:43 PM@Mike indeed
sdeleuze
04/25/2019, 8:10 PMI am referring to that project yeah, the maintainer seems to have difficulties to release the long awaited 3.0
sdeleuze
04/25/2019, 8:11 PMm
Mike
04/25/2019, 8:51 PMI haven’t been following spring fox as I use openapi generator because I start with the spec, and then just expose the spec file as a static resource.
f
fitzoh
04/25/2019, 9:18 PM@sdeleuze any idea if first class support for openapi has ever been considered?
s
sdeleuze
04/25/2019, 9:59 PMFirst class support for this domain currently mostly focus on https://spring.io/projects/spring-restdocs which provides a great alternative answer, but I am puzzled to see the status of SpringFox. I will maybe try to reach the maintainer to see how we could help him.
m
Mike
04/26/2019, 1:28 AMSpring tends to focus on Annotation based definition of the API on the Controllers, hence Spring-Fox or spring-restdocs.
OpenAPI-generator is focused on generating a Client or Server given an API. Spring is merely one of many potential targets of code. I’m not sure how Spring would incorporate it as it’s more of a build task.
s
sdeleuze
04/26/2019, 5:48 AMA good alternative is maybe https://github.com/ePages-de/restdocs-api-spec
sdeleuze
04/26/2019, 5:51 AMYou can also vote for https://github.com/spring-projects/spring-restdocs/issues/213
👍 2
b
bjonnh
04/26/2019, 12:59 PMOrchid builds an API playground from a swagger definition
bjonnh
04/26/2019, 12:59 PMso anything that builds a definition would work
s
sdeleuze
04/26/2019, 12:59 PMAny link to Orchid ?
b
bjonnh
04/26/2019, 5:13 PMbjonnh
04/26/2019, 5:13 PMI like it, I can do pages of docs, integrate UML diagrams etc
s
sdeleuze
04/26/2019, 5:30 PMThanks I will have a look
m
Mike
04/26/2019, 6:13 PMAnd it ‘understands’ Dokka, so can publish your Dokka docs easily.
➕ 1
6 Views