Swagger для конечной точки Джерси, возвращающей BufferedImage - PullRequest
0 голосов
/ 17 января 2019

Джерси предоставляет 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, чтобы правильно представить этот ответ в виде двоичного файла?

...