Menu
CoddyTech

Grupos de rutas

Parte de la sección API mínimas del Journey de ASP.NET Core de Coddy. Lección 11 de 20.

Los puntos de conexión de un mismo recurso comparten el comienzo de sus rutas. app.MapGroup(prefix) crea un grupo de rutas: cada punto de conexión asignado al grupo recibe el prefijo delante de su propio patrón.

var orders = app.MapGroup("/api/orders");
orders.MapGet("/", () => orderList);
orders.MapGet("/{id:int}", (int id) => orderList.FirstOrDefault(o => o.Id == id));
orders.MapDelete("/{id:int}", (int id) => orderList.RemoveAll(o => o.Id == id));

Las rutas son /api/orders/, /api/orders/{id:int} y la ruta DELETE con el mismo patrón. GET /api/orders coincide con /api/orders/, ya que una barra diagonal al final no cambia qué ruta coincide. El prefijo se escribe una sola vez, así que cambiarle el nombre modifica una sola línea, y un grupo puede aplicar configuraciones a todos sus puntos de conexión, como exigir que se inicie sesión. Escribir el prefijo de nuevo dentro del grupo lo duplica: /api/orders/api/orders/{id:int}.

challenge icon

Desafío

Fácil

Los estudiantes pueden guardar sus recetas favoritas. Los tres endpoints de favoritos comparten un grupo.

  1. En Program.cs, debajo de nextId, agrega var favoriteIds = new List<int>();.
  2. Encima de app.Run(), crea el grupo: var favorites = app.MapGroup("/api/favorites");.
  3. En el grupo, asigna GET a "/": devuelve las recetas cuyo Id está en favoriteIds, en el orden de recipes.
  4. Asigna POST a "/{id:int}": si ninguna receta tiene ese id, devuelve Results.NotFound(new { error = $"Recipe {id} not found" }). De lo contrario, agrega el id, a menos que favoriteIds ya lo contenga, y devuelve Results.NoContent().
  5. Asigna DELETE a "/{id:int}": elimina el id de favoriteIds y devuelve Results.NoContent().

Pruébalo: pulsa Ejecutar: GET /api/favorites responde []. Envía POST /api/favorites/2 con el cuerpo vacío: estado 204. Envía GET /api/favorites: una lista con la receta Pancakes. POST /api/favorites/99 responde 404 y DELETE /api/favorites/2 vuelve a vaciar la lista.

Pruébalo tú mismo

using Microsoft.AspNetCore.Http.HttpResults;

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

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;

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();
});

app.Run();
quiz iconPonte a prueba

Esta lección incluye un breve cuestionario. Empieza la lección para responderlo y registrar tu progreso.

Todas las lecciones de API mínimas