Tìm kiếm
Thuộc phần REST API trong hành trình ASP.NET Core của Coddy. Bài học 11 trên 20.
Tìm kiếm là một bộ lọc khác trong chuỗi truy vấn. Trong API thư viện, GET /api/books?search=potter trả về những cuốn sách có tiêu đề chứa văn bản này. Các bộ lọc được áp dụng nối tiếp: mỗi bộ lọc thu hẹp kết quả mà bộ lọc trước đó để lại.
if (!string.IsNullOrWhiteSpace(search))
result = result.Where(b =>
b.Title.Contains(search, StringComparison.OrdinalIgnoreCase));Contains mặc định so sánh chính xác, nên Potter sẽ không khớp với tìm kiếm potter. StringComparison.OrdinalIgnoreCase bỏ qua chữ hoa. Bỏ qua bộ lọc khi giá trị tìm kiếm là null hoặc rỗng: ?search= gửi một chuỗi rỗng, và khi người dùng xóa nội dung trong ô tìm kiếm, họ mong danh sách đầy đủ sẽ hiện lại.
Thử thách
DễCho phép client tìm tác vụ bằng một từ trong tiêu đề.
- Thêm tham số thứ hai,
string? search, cho lambdaGET /api/tasks. - Sau bộ lọc
done, khisearchkhông phải null hoặc khoảng trắng, chỉ giữ lại các tác vụ có tiêu đề chứa từ đó, không phân biệt chữ hoa chữ thường. - Giữ bộ lọc
done: hai bộ lọc hoạt động cùng nhau.
GET /api/tasks?search=ROOM trả về tác vụ 2, Book the meeting room. GET /api/tasks?search=the&done=false trả về các tác vụ 1 và 3: mọi tiêu đề đều có từ "the", và hai tác vụ đó đang mở.
Thử nhé: nhấn Run rồi gửi GET /api/tasks?search=ROOM: tác vụ 2. Gửi GET /api/tasks?search=in: các tác vụ 2 và 3, ứng với meeting và invoice. Gửi GET /api/tasks?search=: cả ba tác vụ.
Tự làm thử
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);
Tất cả bài học trong REST API
1Tài nguyên và động từ
Tài nguyên và URLTạo mới bằng POST4Dự án: Mức độ ưu tiên
Mức độ ưu tiên của tác vụ