Didacticiel .NET - Votre premier microservice

Créer votre service

dotnet new webapi -o MyMicroservice --no-https

Ensuite, accédez au nouveau répertoire créé par la commande précédente :

cd MyMicroservice

Que signifient ces commandes ?

La commande dotnet crée une nouvelle application de type webapi (c'est un point de terminaison de l'API REST).

• Le paramètre -o crée un répertoire nommé MyMicroservice où votre application est stockée.
• L’indicateur --no-https crée une application qui s’exécutera sans certificat HTTPS afin de simplifier le déploiement.

La commande cd MyMicroservice vous place dans le répertoire de l'application nouvellement créée.

Le code généré

Plusieurs fichiers ont été créés dans le répertoire MyMicroservice, pour vous offrir un service simple prêt à s’exécuter, y compris les fichiers suivants :

• Program.cs est le fichier de point d’entrée et contient tous les paramètres et la configuration qui sont chargés au démarrage de l’application et qui contient le code d’une API simple qui retourne les prévisions météo pour les cinq prochains jours. Démarre également l’application.
• MyMycroservice.http est utilisé pour tester ASP.NET Core projets.
• MyMicroservice.csproj définit la version de .NET ciblée par l’application, les bibliothèques référencées par le projet, etc.
• Le fichier launchSettings.json dans le répertoire Properties définit différents paramètres de profil pour l'environnement de développement local. Un numéro de port compris entre 5000 et 5300 est automatiquement attribué à la création du projet et enregistré dans ce fichier.

Le code suivant affiche le contenu du fichier 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);
}

Sélectionnez le bouton Continuer ci-dessous pour passer à l’étape suivante.