Укажите пользовательский заголовок конечной точки в NSwag через атрибуты - PullRequest
Новая
       71

Укажите пользовательский заголовок конечной точки в NSwag через атрибуты

0 голосов
/ 31 августа 2018

Похоже на этот вопрос но немного по другому, я просто хотел посмотреть, есть ли уже простой способ генерирования заголовка конечной точки с помощью, например, атрибута самого метода?

Например, вместо значений по умолчанию Users_Get и Users_Post , созданных для конечных точек HttpGet и HttpPost в контроллере Users, я бы хотел иметь возможность заголовка их «Получить конкретного пользователя» и «Создать нового пользователя».

Поскольку мы уже можем использовать атрибут [Description()] для моделирования описания, я надеялся использовать другой атрибут для заголовка. Я думал, что это может выглядеть примерно так: 

[ApiController]
public class UsersController : ControllerBase
{
    [HttpPost]
    [Display(Name = "Create a new user")]
    public void Post([FromBody] string value)
    {
        ...
    }
}

Я знаю, что мог бы реализовать пользовательский IOperationNameGenerator, но это выглядело как случай общего использования, поэтому я хотел исключить, что упустил что-то, что уже было возможно. Спасибо!

РЕДАКТИРОВАТЬ:

Чтобы уточнить, я имею в виду, что желаемый заголовок станет свойством summary в спецификации Swagger JSON, а бонусные баллы за то, что значение DescriptionAttribute станет свойством description в спецификации. Похоже, что DescriptionAttribute сейчас подается в свойство summary.

...