ASP.NET Core: Debugging de APIs REST no Visual Studio com HTTP REPL
Em um artigo anterior demonstrei o uso da Global Tool HTTP REPL, funcionalidade introduzida no .NET Core 2.2 e que permite o teste de APIs REST nas quais foi ativado o uso do Swagger:
.NET Core 2.2: testando APIs REST via linha de comando com HTTP REPL
Este novo post complementa o anterior, desta vez abordando a utilização do HTTP REPL no debugging de APIs criadas com o ASP.NET Core a partir do Visual Studio.
Para os testes detalhados neste artigo foram empregados o Visual Studio 2019 Preview 4.3 (este mesmo tipo de procedimento poderia ser realizado no Visual Studio 2017), uma API REST criada com o ASP.NET Core 2.2, além da versão 0.1.0-preview.19119.4 do HTTP REPL.
Para instalar esta versão do HTTP REPL foi executado o seguinte comando:
A instrução dotnet tool list -g deve exibir o HTTP REPL instalado, caso o processo de implantação tenha sucesso:
O projeto que serviu de base para os testes se encontra no seguinte repositório do GitHub:
https://github.com/renatogroffe/ASPNETCore2.2_APIIndicadores
Acionar o botão Debug (provavelmente estará indicado no mesmo IIS Express), selecionando em seguida a opção Browse With…:
Clicar então no botão Add:
Em Add Program preencher os campos Program (com o caminho do HTTP REPL, neste caso C:\Users\renat\.dotnet\tools\dotnet-httprepl.exe) e Friendly name (com um nome que identifique esta alternativa, HTTP REPL para esse exemplo):
Ao acionar o botão OK aparecerá agora como uma das alternativas HTTP REPL:
Em Web Browser no botão Debug selecionar HTTP REPL:
Alterar também as ocorrências do atributo launchUrl em launchSettings.json de forma que a aplicação ao iniciar seja carregada em / (diretório/rota raiz):
Finalmente será exibida uma janela/prompt de execução, com o HTTP REPL se conectando à API REST por meio do comando set base:
A seguir temos um exemplo de debugging da Action Get:
Com o resultado deste teste na próxima imagem:
E aproveito este post para deixar aqui um convite.
Dia 26/03/2019 (terça-feira) às 21:00 — horário de Brasília — teremos mais um evento online no Canal .NET. Desta vez serão 2 apresentações, abordando o uso avançado do NHibernate em aplicações .NET e a integração automatizada de dados empregando o Apache NIFI.
Para efetuar a sua inscrição acesse a página do evento no Meetup. A transmissão acontecerá via YouTube, em um link a ser divulgado em breve.
