Menu
CoddyTech

Ricerca

Fa parte della sezione API REST del percorso ASP.NET Core di Coddy. Lezione 11 di 20.

Una ricerca è un altro filtro nella stringa di query. In un'API di una biblioteca, GET /api/books?search=potter restituisce i libri il cui titolo contiene il testo. I filtri si accumulano: ognuno restringe i risultati lasciati dal filtro precedente.

if (!string.IsNullOrWhiteSpace(search))
    result = result.Where(b =>
        b.Title.Contains(search, StringComparison.OrdinalIgnoreCase));

Contains per impostazione predefinita confronta esattamente, quindi Potter non verrebbe trovato cercando potter. StringComparison.OrdinalIgnoreCase ignora le maiuscole. Salta il filtro se la ricerca è null o vuota: ?search= invia una stringa vuota e un client che svuota la casella di ricerca si aspetta di rivedere l'intero elenco.

challenge icon

Sfida

Facile

Consenti ai client di trovare le attività tramite una parola nel titolo.

  1. Aggiungi un secondo parametro alla lambda GET /api/tasks: string? search.
  2. Dopo il filtro done, quando search non è null né composto da spazi vuoti, mantieni le attività il cui titolo lo contiene, ignorando le maiuscole e le minuscole.
  3. Mantieni il filtro done: i due filtri funzionano insieme.

GET /api/tasks?search=ROOM restituisce l'attività 2, Book the meeting room. GET /api/tasks?search=the&done=false restituisce le attività 1 e 3: tutti i titoli contengono "the" e queste due sono aperte.

Prova: premi Esegui e invia GET /api/tasks?search=ROOM: attività 2. Invia GET /api/tasks?search=in: attività 2 e 3, per meeting e invoice. Invia GET /api/tasks?search=: tutte e tre.

Provalo tu

using System.ComponentModel.DataAnnotations;

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

app.UseExceptionHandler();
app.UseStatusCodePages();

var tasks = new List<TaskItem>
{
    new(1, "Write the project brief", false),
    new(2, "Book the meeting room", true),
    new(3, "Send the invoice", false),
};
var nextId = 4;

bool TitleTaken(string title, int exceptId) =>
    tasks.Any(t => t.Id != exceptId && string.Equals(t.Title, title, StringComparison.OrdinalIgnoreCase));

app.MapGet("/api/tasks", (bool? done) =>
{
    IEnumerable<TaskItem> result = tasks;
    if (done is not null) result = result.Where(t => t.Done == done);
    return Results.Ok(result);
});

app.MapGet("/api/tasks/{id:int}", (int id) =>
{
    var task = tasks.Find(t => t.Id == id);
    return task is null ? Results.NotFound() : Results.Ok(task);
});

app.MapPost("/api/tasks", (TaskInput input) =>
{
    var errors = Validation.Errors(input);
    if (errors is not null) return Results.ValidationProblem(errors);
    if (TitleTaken(input.Title, 0))
        return Results.Problem(title: "A task with this title already exists.", statusCode: 409);
    var task = new TaskItem(nextId++, input.Title, input.Done);
    tasks.Add(task);
    return Results.Created($"/api/tasks/{task.Id}", task);
});

app.MapPut("/api/tasks/{id:int}", (int id, TaskInput input) =>
{
    var errors = Validation.Errors(input);
    if (errors is not null) return Results.ValidationProblem(errors);
    var index = tasks.FindIndex(t => t.Id == id);
    if (index == -1) return Results.NotFound();
    if (TitleTaken(input.Title, id))
        return Results.Problem(title: "A task with this title already exists.", statusCode: 409);
    tasks[index] = new TaskItem(id, input.Title, input.Done);
    return Results.Ok(tasks[index]);
});

app.MapPatch("/api/tasks/{id:int}", (int id, TaskPatch patch) =>
{
    var index = tasks.FindIndex(t => t.Id == id);
    if (index == -1) return Results.NotFound();
    if (patch.Title is not null && TitleTaken(patch.Title, id))
        return Results.Problem(title: "A task with this title already exists.", statusCode: 409);
    var task = tasks[index];
    tasks[index] = task with
    {
        Title = patch.Title ?? task.Title,
        Done = patch.Done ?? task.Done,
    };
    return Results.Ok(tasks[index]);
});

app.MapDelete("/api/tasks/{id:int}", (int id) =>
{
    var removed = tasks.RemoveAll(t => t.Id == id);
    return removed == 0 ? Results.NotFound() : Results.NoContent();
});

app.Run();

record TaskItem(int Id, string Title, bool Done);
record TaskInput(
    [property: Required(ErrorMessage = "Title is required."), StringLength(80)] string Title,
    bool Done);
record TaskPatch(string? Title, bool? Done);

Tutte le lezioni di API REST