Menu
CoddyTech

Uma Página HTML Estática

Parte da seção APIs mínimas do Journey de ASP.NET Core da Coddy. Lição 12 de 20.

Um aplicativo web geralmente envia arquivos que nunca mudam: páginas HTML, CSS e imagens. O ASP.NET Core os disponibiliza a partir da pasta wwwroot do projeto depois que o middleware de arquivos estáticos é adicionado. O middleware é um código pelo qual toda requisição passa a caminho dos endpoints; no próximo capítulo, você escreverá um.

var app = builder.Build();
app.UseStaticFiles();

Com wwwroot/about.html e wwwroot/css/site.css no projeto, GET /about.html e GET /css/site.css retornam esses arquivos, com um Content-Type correspondente à extensão: text/html, text/css. O endereço é o caminho dentro de wwwroot, sem o próprio wwwroot. Uma requisição por um arquivo que não existe segue para os endpoints, então GET / ainda chega a MapGet("/").

challenge icon

Desafio

Fácil

A API recebe uma página inicial. wwwroot/index.html é novo no seu projeto.

  1. Em Program.cs, na linha depois de var app = builder.Build();, adicione app.UseStaticFiles();.
  2. Em wwwroot/index.html, abaixo do primeiro parágrafo, adicione <p><a href="/api/recipes">All recipes</a></p>.

Experimente: pressione Executar. A primeira requisição é GET /index.html: status 200, Content-Type: text/html, e a página aparece com o título Recipe Box. A aba Source mostra o HTML. Clique em All recipes para enviar GET /api/recipes. Envie GET /: continua sendo Recipe API is running.

Experimente você mesmo

using Microsoft.AspNetCore.Http.HttpResults;

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

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) =>
{
    var recipe = recipes.FirstOrDefault(r => r.Id == id);
    if (recipe is null)
        return Results.NotFound(new { error = $"Recipe {id} not found" });
    return Results.Ok(recipe);
});

app.MapPost("/api/recipes", (NewRecipe input) =>
{
    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);
    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();

Todas as lições de APIs mínimas