Menu
CoddyTech

Encerrando uma requisição antes do tempo

Parte da seção APIs mínimas do Journey de ASP.NET Core da Coddy. Lição 14 de 20.

Um middleware que não chama next() encerra a solicitação ali e responde por conta própria: o middleware abaixo dele, os arquivos estáticos e os endpoints nunca são executados.

app.Use(async (context, next) =>
{
    if (context.Request.Path.StartsWithSegments("/admin"))
    {
        context.Response.StatusCode = 403;
        await context.Response.WriteAsync("Forbidden");
        return;
    }
    await next();
});

StartsWithSegments("/admin") é verdadeiro para /admin e /admin/users, mas não para /administrator. Para enviar o cliente a outro endereço, context.Response.Redirect(url, permanent: true) responde com 301 Moved Permanently, incluindo o endereço no cabeçalho Location, e o navegador então faz uma solicitação para ele. Sem permanent: true, responde com 302 Found, um redirecionamento temporário.

challenge icon

Desafio

Fácil

A API costumava ficar em /recipes, sem /api. Links antigos levam aos novos endereços.

  1. Em Program.cs, abaixo do middleware X-Api-Version e acima de app.UseStaticFiles();, adicione outro middleware app.Use.
  2. Quando context.Request.Path.StartsWithSegments("/recipes"), chame context.Response.Redirect("/api" + context.Request.Path + context.Request.QueryString, permanent: true); e return sem chamar next().
  3. Caso contrário, await next();.

Experimente: pressione Executar. A primeira solicitação é GET /recipes/2: status 301, e a guia Headers mostra Location: /api/recipes/2 e X-Api-Version: 1. Envie GET /recipes?category=soup: Location: /api/recipes?category=soup. Envie GET /api/recipes/2: 200, sem redirecionamento.

Experimente você mesmo

using Microsoft.AspNetCore.Http.HttpResults;

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

app.Use(async (context, next) =>
{
    context.Response.Headers["X-Api-Version"] = "1";
    await next();
});

app.UseStaticFiles();

var recipes = new List<Recipe>
{
    new(1, "Tomato Soup", "soup", 25),
    new(2, "Pancakes", "breakfast", 15),
    new(3, "Lentil Soup", "soup", 40),
};
var nextId = 4;
var favoriteIds = new List<int>();

app.MapGet("/", () => "Recipe API is running");
app.MapGet("/api/recipes", (string? category) =>
    recipes.Where(r => category is null || r.Category == category));
app.MapGet("/api/recipes/{id:int}", (int id) =>
{
    var recipe = recipes.FirstOrDefault(r => r.Id == id);
    if (recipe is null)
        return Results.NotFound(new { error = $"Recipe {id} not found" });
    return Results.Ok(recipe);
});

app.MapPost("/api/recipes", (NewRecipe input) =>
{
    if (string.IsNullOrWhiteSpace(input.Name))
        return Results.BadRequest(new { error = "Name is required" });
    if (input.Minutes <= 0)
        return Results.BadRequest(new { error = "Minutes must be more than 0" });
    var recipe = new Recipe(nextId++, input.Name, input.Category, input.Minutes);
    recipes.Add(recipe);
    return Results.Created($"/api/recipes/{recipe.Id}", recipe);
});

app.MapPut("/api/recipes/{id:int}", (int id, NewRecipe input) =>
{
    var index = recipes.FindIndex(r => r.Id == id);
    if (index == -1)
        return Results.NotFound(new { error = $"Recipe {id} not found" });
    var recipe = new Recipe(id, input.Name, input.Category, input.Minutes);
    recipes[index] = recipe;
    return Results.Ok(recipe);
});

app.MapDelete("/api/recipes/{id:int}", Results<NoContent, NotFound> (int id) =>
{
    var removed = recipes.RemoveAll(r => r.Id == id);
    return removed > 0 ? TypedResults.NoContent() : TypedResults.NotFound();
});

var favorites = app.MapGroup("/api/favorites");
favorites.MapGet("/", () => recipes.Where(r => favoriteIds.Contains(r.Id)));
favorites.MapPost("/{id:int}", (int id) =>
{
    if (!recipes.Any(r => r.Id == id))
        return Results.NotFound(new { error = $"Recipe {id} not found" });
    if (!favoriteIds.Contains(id))
        favoriteIds.Add(id);
    return Results.NoContent();
});
favorites.MapDelete("/{id:int}", (int id) =>
{
    favoriteIds.Remove(id);
    return Results.NoContent();
});

app.Run();

Todas as lições de APIs mínimas