Menu
CoddyTech

Una página HTML estática

Parte de la sección API mínimas del Journey de ASP.NET Core de Coddy. Lección 12 de 20.

Una aplicación web suele enviar archivos que nunca cambian: páginas HTML, CSS e imágenes. ASP.NET Core los sirve desde la carpeta wwwroot del proyecto una vez que se agrega el middleware de archivos estáticos. El middleware es código por el que pasa cada solicitud de camino a los endpoints; en el capítulo siguiente escribirás algo.

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

Si el proyecto contiene wwwroot/about.html y wwwroot/css/site.css, las solicitudes GET /about.html y GET /css/site.css devuelven esos archivos con un Content-Type que coincide con la extensión: text/html, text/css. La dirección es la ruta dentro de wwwroot, sin incluir wwwroot. Una solicitud de un archivo que no existe continúa hacia los endpoints, así que GET / sigue llegando a MapGet("/").

challenge icon

Desafío

Fácil

La API obtiene una página de inicio. wwwroot/index.html es nuevo en tu proyecto.

  1. En Program.cs, en la línea después de var app = builder.Build();, agrega app.UseStaticFiles();.
  2. En wwwroot/index.html, debajo del primer párrafo, agrega <p><a href="/api/recipes">All recipes</a></p>.

Pruébalo: pulsa Ejecutar. La primera solicitud es GET /index.html: estado 200, Content-Type: text/html, y la página se muestra con el encabezado Recipe Box. La pestaña Fuente muestra su HTML. Haz clic en All recipes para enviar GET /api/recipes. Envía GET /: sigue siendo Recipe API is running.

Pruébalo tú mismo

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 las lecciones de API mínimas