Swagger-ui 没有提供我如何传递 MediaType.APPLICATION_OCTET_STREAM 内容

Question

实际上我遇到了一个问题，即 Swagger-ui 无法向我显示 MediaType.APPLICATION_OCTET_STREAM 的输入，所以让我们想象一下下一个服务：

@PUT

@Path("/performAudioQuery")

@Consumes(MediaType.APPLICATION_OCTET_STREAM)

公共响应 performAudioQuery(InputStream audioInputStream){ //服务的实现 }

这里是依赖项

<dependency>
        <groupId>io.swagger</groupId>
        <artifactId>swagger-jersey2-jaxrs</artifactId>
        <version>1.5.6</version>
    </dependency>
    <dependency>
        <groupId>org.glassfish.jersey.media</groupId>
        <artifactId>jersey-media-multipart</artifactId>
        <version>2.22.2</version>
    </dependency>
    <dependency>
        <groupId>commons-fileupload</groupId>
        <artifactId>commons-fileupload</artifactId>
        <version>1.3.1</version>
    </dependency>

    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>servlet-api</artifactId>
        <version>2.5</version>
        <scope>provided</scope>
    </dependency>

我正在使用 Wildfly 9.x 那么我应该怎么做才能让 Swagger-ui 与之前的服务很好地配合？

Answer 1

当前版本的 Swagger/OpenAPI 规范 (2.0) 没有很好地处理文件上传，即所谓的 body 参数。我们制定了一个可行的解决方案，在 https://github.com/OAI/OpenAPI-Specification/issues/50 中有所介绍 - 但是，该解决方案目前不受 swagger-core 的完全支持，并且在 swagger-ui 中根本不支持。