Tutorial de .NET | Su primer microservicio

Cree su servicio

dotnet new webapi -o MyMicroservice --no-https

Después, vaya al nuevo directorio creado por el comando anterior:

cd MyMicroservice

¿Qué significan estos comandos?

El comando dotnet crea una aplicación nueva de tipo webapi (es decir, un punto de conexión de API de REST).

• El parámetro -o crea un directorio denominado MyMicroservice donde se almacena la aplicación.
• La marca --no-https crea una aplicación que se ejecutará sin un certificado HTTPS para simplificar la implementación.

El comandocd MyMicroservice le coloca en el directorio de aplicaciones recién creado.

El código generado

Se crearon varios archivos en el directorio MyMicroservice, para brindarle un servicio simple que está listo para ejecutarse, incluyendo los siguientes archivos:

• Program.cs es el archivo de punto de entrada y contiene todos los valores y configuraciones que se cargan cuando se inicia la aplicación y tiene código para una API simple que devuelve la previsión meteorológica para los próximos cinco días. También inicia la aplicación.
• MyMycroservice.http se usa para probar proyectos de ASP.NET Core.
• MyMicroservice.csproj define la versión de .NET de destino de la aplicación, qué bibliotecas hace referencia al proyecto, etc.
• MyMicroservice.sln define el archivo de solución que organiza los proyectos en Visual Studio.
• El archivo launchSettings.json dentro del directorio Properties define diferentes configuraciones de perfil para el entorno de desarrollo local. Un número de puerto que oscila entre 5 000 y 5 300 se asigna automáticamente al crear el proyecto y se guarda en este archivo.

El siguiente código muestra el contenido del archivo de Program.cs:

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

var summaries = new[]
{
    "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
};

app.MapGet("/weatherforecast", () =>
{
    var forecast =  Enumerable.Range(1, 5).Select(index =>
        new WeatherForecast
        (
            DateOnly.FromDateTime(DateTime.Now.AddDays(index)),
            Random.Shared.Next(-20, 55),
            summaries[Random.Shared.Next(summaries.Length)]
        ))
        .ToArray();
    return forecast;
})
.WithName("GetWeatherForecast")
.WithOpenApi();

app.Run();

record WeatherForecast(DateOnly Date, int TemperatureC, string? Summary)
{
    public int TemperatureF => 32 + (int)(TemperatureC / 0.5556);
}

Seleccione el botón Continuar para ir al siguiente paso.