Recipe Search
Part of the Minimal APIs section of Coddy's ASP.NET Core journey. Lesson 18 of 20.
This chapter adds three features to the recipe API, each built from what the section taught. First a search. string.Contains finds text inside text, and it is case-sensitive: "Pancakes".Contains("pan") is false. StringComparison.OrdinalIgnoreCase ignores case:
var hits = books.Where(b => b.Title.Contains(term, StringComparison.OrdinalIgnoreCase));/api/recipes/search and /api/recipes/{id:int} do not clash: search is not a number, and fixed text in a route wins over a parameter anyway.
Challenge
EasyClients can search recipes by name: GET /api/recipes/search?q=soup. Keep everything you wrote in the earlier lessons.
- In
Program.cs, mapGET /api/recipes/search. Its lambda takesstring? q. - When
string.IsNullOrWhiteSpace(q), returnResults.BadRequest(new { error = "Add ?q= to search" }). - Otherwise return
Results.Ok(...)with the recipes whoseNamecontainsq, ignoring case, in the order ofrecipes.
Try it: press Run. GET /api/recipes/search?q=soup answers Tomato Soup and Lentil Soup. Send ?q=PAN: Pancakes. Send ?q=pizza: []. Send GET /api/recipes/search with no query: status 400 and {"error":"Add ?q= to search"}.
Try it yourself
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();
All lessons in Minimal APIs
2Results and JSON Bodies
Ok and Not Found