Swagger-ui bieten nicht, wie ich MediaType.APPLICATION_OCTET_STREAM Inhalt passieren

Question

Eigentlich ich ein Problem bin vor, dass Swagger-ui kann mir nicht zeigen Eingang für MediaType.APPLICATION_OCTET_STREAM, so lässt dies das nächste Service vorstellen:

@PUT

@Path ("/ performAudioQuery")

@Consumes (MediaType.APPLICATION_OCTET_STREAM)

öffentliche Reaktion performAudioQuery (Input audioInputStream) {// Impl des Dienstes }

und hier sind die Abhängigkeiten

<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> 

und ich bin mit Wildfly 9.x Was also sollte ich tun, damit Swagger-ui mit diesem vorherigen Service gut funktioniert?

Answer 1

Die aktuelle Version der Swagger/OpenAPI-Spezifikation (2.0) eignet sich nicht so gut für Datei-Uploads als so genannte Body-Parameter. Wir haben eine praktikable Lösung formuliert, die unter https://github.com/OAI/OpenAPI-Specification/issues/50 behandelt wird - allerdings wird diese Lösung derzeit nicht vollständig von swagger-core unterstützt und in swagger-ui überhaupt nicht unterstützt.