Tutorial do .NET – seu primeiro microsserviço

Criar seu serviço

dotnet new webapi -o MyMicroservice --no-https -f net7.0

Em seguida, navegue até o novo diretório criado pelo comando anterior:

cd MyMicroservice

O que esses comandos significam?

O comando dotnet cria um novo aplicativo do tipo webapi (que é um ponto de extremidade da API REST).

• O parâmetro -o cria um diretório chamado MyMicroservice em que seu aplicativo é armazenado.
• O sinalizador --no-https cria um aplicativo que será executado sem um certificado HTTPS, para manter as coisas simples para implantação.
• O parâmetro -f indica que você está criando um aplicativo .NET 7.

O comando cd MyMicroservice o coloca no diretório de aplicativos recém-criado.

O código gerado

Vários arquivos foram criados no diretório MyMicroservice para oferecer a você um serviço simples pronto para execução.

• MyMicroservice.csproj define quais bibliotecas o projeto faz referência etc.
• Program.cs contém todas as configurações carregadas quando o aplicativo é iniciado.
• Controllers/WeatherForecastController.cs tem código para uma API simples que retorna a previsão do tempo para os próximos cinco dias.
• O arquivo launchSettings.json dentro do diretório Properties define diferentes configurações de perfil para o ambiente de desenvolvimento local. Um número de porta variando entre 5000 e 5300 é atribuído automaticamente na criação do projeto e salvo neste arquivo.

O código a seguir mostra o conteúdo do arquivo WeatherForecastController.cs localizado no diretório Controllers:

using Microsoft.AspNetCore.Mvc;

namespace MyMicroservice.Controllers;

[ApiController]
[Route("[controller]")]
public class WeatherForecastController : ControllerBase
{
    private static readonly string[] Summaries = new[]
    {
        "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
    };

    private readonly ILogger<WeatherForecastController> _logger;

    public WeatherForecastController(ILogger<WeatherForecastController> logger)
    {
        _logger = logger;
    }

    [HttpGet(Name = "GetWeatherForecast")]
    public IEnumerable<WeatherForecast> Get()
    {
        return Enumerable.Range(1, 5).Select(index => new WeatherForecast
        {
            Date = DateTime.Now.AddDays(index),
            TemperatureC = Random.Shared.Next(-20, 55),
            Summary = Summaries[Random.Shared.Next(Summaries.Length)]
        })
        .ToArray();
    }
}

Selecione o botão Continuar abaixo para ir para a próxima etapa.