Hi Irfan, Thanks a lot for the feedback.
1) Would you mind providing a short snippet of endpoint definition + OpenAPI annotations? (beside just @Schema) 2) I think the only way to have an example through Java annotations is to use formatted JSON as plain old String. It would be a good question to Swagger guys (https://swagger.io/forum/) actually. Thank you. Best Regards, Andriy Redko IP> Hi, IP> I have been CXF Framework for OpenAPI and its been very easy to use so far. IP> I have few questions where I am not finding proper documentation/examples IP> on how to do it. It would be great, if you can help me figuring out what IP> seems to be happening. IP> 1. To perform a file upload for the type org.apache.cxf.jaxrs.ext.multipart IP> *.Attachment, *I added the following schema and the content-type is IP> "MULTIPART_FORM_DATA", but I am still seeing the $ref in my open-api.json IP> as "*#/components/schemas/Attachment*" which is a JSONObject. IP> @Schema(type = "file", format = "binary", description = "descriptor") ) IP> Is there a valid schema for Attachment type ? IP> 2. Is there a way to provide a formatted JSONObject as an example instead IP> of defining a string in the @Schema object ? I see lot of examples with IP> Swagger where they show the example as valid JSONObject, but not sure how IP> they would do that with constants. IP> Thank you in advance ! IP> Regards, IP> Irfan
