Menu
CoddyTech

Grup Rute

Termasuk bagian Minimal API dalam perjalanan ASP.NET Core di Coddy. Pelajaran 11 dari 20.

Titik akhir untuk satu resource berbagi awalan rutenya. app.MapGroup(prefix) membuat grup rute: setiap titik akhir yang dipetakan padanya mendapat awalan di depan polanya sendiri.

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

Rutenya adalah /api/orders/, /api/orders/{id:int}, dan DELETE pada pola yang sama. GET /api/orders cocok dengan /api/orders/, karena garis miring di akhir tidak mengubah rute yang cocok. Awalan ditulis sekali, jadi mengganti namanya hanya mengubah satu baris, dan grup dapat menerapkan pengaturan ke semua titik akhirnya, seperti mewajibkan login. Menulis awalan lagi di dalam grup akan menggandakannya: /api/orders/api/orders/{id:int}.

challenge icon

Tantangan

Mudah

Pembelajar dapat menyimpan resep favorit. Ketiga endpoint favorit menggunakan satu grup.

  1. Di Program.cs, tambahkan var favoriteIds = new List<int>(); di bawah nextId.
  2. Di atas app.Run(), buat grupnya: var favorites = app.MapGroup("/api/favorites");.
  3. Pada grup tersebut, petakan GET "/": endpoint ini mengembalikan resep yang Id-nya ada di favoriteIds, dengan urutan yang sama seperti di recipes.
  4. Petakan POST "/{id:int}": jika tidak ada resep dengan id tersebut, kembalikan Results.NotFound(new { error = $"Recipe {id} not found" }). Jika ada, tambahkan id tersebut kecuali favoriteIds sudah menyimpannya, lalu kembalikan Results.NoContent().
  5. Petakan DELETE "/{id:int}": hapus id tersebut dari favoriteIds, lalu kembalikan Results.NoContent().

Coba: tekan Jalankan: GET /api/favorites menghasilkan []. Kirim POST /api/favorites/2 dengan body kosong: status 204. Kirim GET /api/favorites: sebuah list berisi resep Pancakes. POST /api/favorites/99 menghasilkan 404, dan DELETE /api/favorites/2 mengosongkan list lagi.

Coba sendiri

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 iconUji dirimu

Pelajaran ini berisi kuis singkat. Mulai pelajarannya untuk menjawab kuis dan melacak progresmu.

Semua pelajaran di Minimal API