Microcks
-
|
As per title, please point me in the direction of a java example. I am having trouble determining which set of swagger annotations need to be present on my endpoints to play nice when imported into Microcks. |
Beta Was this translation helpful? Give feedback.
Replies: 1 comment 1 reply
-
|
Hi @gsrunion Unfortunately no : we have no sample on how to generate Swagger or OpenAPI contract from annotated Java file. I suspect some users in the community are doing this but mostly as a bootstrap method for getting contract they will later complement with examples and extend. I suspect that if you want a comprehensive schema that directly worked with Microcks OOTB, you'll have to annotate your Java code with Please let us know and share your findings! |
Beta Was this translation helpful? Give feedback.
-
|
I've developed such a sample here: lbroudoux/sample-quarkus-microservices@717c583 |
Beta Was this translation helpful? Give feedback.
Hi @gsrunion
Unfortunately no : we have no sample on how to generate Swagger or OpenAPI contract from annotated Java file. I suspect some users in the community are doing this but mostly as a bootstrap method for getting contract they will later complement with examples and extend.
I suspect that if you want a comprehensive schema that directly worked with Microcks OOTB, you'll have to annotate your Java code with
@ExampleObjectfor both request body and responses (see https://javadoc.io/doc/io.swagger.core.v3/swagger-annotations/latest/io/swagger/v3/oas/annotations/media/ExampleObject.html).Please let us know and share your findings!