Документация Swagger для универсального базового контроллера APIC#

Место общения программистов C#
Ответить Пред. темаСлед. тема
Anonymous
 Документация Swagger для универсального базового контроллера API

Сообщение Anonymous »

Я разрабатывал веб-API ASP.NET Core 8 с использованием пользовательского интерфейса Swagger для автоматического документирования ресурсов, извлеченных из моей спецификации OpenAPI, однако столкнулся с проблемой при использовании универсальных шаблонов.
В API у меня есть несколько ресурсов, которые наследуются от базового контроллера, которые сами по себе нормально документированы, однако кажется, что Swagger не может генерировать документацию для базового контроллера из-за использования дженериков.
Вот пример моего базового контроллера, которого нет в документации Swagger:

Код: Выделить всё

[ApiController]
[Route("[controller]")]
public class PersonController : ControllerBase
where TEntity : class, new()
{
#region Fields
private readonly ILogger _logger;
private readonly IPersonService _personService;
#endregion

#region Ctor
public PersonController(ILogger logger,
IPersonService personService)
{
_logger = logger;
_personService = personService;
}
#endregion

#region Methods
[HttpGet("GetById/{id:int}")]
public async Task GetById(int id)
{
TEntity person = await _personService.GetByIdAsync(id);

return Ok(person);
}
#endregion
}
Изображение
Есть есть ли возможность документировать контроллер в Swagger при использовании дженериков?

Подробнее здесь: https://stackoverflow.com/questions/785 ... controller
Реклама
Ответить Пред. темаСлед. тема

Быстрый ответ

Изменение регистра текста: 
Смайлики
:) :( :oops: :roll: :wink: :muza: :clever: :sorry: :angel: :read: *x)
Ещё смайлики…
   
К этому ответу прикреплено по крайней мере одно вложение.

Если вы не хотите добавлять вложения, оставьте поля пустыми.

Максимально разрешённый размер вложения: 15 МБ.

  • Похожие темы
    Ответы
    Просмотры
    Последнее сообщение
  • Документация Swagger для универсального базового контроллера API
    Anonymous » » в форуме C#
    0 Ответы
    28 Просмотры
    Последнее сообщение Anonymous
  • Документация Swagger API в Spring API Gateway
    Anonymous » » в форуме JAVA
    0 Ответы
    28 Просмотры
    Последнее сообщение Anonymous
  • Документация API Swagger в Spring API Gateway
    Anonymous » » в форуме JAVA
    0 Ответы
    20 Просмотры
    Последнее сообщение Anonymous
  • Документация API Swagger в Spring API Gateway
    Anonymous » » в форуме JAVA
    0 Ответы
    3 Просмотры
    Последнее сообщение Anonymous
  • Модель запросов и ответов не загружается в пользовательском интерфейсе Swagger при переходе с Swagger 1.2 на Swagger 2.0
    Anonymous » » в форуме JAVA
    0 Ответы
    56 Просмотры
    Последнее сообщение Anonymous

Вернуться в «C#»