חיפוש מתכונים
חלק מהיחידה Minimal APIs במסלול ה-ASP.NET Core של Coddy. שיעור 18 מתוך 20.
בפרק הזה נוסיף שלוש תכונות ל־API של המתכונים, וכל אחת מהן מבוססת על מה שלמדת ביחידה. ראשית, חיפוש. string.Contains מאתר טקסט בתוך טקסט, והוא תלוי באותיות גדולות וקטנות: "Pancakes".Contains("pan") מחזיר false. StringComparison.OrdinalIgnoreCase מתעלם מההבחנה בין אותיות גדולות לקטנות:
var hits = books.Where(b => b.Title.Contains(term, StringComparison.OrdinalIgnoreCase));/api/recipes/search ו־/api/recipes/{id:int} אינם מתנגשים: search אינו מספר, ובכל מקרה, טקסט קבוע בנתיב מקבל עדיפות על פרמטר.
אתגר
קללקוחות יכולים לחפש מתכונים לפי שם: GET /api/recipes/search?q=soup. שמור את כל מה שכתבת בשיעורים הקודמים.
- ב-
Program.cs, הגדר מיפוי עבורGET /api/recipes/search. ה-lambda שלו מקבלstring? q. - כאשר
string.IsNullOrWhiteSpace(q), החזרResults.BadRequest(new { error = "Add ?q= to search" }). - אחרת החזר
Results.Ok(...)עם המתכונים שבהםNameמכיל אתq, ללא תלות באותיות גדולות וקטנות, ובסדר שלrecipes.
נסה זאת: לחץ על הרצה. GET /api/recipes/search?q=soup מחזיר את Tomato Soup ואת Lentil Soup. שלח ?q=PAN: Pancakes. שלח ?q=pizza: []. שלח GET /api/recipes/search ללא שאילתה: סטטוס 400 ו-{"error":"Add ?q= to search"}.
נסו בעצמכם
using Microsoft.AspNetCore.Http.HttpResults;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.Use(async (context, next) =>
{
await next();
app.Logger.LogInformation("{Method} {Path} -> {Status}",
context.Request.Method, context.Request.Path, context.Response.StatusCode);
});
app.Use(async (context, next) =>
{
context.Response.Headers["X-Api-Version"] = "1";
await next();
});
app.Use(async (context, next) =>
{
if (context.Request.Path.StartsWithSegments("/recipes"))
{
context.Response.Redirect("/api" + context.Request.Path + context.Request.QueryString, permanent: true);
return;
}
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, ILogger<Program> logger) =>
{
var recipe = recipes.FirstOrDefault(r => r.Id == id);
if (recipe is null)
{
logger.LogWarning("Recipe {Id} was not found", id);
return Results.NotFound(new { error = $"Recipe {id} not found" });
}
return Results.Ok(recipe);
});
app.MapPost("/api/recipes", (NewRecipe input, ILogger<Program> logger) =>
{
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);
logger.LogInformation("Added recipe {Id}: {Name}", recipe.Id, recipe.Name);
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();