Para maioria de nós desenvolvedores, escrever testes unitários é algo comum em nosso dia a dia. Seja para garantir a qualidade de nossos trechos de código, ou, para os menos exigentes, passar na cobertura mínima exigida pela esteira de CI/CD, desenvolver testes unitários é uma tarefa simples, mesmo para desenvolvedores com pouca experiência.
Mas quando falamos sobre testes de integração há uma certa complexidade, principalmente quando nossas aplicações possuem dependências externas, como, por exemplo, salvar registros em bancos de dados, enviar mensagens para um broker de mensageria, etc.
A biblioteca TestContainers nos ajuda a resolver estas dependências externas. Com a possibilidade de executar imagens docker durante a execução de nossos testes, podemos, por exemplo, subir uma instância de RabbitMq para que a nossa aplicação se conecte, e por fim a instância é finalizada após o término da execução dos testes.
Neste artigo, veremos um exemplo de uma aplicação Spring que se conecta a um MongoDB para salvar registros através de um endpoint, e utilizaremos TestContainers para escrever nossos testes integrados.
É necessário ter o docker instalado na máquina para seguir os passos deste artigo.
Passaremos pelos principais pontos para utilização da biblioteca, o código pronto está disponível em:
Criação do projeto
Para começar, crie uma nova aplicação Spring com as seguintes dependências:
- Spring Web, para criar um endpoint REST.
- Spring Data MongoDB, para a comunicação com o banco de dados.
Siga o exemplo do repositório e crie suas classes de model, repository, service e controller.
Adicione a dependência do TestContainer no pom.xml.
No pacote test crie a classe MongoDbContainer.
Importante ressaltar neste ponto que poderíamos utilizar diretamente a classe MongoDBContainer, provido pelo TestContainer, conforme a documentação oficial, porém o intuito é também demonstrar a classe GenericContainer pois com ela podemos referenciar a qualquer imagem pública, que neste caso referenciamos mongo na sua versão latest.
Também no pacote test, crie a classe responsável por registrar e inicializar as properties para conexão com o banco.
E então, crie sua classe de teste, executando a instância do MongoDB antes da execução dos testes no @beforeAll, e executando as chamadas HTTP's dentro do caso de teste.
A chamada POST chamou o método do nosso controller que salva a mensagem no MongoDB, e realizando a chamada GET, garantimos que essa Mensagem foi salva, pois foi retornada.
Executando
Na pasta do projeto execute os testes.
./mvnw test
Biblioteca irá chamar o docker que executará o contêiner com a imagem do MongoDB.
Contêiner do TestContainer e do Mongo são iniciados no docker local.
Aplicação é iniciada e abre conexão com a instância do banco de dados.
Testes são executados com sucesso e os Contêineres são finalizados e removidos para evitar sujeira no disco.
Conclusão
Vimos que a biblioteca facilita nossos testes de integração, fornecendo instâncias de qualquer aplicação que possa ser executada em um contêiner docker. TestContainers ainda possui suporte para docker compose, trazendo mais possibilidades para seus testes.
Top comments (0)