Vamos continuar trabalhando com o projeto Jornada Milhas, que agora tem um diferencial. Agora estamos persistindo os dados de oferta em um banco de dados relacional.
Todo o projeto inicial atualizado com o qual vamos trabalhar durante este curso estará disponível na atividade de "Preparando o ambiente", para que possa fazer o download e as instalações necessárias para prosseguir nesse curso.
Criando testes de integração
Como estamos trabalhando com banco de dados, é a nossa classe DAL (Data Access Layer ou camada de acesso de dados) que vai manipular todas as informações referentes à oferta.
Vamos abrir o gerenciador de soluções, à esquerda do Visual Studio, para acessar a pasta "Dados", onde encontrar o arquivo OfertaViagemDAL.cs.
O primeiro método dessa classe é chamado Adicionar(). Podemos começar os testes por ele.
OfertaViagemDAL.cs:
public void Adicionar(OfertaViagem oferta)
{
context.OfertasViagem.Add(oferta);
context.SaveChanges();
}
Novamente no gerenciador de soluções, no projeto inicial que você já baixou, também temos o projeto de teste de integração já criado em "JornadaMilhas.Test.Integracao", como já aprendemos a criar anteriormente.
Podemos utilizar essa classe padrão, UnitTest1.cs, mas vamos renomeá-la para trabalhar com testes em relação ao método Adicionar().
UnitTest1.cs:
namespace JornadaMilhas.Test.Integracao;
public class UnitTest1
{
[Fact]
public void Test1()
{
}
}
Basta clicar com o botão direito em cima do nome do arquivo e escolher a opção de renomear (ou atalho "F2"). Vamos seguir o padrão de nomenclatura que já aprendemos anteriormente também. Assim, a nossa classe vai se chamar OfertaViagemDalAdicionar para trazer o nome da classe com a qual vamos trabalhar e o nome do método.
Vamos começar a escrever o nosso primeiro teste? Podemos fazer um teste para verificar se a oferta está sendo adicionada no banco.
Para isso, renomearemos o método público Test1(), que vem como padrão na linha 6, para RegistraOfertaNoBanco().
Nesse método, usaremos o padrão do AAA (lê-se triplo A), seguindo os passos de arrange (preparar), act (agir) e assert (verificar).
OfertaViagemDalAdicionar.cs:
public class OfertaViagemDalAdicionar
{
[Fact]
public void RegistraOfertaNoBanco()
{
}
}
No arrange, podemos começar a trazer os dados que vão construir a nossa oferta.
Para facilitar, vamos colar os dados de rota, período e preço. A rota de São Paulo a Fortaleza, o periodo do dia 20/8 até dia 30/8 e o preco como 350.
Já podemos construir a nossa oferta com esses dados. Na próxima linha, criaremos um var oferta, que será um new OfertaViagem(), onde passaremos a rota, o periodo e também o preco.
Após criar a oferta, precisamos criar o DAL também para poder trabalhar com ele. Também criaremos um var dal, que será um new OfertaViagemDAL().
public class OfertaViagemDalAdicionar
{
[Fact]
public void RegistraOfertaNoBanco()
{
Rota rota = new Rota("São Paulo", "Fortaleza");
Periodo periodo = new Periodo(new DateTime(2024, 8, 20), new DateTime(2024, 8, 30));
double preco = 350
var oferta = new OfertaViagem(rota, periodo, preco);
var dal = new OfertaViagemDAL();
}
}
No act, vamos colocar o que queremos realmente verificar, que é a adição dessa oferta no nosso banco de dados. Devemos verificar no dal chamando o método Adicionar() para adicionar a oferta que acabamos de criar.
Enquanto no assert, durante esse processo de adicionar a oferta, queremos verificar se a nossa oferta foi incluída no banco.
Para isso, podemos usar outro método que também temos no DAL também, que é o de recuperar essa oferta pelo ID.
Primeiro, vamos criar um var ofertaIncluida que recebe o dal.RecuperarPorId(), passando a oferta.Id.
Com essa informação da ofertaIncluida, já conseguimos fazer a verificação. Escreveremos Assert.NotNull(), pois queremos verificar se essa informação de ofertaIncluida não será nula. Se não for nula, é porque existe a oferta incluída no banco.
Também podemos fazer outro assert, um Assert.Equal(), para comparar o valor da oferta com a ofertaIncluida para verificar se foi incluído o valor que realmente queríamos.
Para isso, verificaremos se ofertaIncluida.Preco é igual ao oferta.Preco. Além disso, vamos passar um terceiro parâmetro para delimitar as casas decimais, que será 0.001.
public class OfertaViagemDalAdicionar
{
[Fact]
public void RegistraOfertaNoBanco()
{
Rota rota = new Rota("São Paulo", "Fortaleza");
Periodo periodo = new Periodo(new DateTime(2024, 8, 20), new DateTime(2024, 8, 30));
double preco = 350;
var oferta = new OfertaViagem(rota, periodo, preco);
var dal = new OfertaViagemDAL();
dal.Adicionar(oferta);
var ofertaIncluida = dal.RecuperarPorId(oferta.Id);
Assert.NotNull(ofertaIncluida);
Assert.Equal(ofertaIncluida.Preco, oferta.Preco, 0.001);
}
}
Criamos o nosso primeiro método de teste que vai verificar esse registro de oferta no banco. Vamos executá-lo?
Abrimos o gerenciador de testes, na lateral direita, e vamos clicar em "Executar todos os testes na exibição" (ou atalho "Ctrl + R, V").
Todos os testes foram executados com sucesso, incluindo o RegistroOfertaNoBanco.
Modificando o contexto
Se analisamos a classe OfertaViagemDAL, reparamos que ela trabalha em cima de um context. E, na linha 16, podemos usar o "Ctrl" e clicar em cima de JornadaMilhasContext() para poder abrir essa classe e verificar também o que tem nesse contexto.
Nesse contexto, temos o endereço do nosso banco de dados, que é o componente externo que estamos testando. Para o nosso teste funcionar corretamente, ele depende diretamente do funcionamento desse componente externo também.
JornadaMilhasContext.cs:
public class JornadaMilhasContext: DbContext
{
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
optionsBuilder
.UseSqlServer("Data Source=(localdb)\\MSSQLLocalDB;Initial Catalog=JornadaMilhas;Integrated Security=True;Connect Timeout=30;Encrypt=False;Trust Server Certificate=False;Application Intent=ReadWrite;Multi Subnet Failover=False");
}
}
O que aconteceria se precisássemos apontar esse endereço para outro banco de dados? Vamos fazer o teste e ver o que acontece?
Na informação do contexto, em OnCofiguring(), onde tem o nome do banco de dados, que é esse Initial Catalog, vamos colocar um Test na frente do JornadaMilhas. Assim, o nome desse outro banco será JornadaMilhasTest.
public class JornadaMilhasContext: DbContext
{
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
optionsBuilder
.UseSqlServer("Data Source=(localdb)\\MSSQLLocalDB;Initial Catalog=JornadaMilhasTest;Integrated Security=True;Connect Timeout=30;Encrypt=False;Trust Server Certificate=False;Application Intent=ReadWrite;Multi Subnet Failover=False");
}
}
Agora, abrimos novamente no gerenciador de testes e executamos todos nossos testes, para verificar o que vai acontecer.
O teste de RegistroOfertaNoBanco falhou, parou de funcionar, porque não está conseguindo achar a conexão com o banco.
Próximos passos
Essa falha que está dando no nosso teste aconteceu sem mudar absolutamente nada no teste. Ele está tendo dois comportamentos diferentes com o mesmo teste. Isso é uma falha em relação à característica determinística que os testes precisam ter.
Precisamos que o nosso teste tenha o mesmo resultado, independente da situação.
Nos testes de unidade, é um pouco mais fácil conseguir garantir essa característica, porque não temos essa relação com componentes externos.
Já nesse caso, que estamos trabalhando com uma relação com o banco de dados, estamos trabalhando com testes de integração, que são testes que verificam essa comunicação e essa integração efetivamente de dois componentes. Nesse caso, estamos trabalhando com a nossa aplicação e o banco de dados.
Existem vários tipos de componentes externos que podemos precisar testar, como, por exemplo, APIs ou outros serviços que a aplicação precisa utilizar. Mas, no caso desse curso, vamos focar exclusivamente nos testes de integração para banco de dados, que é um componente externo muito comum de ser utilizado nesse universo back-end.
No próximo vídeo, vamos começar a entender como controlar a dependência desses componentes externos, mais especificamente, ao banco de dados. Até lá!