Menu
CoddyTech

Búsqueda

Parte de la sección API REST del Journey de ASP.NET Core de Coddy. Lección 11 de 20.

Una búsqueda es otro filtro en la cadena de consulta. En la API de una biblioteca, GET /api/books?search=potter devuelve los libros cuyo título contiene el texto. Los filtros se acumulan: cada uno reduce los resultados que dejó el anterior.

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

Contains compara exactamente de forma predeterminada, por lo que Potter no encontraría resultados al buscar potter. StringComparison.OrdinalIgnoreCase ignora las mayúsculas. Omite el filtro cuando la búsqueda es null o está vacía: ?search= envía una cadena vacía, y un cliente que borra su cuadro de búsqueda espera que se devuelva la lista completa.

challenge icon

Desafío

Fácil

Permite que los clientes encuentren tareas por una palabra de su título.

  1. Agrega un segundo parámetro a la lambda GET /api/tasks: string? search.
  2. Después del filtro done, cuando search no sea null ni un espacio en blanco, conserva las tareas cuyo título lo contenga, sin distinguir entre mayúsculas y minúsculas.
  3. Conserva el filtro done: ambos funcionan juntos.

GET /api/tasks?search=ROOM devuelve la tarea 2, Book the meeting room. GET /api/tasks?search=the&done=false devuelve las tareas 1 y 3: todos los títulos contienen "the", y esas dos están abiertas.

Pruébalo: pulsa Ejecutar y envía GET /api/tasks?search=ROOM: la tarea 2. Envía GET /api/tasks?search=in: las tareas 2 y 3, por «meeting» e «invoice». Envía GET /api/tasks?search=: las tres.

Pruébalo tú mismo

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

Todas las lecciones de API REST