SwashBuckle定义Error Body on Error

问题描述 投票:3回答:2

我的应用程序是ASP.NET Core 1.0 Web API。

我有以下控制器:

    [HttpGet("{someData:MinLength(5):MaxLength(5)}")]
    [Produces("application/json")]
    public async Task<IActionResult> GetSomeData(string someData)
    {
        return this.Ok(JsonConvert.SerializeObject("Data is: " + someData));
    }

每当我传递字符串“111”时,swagger会向我显示以下消息:

enter image description here

我如何实现响应体如:

“请输入5个数字”

谢谢

c# asp.net-core swagger swashbuckle
2个回答
5
投票

您可以使用[ProducesResponseType(typeof(ModelStateDictionary), (int)HttpStatusCode.OK)]注释您的操作,以返回典型的Dictionary类型错误消息,例如使用return BadRequest(ModelState)时。

但是您无法在架构定义中返回文本。它适用于json结构,而不适用于错误消息。相反,你应该使用xmldoc(并在swagger中启用它)来为参数添加描述。

Update: Alternative of adding documentation of the parameters and their meaning

/// <summary>
/// Returns some data based on <paramref name="someData"/> parameter.
/// </summary>
/// <param name="someData">Some data. (Must be exactly 5 characters wide)</param>
/// <response code="200">Returns indexed tags on success</response>
/// <response code="400">Invalid data sent</response>
/// <returns>A paged list of results</returns>
[HttpGet("{someData:MinLength(5):MaxLength(5)}")]
[ProducesResponseType(typeof(MyReturnType), (int)HttpStatusCode.OK)]
[ProducesResponseType(typeof(void), (int)HttpStatusCode.BadRequest)]
public async Task<IActionResult> GetSomeData(string someData)
{
}

您还需要在项目的属性中启用xmldocs的构建。

并添加到您的启动:

services.AddSwaggerGen(options =>
{
    ...
    var appEnv = PlatformServices.Default.Application;

    options.IncludeXmlComments(Path.Combine(appEnv.ApplicationBasePath, $"{appEnv.ApplicationName}.xml"));
    ...
});

1
投票

我正在使用ApiBadRequestResponse类,它从modelState而不是直接ModelState构造字符串列表。该类从一篇很好的文章https://www.devtrends.co.uk/blog/handling-errors-in-asp.net-core-web-api复制而来。

使用示例:

 [ProducesResponseType(typeof(ApiBadRequestResponse), (int)HttpStatusCode.BadRequest)]
 public async Task<IActionResult> GetSomeData(string someData)
 {
   return BadRequest(new ApiBadRequestResponse(ModelState));
 }

实现(基类描述in the article):

/// <summary>
    ///  an ApiBadRequestResponse class to handle validation errors from modelState or exception.
    /// </summary>
    public class ApiBadRequestResponse : ApiResponse
    {
        public IEnumerable<string> Errors { get; }

        public ApiBadRequestResponse(ModelStateDictionary modelState)
            : base(HttpStatusCode.BadRequest) //400)
        {
            if (modelState.IsValid)
            {
                throw new ArgumentException("ModelState must be invalid", nameof(modelState));
            }

            Errors = modelState.SelectMany(x => x.Value.Errors)
                .Select(x => x.ErrorMessage).ToArray();
        }

        public ApiBadRequestResponse(Exception exception, string message=null)
            : base(HttpStatusCode.BadRequest, message) //400)
        {
            Errors = new List<string>() {exception.ToString()};
        }
    }

另一个类似的解决方案是文章http://www.khalidabuhakmeh.com/a-better-validation-result-for-asp-net-webapi

© www.soinside.com 2019 - 2024. All rights reserved.