Wie NSwag zu zwingen, benutzerdefinierte Antwortcodes von XML-Kommentare automatisch generierten Prahlerei json einer Web-API-Aufruf

Question

Dies ist die Definition hinzugefügt in clean1.csproj Datei basierend auf NSwag's documentation

<Target Name="AfterBuild"> 
<Exec Command="$(NSwagExe) webapi2swagger /assembly:$(OutDir)/Clean1.dll /referencepath: $(ProjectDir) /output:$(ProjectDir)/clean1swagger.json" /> 

enthalten

Das Problem ist, dass nur 200 Antwortcode wie erzeugt wird:

 ], 
    "responses": { 
     "200": { 
     "description": "", 
     "schema": { 
      "$ref": "#/definitions/Product" 
     }, 
     "x-nullable": true 
     } 
    } 

Hier sind die XML-Kommentare in dem Demo-Aufruf des Controllers.

/// <summary> 
    /// Gets a product by Id 
    /// </summary> 
    /// <remarks> 
    /// Remarks-description text. 
    /// </remarks> 
    /// <response code="200">test 200</response> 
    /// <response code="201">test 201/response> 
    /// <response code="400">test 400</response></response> 
    [HttpGet] 
    [ResponseType(typeof(Product))] 
    public IHttpActionResult GetProduct(int id) 
    { 
     var product = products.FirstOrDefault((p) => p.Id == id); 
     if (product == null) 
     { 
      return NotFound(); 
     } 
     return Ok(product); 
    } 

Der JSON sollte die anderen Antworten enthalten und automatisch generieren.

Answer 1

Dies ist derzeit nicht möglich. Wir haben überlegt, diese Funktion hinzuzufügen, aber in den meisten Fällen müssen Sie den Typ angeben, und dies kann nicht über XML-Kommentare erfolgen. Fürs Erste müssen Sie das SwaggerResponseAttribute dafür verwenden. Aber bitte erstellen Sie ein Problem auf Github, so dass das Feature als in der Zukunft hinzugefügt wird ...