Criando minimal API com Scaffolding no .NET 6 com Visual Studio 2022.

Criando minimal API com Scaffolding no .NET 6 com Visual Studio 2022

Para quem curte utilizar o conceito de Minimal api que já demonstrei em outros posts, aqui vou demonstrar, que além de podermos criar manualmente, podemos criar uma Minimal API utilizando o Scaffold !

Para começar, durante a etapa de criação do projeto novo no Visual Studio 2022, você deve escolher a utilização de “Minimal Api” na segunda tela do assistente, conforme a figura aponta.

Criação de projeto .NET com minimal API como Default

Nas versões anteriores do Visual Studio esta opção não existia.

Criado o projeto, vamos implementar uma classe para podermos montar os métodos da Api usando Scaffolding :

Classe exemplo para criação de Api

Com a classe criada, vamos clicar no “Solution Explorer” com o botão direito, e acionar no menu “Add”, “New Scaffolded Item” (ou em português Adicionar, Novo item com Scaffold).

Para quem já é familiarizado com o assistente de Scaffold do Visual Studio, agora há duas novas opções, que são os métodos para criação de Minimal Api:

Tela do processo de Scaffold onde seleciona-se o modelo a seguir

Escolha o item marcado, e siga os passos abaixo na tela que se abre.

1. escolha a classe que vai utilizar para fazer os endpoints da API.

Tela do processo de Scaffold selecionando a classe

2. Defina uma nova classe (ou uma pré-existente) para ter em seu conteúdo as definições dos serviços de Minimal Api, clicando no primeiro botão “+” na linha “Endpoint Class”.

Tela do processo de Scaffold nomeando a classe que terá os endpoints

3. Crie um contexto (caso ainda não exista) para utilização via Entity-Framework no seu projeto para persistência de dados, no segundo botão “+” na linha “Data Context Class”.

Tela do processo de Scaffold nomeando a classe que terá o contexto do banco de dados

Pronto, depois de tudo definido, clique no botão “Add” e o processo irá começar.

Tela do processo de Scaffold finalizando o processo

Irá aparecer uma janela onde você acompanhará a criação dos componentes:

Processamento da ação de scaffolding

E ao final, teremos uma nova classe, que contém a definição dos endpoints para as ações da sua api (Get/Post/Put/Delete).

Classe criada com os endpoints após processo de Scaffolding

Onde vale destacar os itens:

1. a classe é do tipo estática, assim como o método “MapClienteEndpoints” que foi criado para servir como um método de Extensão do elemento “IEndpointRouteBuilder” (2)

Com esta implementação, automaticamente também foi editado o “program.cs” onde uma nova linha foi inserida para acionar a implementação deste endpoint da aplicação (1).

Também vemos no topo, que houve a especificação do Contexto na definição dos serviços da aplicação, para que o mesmo possa ser instanciado e utilizado posteriormente.

Sendo assim, a nossa aplicação já terá seus endpoints criados conforme demonstra o Swagger quando executarmos a aplicação:

Obviamente, que a implementação é a mais simples possível e para uma aplicação profissional, demandaria implementação da validação dos itens recebidos no request, assim como implementação de lógicas de negócio para impedir duplicidade de clientes por exemplo, mas já serve de base para a instância dos endpoints utilizando Minimal Api.

Gostou do artigo? clique no ícone👏e também me siga para ver as próximas publicações !!