Джерси предоставляет JAX-RS MessageBodyWriter
для автоматического преобразования BufferedImage
в типы носителей, такие как image/png
.
@Api("My Service")
@Component
@Path("/")
@Produces("image/png")
public interface MyService {
@Path("map")
@GET
BufferedImage generateMap();
}
Когда Swagger сканирует этот ресурс, кажется, что он не понимает происходящего преобразования и описывает всю внутреннюю схему java.awt.image.BufferedImage
в API.
...
produces:
- "image/png"
responses:
200:
description: "successful operation"
schema:
$ref: "#/definitions/BufferedImage"
... ~700 lines describing Java's BufferedImage object
Как мы используем аннотации Swagger, чтобы правильно представить этот ответ в виде двоичного файла?