你知道 ASP.NET Core约定吗

使用约定修饰各操作

可以提取常见 API 文档并将其应用于程序集中的多个操作、控制器或所有控制器。 Web API 约定可替代使用 [ProducesResponseType] 来装饰单个操作。

使用此约定，可以：

定义通过特定操作类型返回的、最常见的返回类型和状态代码。
识别偏离所定义的标准的操作

优点

避免了为每个返回状态都添加ProducesResponseType的繁琐

Controller使用约定

注意ContactsConventionController的[ApiConventionType(typeof(DefaultApiConventions))]特性

    [ApiController]
    [ApiConventionType(typeof(DefaultApiConventions))]
    [Route("api/[controller]")]
    public class ContactsConventionController : ControllerBase

方法上约定

 #region snippet_ApiConventionMethod
        // PUT api/contactsconvention/{guid}
        [HttpPut("{id}")]
        [ApiConventionMethod(typeof(DefaultApiConventions), 
                             nameof(DefaultApiConventions.Put))]
        public IActionResult Update(string id, Contact contact)
        {
            var contactToUpdate = _contacts.Get(id);

            if (contactToUpdate == null)
            {
                return NotFound();
            }

            _contacts.Update(contact);

            return NoContent();
        }
        #endregion