Swagger Swashback应使用我的控制器操作名称作为默认摘要

Swagger Swashback应使用我的控制器操作名称作为默认摘要,swagger,.net-5,swashbuckle,swashbuckle.aspnetcore,Swagger,.net 5,Swashbuckle,Swashbuckle.aspnetcore,我正在使用Swashback在.NET 5项目中生成API定义。 为了在我的文档中添加摘要和备注,我目前正在对我的一些行动进行评论,如: /// <summary> /// CreateSite /// </summary> /// <remarks> /// Options: /// * Enterprise = 0, /// * Site = 1 /// * Order = 2 ///

我正在使用Swashback在.NET 5项目中生成API定义。
为了在我的文档中添加摘要和备注,我目前正在对我的一些行动进行评论,如:

    /// <summary>
    /// CreateSite
    /// </summary>
    /// <remarks>
    /// Options:
    /// * Enterprise = 0,
    /// * Site = 1
    /// * Order = 2
    /// * Line = 3
    /// * Product = 4
    /// 
    /// </remarks>
    [HttpPost]
    [Route("sites")]
    public async Task<IActionResult> CreateSiteAsync([FromBody] SiteCreateRequest createRequest)
    { // My controller stuff }
//
///创建站点
/// 
/// 
///选项:
///*企业=0,
///*站点=1
///*订单=2
///*直线=3
///*产品=4
/// 
/// 
[HttpPost]
[路线(“现场”)]
公共异步任务CreateSiteAsync([FromBody]SiteCreateRequest createRequest)
{//My controller stuff}
这将生成一个很好的文档,非常有用。
然而,我的“summary”字段的值始终与我的控制器操作名称相同-我已经对操作进行了很好的命名:
您可以在上面看到,摘要包含“CreateSite”并且我的控制器名称是“CreateSiteAsync”。
有没有办法将其自动化?
因此,我可以在服务中设置一些选项,将控制器名称用作json文件中使用的“默认”摘要选项吗


然后我就可以在所有简单的请求中避免这些繁琐的注释,而不需要任何文档。

我还使用了Swashback,为了正确地记录我的API,我使用了Swagger标记。附件是我实际使用的一个例子。对于您的特定控制器名称标签,在我的示例中,它将是
[SwaggerOperation(“在途装运”)]

//
///过境运输
/// 
/// 
///为客户获取运输中的货物
/// 
/// 
[招摇过市(“地面运输”)]
[招摇过市(“过境运输”)]
[SwaggerResponse(200,typeof(List),Description=“OK”)]
[SwaggerResponse(400,typeof(ErrorMessageDto),Description=“坏请求”)]
[SwaggerResponse(404,typeof(ErrorMessageDto),Description=“Not Found”)]
[SwaggerOperationProcessor(typeof(redocodesampleappender),“Curl,CSharp,Java”)]
[HttpGet(“发货信息/在途”)]
[TraceAction(消息:“控制器:为客户端检索在途装运”,级别:LogLevel.Information,externalErrorMessage:“未找到在途装运”)]
公共异步任务GetClientTransitShipments(uint?page=GroundTransportationConstants.DefaultPage,uint?pageSize=GroundTransportationConstants.DefaultPageSize)
{
//…一堆api代码:-)
}

好吧,在这种情况下,我必须为每个控制器添加一个额外的[SwaggerTag(“SameNameAlikeMyControllerAction”)]标记。。。它看起来比这条裙子好看
        /// <summary>
        /// In-transit shipments 
        /// </summary>
        /// <remarks>
        /// Get in-transit shipments for a client
        /// </remarks>
        /// <returns></returns>
        [SwaggerTag("GroundTransportation")]
        [SwaggerOperation("In-Transit Shipments")]
        [SwaggerResponse(200, typeof(List<LoadSummaryDto>), Description = "OK")]
        [SwaggerResponse(400, typeof(ErrorMessageDto), Description = "Bad Request")]
        [SwaggerResponse(404, typeof(ErrorMessageDto), Description = "Not Found")]
        [SwaggerOperationProcessor(typeof(ReDocCodeSampleAppender), "Curl,CSharp,Java")]
        [HttpGet("ShipmentInformation/In-Transit")]
        [TraceAction(message: "Controller: Retrieving in-transit shipments for client", level: LogLevel.Information, externalErrorMessage: "In-transit shipments could not be found")]
        public async Task<IActionResult> GetClientInTransitShipments(uint? page = GroundTransportationConstants.DefaultPage, uint? pageSize = GroundTransportationConstants.DefaultPageSize)
        {
           // ... a bunch of api code :-)
        }