День 2657. #ВопросыНаСобеседовании
Марк Прайс предложил свой набор из 60 вопросов (как технических, так и на софт-скилы), которые могут задать на собеседовании.

33. Разработка веб-API
«Расскажите, как бы вы спроектировали и реализовали веб-API, используя возможности минимальных API? Опишите шаги, необходимые для создания минимального API, и как это упрощает разработку API по сравнению с более ранними версиями Web API».

Хороший ответ
Минимальные API обеспечивают упрощённый подход к созданию высокопроизводительных, легковесных HTTP API. Вот как я бы спроектировал и реализовал минимальный API.

1. Создать новый проект Web API можно с помощью команды: dotnet new webapi

2. В Program.cs создадим нужные конечные точки. Минимальные API используют лямбда-выражения для обработки запросов непосредственно в коде, что упрощает маршрутизацию и настройку контроллера:

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/products", async (AppDbContext db) => 
  await db.Products.ToListAsync());

app.MapGet("/products/{id}", 
 async (int id, AppDbContext db) => 
  await db.Products.FindAsync(id) is Product product ? 
    Results.Ok(product) : Results.NotFound());

app.MapPost("/products", 
 async (Product product, AppDbContext db) => 
{
  db.Products.Add(product);
  await db.SaveChangesAsync();
  return Results.Created($"/products/{product.Id}", product);
});

//…

app.MapDelete("/products/{id}", 
  async (int id, AppDbContext db) => 
{
  if (await db.Products.FindAsync(id) is Product product)
  {
    db.Products.Remove(product);
    await db.SaveChangesAsync();
    return Results.Ok(product);
  }
  return Results.NotFound();
});

app.Run();

3. Настроим необходимые сервисы, такие как контекст БД, в настройках конструктора:

builder.Services.AddDbContext<AppDbContext>(opts =>
  opts.UseSqlServer(builder.Configuration
   .GetConnectionString("DefaultConnection")));

4. Тестировать API можно с помощью Postman или Swagger. .NET поддерживает Swagger по умолчанию:

builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

Преимущества минимальных API
- Уменьшение шаблонного кода: устраняет необходимость в отдельных контроллерах, делая кодовую базу проще и меньше.
- Простота использования: упрощает настройку маршрутизации, облегчая создание и управление API.
- Производительность: предлагает легковесную альтернативу традиционным MVC-архитектурам, потенциально повышая производительность. Проекты минимальных API могут быть скомпилированы с использованием нативного AOT для ещё большей производительности.
Этот подход использует новейшие возможности .NET для эффективного создания API, фокусируясь на простоте и производительности.

Часто встречающийся плохой ответ
«Минимальные API подходят только для тестов и самых простых проектов и не предлагают ничего такого, чего не могли бы сделать контроллеры. Лучше придерживаться стандартного шаблона MVC».

Почему это неверно
- Сопротивление новым функциям: этот ответ демонстрирует сопротивление внедрению новых фреймворков и улучшений в технологиях. Минимальные API были введены для упрощения и ускорения разработки простых API, и они специально разработаны для улучшения опыта разработчиков и производительности в подходящих сценариях.

- Непонимание сценария использования: в ответе не учитывается, что минимальные API идеально подходят для приложений, которые не требуют полной структуры MVC, особенно для микросервисов или простых CRUD-операций.

- Отсутствие гибкости: ответ указывает на отсутствие гибкости в применении новых методов, которые могут обеспечить повышение эффективности в конкретных сценариях использования.

Этот ответ часто проистекает из недостаточного понимания конкретных преимуществ новых функций или из комфорта с устоявшимися шаблонами, которые не всегда могут быть наиболее эффективным выбором в каждом сценарии.

Источник: https://github.com/markjprice/tools-skills-net8/blob/main/docs/interview-qa/readme.md