Testando serviços Web API com Postman

Tem se tornado muito comum no universo do desenvolvimento de sistemas a criação de serviços sendo construída sob o modelo REST,  realizando a troca de mensagens através de requisições HTTP.

Neste cenário, os serviços HTTP não possuem interface gráfica com o usuário. Então, para testar esse tipo de aplicação você poderá utilizar o Postman, Imagine, você não precisa usar seu tempo e recursos criar uma interface gráfica para testar um serviço.

O Postman, permite realizar requisições HTTP a partir de uma interface simples e intuitiva, facilitando o teste e depuração de serviços REST.

Veja como é fácil testar um serviço ASP.NET Web API, enviando e recebendo dados no formato JSON.

 

Instalando o Postman

l Ele pode ser instalado a partir da Chrome Web Store. Aqui ele será usado como um aplicativo externo ao Chrome, diferente das versões anteriores em que era aberto em uma aba como extensão. Se você desejar poderá criar uma conta e armazenar suas informações em um servidor do Postman, compartilhando assim seus testes e variáveis entre vários dispositivos onde você fizer login;

l Ser usado na Web;

l Ser baixado para o Windows.

 

Nota: O Postman pode ser usado para testar qualquer serviço HTTP RESTful.

Se você estiver usando o Microsoft Visual Studio, você poderá criar um novo projeto utilizando o template API Web do ASP.NET Core

Execute a aplicação e abra o Postman. Faremos uso dos verbos http para testar nossa API Web.

 

Apenas um lembrete:

GET  - listar dados

POST  - adiciona novos dados

PUT - substitui dados existentes

DELETE  - exclui dados existentes

PATCH - atualizar alguns campos de dados existentes

Para fazermos o teste, devemos adicionar o endereço de nossa aplicação, seguido de /api/ e o nome da entidade (exemplo: /api/Book)

O Postman, nos permite ver o status da operação (200, 204, ...)

No caso do POST, precisaremos fazer algumas configurações antes. Definir como Body, selecionar a opção “raw” (pois informaremos o conteúdo da mensagem) e o formato que poderá ser “JSON (application/json)”

Se você tentar inserir um novo registro com um ID que já existente, um status 409 – Conflict será retornado

 Para usar o  PUT o formato é bem semelhante as configurações anteriores. Porém se você usar um ID inexistente, um status 404 – Not Found, será retornado

O DELETE, é o mais simples adicione o id no final da URL e o ID que deseja excluir

Outra particularidade do Postman, é podermos trabalhar em equipes, customizar ambientes de teste, importar arquivos com requisições pré-definidas, entre outras.

O Postman ajuda a simplificar os testes,  pois ele nos podemos facilmente enviar requests HTTP para serviços RESTful, enviando parâmetros e recebendo as devidas respostas, além de analisar o tempo gasto em cada requisição, o que também pode auxiliar na localização de problemas de desempenho.

A ferramenta possui ampla documentação. Ele ainda conta com uma versão paga com recursos adicionais que irão ajudar aos desenvolvedores mais avançados.

Task - namespace System.Threading.Tasks

     Uma tarefa (task) representa uma unidade de trabalho que deverá ser realizada. Esta unidade de trabalho pode rodar em uma thread separada e é também possível iniciar uma task de forma sincronizada a qual resulta em uma espera pela thread chamada. Com tasks, você tem uma camada de abstração mas também um bom controle sobre as threads relacionadas.

    As tasks permitem muito mais flexibilidade na organização do trabalho. Por exemplo, você pode definir continuar o trabalho, que deve ser feito depois que uma tarefa esteja completa. Isso pode diferenciar se um tarefa foi executada com sucesso ou não. Você também pode organizar as tarefas em uma hierarquia onde uma tarefa pai pode criar novas tarefas filhas que pode criar dependências e assim o cancelamento da tarefa pai também cancela suas tarefas filhas.

    Para iniciar uma tarefa, você pode usar a classe TaskFactory ou o construtor da classe Task e o método Start().

    O construtor Task lhe dá mais flexibilidade na criação da tarefa. Ao iniciar uma tarefa, uma instância da classe Task pode ser criada e o código que deve ser executado pode ser atribuído com uma Action ou delegate Action<object> tanto sem parâmetro como com um parâmetro object.

    A classe Task também fornece construtores que inicializam a tarefa, mas que não a agendam para execução. Por razões de desempenho, o método StartNew da classe TaskFactory deve ser o mecanismo preferido para criação e programação de tarefas, mas, para situações em que a criação e programação devem ser separadas, os construtores podem ser usados, e o método Start() da tarefa pode então ser utilizado para programar a tarefa para execução em um momento posterior.

    O método Task.WhenAll aguarda assincronamente múltiplas operações assíncronas que são representadas através de uma coleção de tarefas. Usamos o método Task.WhenAll em um conjunto de tarefas. A aplicação de WhenAll retorna uma única tarefa que não está completa até que cada tarefa na coleção seja concluída. As tarefas parecem ser executadas em paralelo, mas não são criados novas threads.

IEntityTypeConfiguration

Namespace:: Microsoft.EntityFrameworkCore

Assembly:: Microsoft.EntityFrameworkCore.dll

Ele se aplica as versões: 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0

 

Permite que a configuração de um tipo de entidade seja fatorada em uma classe separada, e não em linha OnModelCreating(ModelBuilder)

Implemente essa interface, aplicando a configuração para a entidade no método  Configure(EntityTypeBuilder<TEntity>) e, em seguida, aplique a configuração ao modelo usando ApplyConfiguration<TEntity> em: OnModelCreating(ModelBuilder).

O parâmetro é do tipo: TEtity (O tipo de entidade a ser configurado)

Default Column Type

 Permite definir o padrão do tipo de dados da coluna no banco de dados.

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
foreach (var property in modelBuilder
.Model
.GetEntityTypes()
.SelectMany(
e => e.GetProperties()
.Where(p => p.ClrType == typeof(string))))
{
property.Relational().ColumnType = "varchar(100)";
}
}

Para definir o tipo de dados da coluna no banco de dados necessitamos utilizar o seguinte código:

property.Relational().ColumnType = "varchar(100)";

SQL - VEIRFICAR SE EXISTE REGISTROS DUPLICADOS

Veja como é simples verificar se existe algum registro duplicado um tabela

SELECT [NomeArquivo], Count(*) FROM [colpo_RegistroItens]

GROUP BY [NomeArquivo]

HAVING Count(*) > 1