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}.
Tantangan
MudahPembelajar dapat menyimpan resep favorit. Ketiga endpoint favorit menggunakan satu grup.
- Di
Program.cs, tambahkanvar favoriteIds = new List<int>();di bawahnextId. - Di atas
app.Run(), buat grupnya:var favorites = app.MapGroup("/api/favorites");. - Pada grup tersebut, petakan GET
"/": endpoint ini mengembalikan resep yangId-nya ada difavoriteIds, dengan urutan yang sama seperti direcipes. - Petakan POST
"/{id:int}": jika tidak ada resep dengan id tersebut, kembalikanResults.NotFound(new { error = $"Recipe {id} not found" }). Jika ada, tambahkan id tersebut kecualifavoriteIdssudah menyimpannya, lalu kembalikanResults.NoContent(). - Petakan DELETE
"/{id:int}": hapus id tersebut darifavoriteIds, lalu kembalikanResults.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();
Pelajaran ini berisi kuis singkat. Mulai pelajarannya untuk menjawab kuis dan melacak progresmu.