servicestack - 使用 ServiceStack 显示额外参数的 Swagger UI

Question

我在使用 ServiceStack 大摇大摆地显示正确注释时遇到问题。

鉴于这种结构：

    [Route("/Widget/{WidgetId}", Summary = "Updates a widget by id", Verbs = "POST",
    Notes = "Updates a widget by id.")]
    public class UpdateReqWidget : IReturnVoid
    {
        [ApiMember(Name = "WidgetId", Description = "The id of widget to delete.")]
        public int WidgetId { get; set; }
    }

    public class WidgetService 
    {
        public void Put(UpdateReqWidget req)
        {
             //do code here
        }
    }

它正在生产：

我希望参数列表只有 WidgetId，但它显示 WidgetId 和 UpdageReqWidget，即请求的类名。任何想法我做错了什么？

编辑：我为 ServiceStack 和 ServiceStack.API.Swagger 使用 3.9.55 版本。我已经更改了模板以更好地满足我们的需求。

Answer 1

ServiceStack.Api.Swagger 最近添加了一个在 Swagger UI 中自动生成请求正文参数的功能。我认为有一个边缘情况，其中请求 DTO 没有未指定为路径或查询参数的属性，就像您在此处的情况一样，代码仍将生成该UpdateReqWidget请求正文参数，但它将是 Swagger 中的空对象.