Repository navigation
Capitulo 05
Estamos chegando à reta final da nossa implementação. Criamos uma API reativa para trabalhar com o nosso projeto CodeChella, um site de venda de ingressos para eventos diversos.
Devido ao esgotamento de alguns ingressos em tempo real e à necessidade de informar a posição na fila para os usuários, foi necessário utilizar uma API reativa. Esse cenário foi mais adequado para o uso desse tipo de tecnologia, e aproveitamos o recurso do Spring WebFlux para isso.
Além disso, utilizamos o SSE, que é o Server-Sent Events, e fizemos uma conexão com uma API externa de forma assíncrona e não bloqueante, usando o WebClient.
Antes de concluir o nosso projeto, é essencial implementar testes. Vamos criar o recurso de testar o nosso controlador de eventos de forma reativa. Para isso, utilizaremos o banco de dados em memória, o H2.
Portanto, vamos subir um banco em memória, rodar as migrations e realizar testes de inserção, exclusão e outras operações sobre os eventos.
Nosso primeiro procedimento será incluir as dependências do H2 no arquivo pom.xml. Dentro do arquivo "pom.xml", ao final da última dependência, que é a dependência do io.projectreactor, incluiremos as dependências do H2.
<dependency>
<groupId>com.h2database</groupId>
<artifactId>h2</artifactId>
<scope>runtime</scope>
</dependency>
<dependency>
<groupId>io.r2dbc</groupId>
<artifactId>r2dbc-h2</artifactId>
<scope>runtime</scope>
</dependency>As dependências são o h2database e o io.r2dbc, pois estamos trabalhando com um projeto reativo. Usaremos sempre o R2DBC, que é o Reactive Relational Database Connectivity. Após incluir as dependências, clicaremos no ícone do Maven para carregar as modificações e baixar as dependências necessárias.
Como não estamos usando nosso próprio banco de dados, precisamos indicar a URL desse banco. Dentro da parte de testes em "src > main > test", criaremos uma pasta "Resources" e um arquivo application.yml para configurar a URL de conexão ao H2.
No Explorador de arquivos, clicaremos com o botão direito do mouse sobre a pasta "test" e selecionaremos a opção "New > Directory". Chamaremos a nova pasta de "resources" e, dentro dela, criaremos um novo arquivo clicando com o botão direito do mouse sobre ela e selecionando "New > File". Chamaremos esse arquivo de "application.properties"
Dentro de "application.yml", configuraremos a URL do H2 usando a propriedade spring.r2dbc.url. Como estamos usando o H2, a URL será r2dbc:h2:mem:///test. As três barras (///) são usadas porque estamos trabalhando com o projeto reativo e test seria o nome do banco de dados.
Incluiremos a opção CASE_INSENSITIVE_IDENTIFIERS=TRUE para evitar problemas com identificadores em letras maiúsculas ou minúsculas. Também adicionaremos o parâmetro DB_CLOSE_DELAY=-1 para que a conexão do banco não seja fechada após o primeiro teste.
Se não inserirmos esse parâmetro, assim que o banco é iniciado, ele fecha. Não queremos que a conexão seja fechada.
spring:
r2dbc:
url: r2dbc:h2:mem:///test;CASE_INSENSITIVE_IDENTIFIERS=TRUEPrecisamos informar a URL do Flyway para que ele consiga executar e localizar as migrations. Para isso, usaremos spring.flyway.url com a mesma URL do R2DBC, mas trocando para jdbc e retirando as três barras.
spring:
flyway:
url: jdbc:h2:mem:test;CASE_INSENSITIVE_IDENTIFIERS=TRUEIndicaremos a localização das migrations com spring.flyway.locations=filesystem:src/main/resources/db/migration.
Com essas configurações, o banco H2 deve subir, criar a tabela de eventos e inserir alguns dados.
Agora, programaremos o nosso teste. Dentro de "src > test > java", no pacote "br.com.jnsdev.codechella > ApplicationTests", implementaremos o nosso teste.
Configuraremos o ambiente web ao lado da anotação @SpringBootTest, pedindo para que a aplicação suba em uma porta aleatória com webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT.
Usamos a RANDOM_PORT porque a porta, nesse caso, é indiferente. O que nos interessa é que a aplicação esteja rodando e possamos fazer os testes no controlador, inserindo e buscando eventos por ID, fazendo traduções etc.
Para construir testes numa API reativa, usaremos o Web Test Client, que o WebFlux fornece. Faremos um @Autowired para injetar o WebTestClient, dentro da classe ApplicationTests.
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
class ApplicationTests {
@Autowired
private WebTestClient webTestClient;
} Criamos o nosso primeiro teste, que veio por padrão sem nada:
@Test
void contextLoads() {
}Vamos renomear o método contextLoads() para cadastraNovoEvento(). Dentro desse teste, criaremos um EventoDto que chamaremos de dto e faremos um new EventoDto() passando os atributos. Passaremos o id null porque queremos que ele o gere automaticamente. Em seguida, o TipoEvento será do tipo SHOW, o nome do evento será "Kiss".
Para a data, escreveremos LocalDate.parse() com a data "2025-01-01". Já a descreição do evento será "Show da melhor banda que existe".
@Test
void cadastraNovoEvento() {
EventoDto dto = new EventoDto(null, TipoEvento.SHOW, "Kiss", LocalDate.parse("2025-01-01"), "Show da melhor banda que existe");
} Para testar o cadastro desse evento no banco H2, usaremos o webTestClient.post(), ou seja, uma requisição POST para a URI "/eventos", pois ele rodará em uma porta qualquer, mas depois dela, a rota será "/eventos".
O bodyValue será o dto criado, pois é lá que estão os dados do evento que queremos cadastrar. Após indicar o body, acrescentaremos .exchange(), para enviar a requisição. Depois disso, verificaremos o status esperado com expectStatus().isCreated(), já que toda vez que enviamos uma requisição POST, teoricamente, ele deve devolver um código "201 Created".
Em seguida, pediremos para verificar o corpo da resposta com expectBody(EventoDto.class).value(), indicando o tipo de estrutura que deve ser devolvida com EventoDto.class. Dentro dos parênteses de .value(), escreveremos response -> {} e conferiremos o que está vindo dentro da resposta.
Dentro das chaves, começaremos a fazer os assert. A primeira coisa que queremos verificar é se o ID foi criado. Por isso, verificaremos se o ID não é nulo com assertNotNull(response.id()).
Importaremos a classe assertNotNull clicando sobre ela com o botão direito do mouse e escolhendo a opção "Import static method 'org.junit.jupiter.api.Assertions.assertNotNull()'".
Faremos as outras verificações como a do tipo do evento com assertEquals(). Vamos importar o assertEquals(), passando primeiro como parâmetro o que foi criado e, em seguida, o que esperamos: dto.tipo(), response.tipo(). Repetiremos esse processo para os outros campos: nome, data e descricao.
webTestClient.post().uri("/eventos").bodyValue(dto)
.exchange()
.expectStatus().isCreated()
.expectBody(EventoDto.class)
.value(response -> {
assertNotNull(response.id());
assertEquals(dto.tipo(), response.tipo());
assertEquals(dto.nome(), response.nome());
assertEquals(dto.data(), response.data());
assertEquals(dto.descricao(), response.descricao());
});Executaremos o teste clicando na seta verde ao lado esquerdo do método cadastraNovoEvento. Obtivemos um erro. Em vez de 201 CREATED, foi enviado um 500 INTERNAL_SERVER_ERROR. Esse erro aconteceu porque a tabela "EVENTOS" não foi encontrada.
Corrigiremos esse erro voltando ao arquivo "application.yml" e incluindo DB_CLOSE_DELAY=-1 também no flyway, da seguinte forma:
spring:
flyway:
url: jdbc:h2:mem:test;CASE_INSENSITIVE_IDENTIFIERS=TRUE;DB_CLOSE_DELAY=-1Após essa modificação, executaremos o teste novamente. Tivemos um novo erro. Esperávamos o 201 CREATED, mas recebemos 200 OK. Abriremos o arquivo "EventoController" e observaremos que não especificamos que ele deveria devolver um status 201 em cadastrar().
Esse é um dos princípios do TDD (Test-Driven Development): orientamos a implementação ao teste. Não fizemos isso, mas só o fato de testarmos antes de liberar para a implementação possibilitou que identificássemos um erro. Logo abaixo de @PostMapping, vamos escrever: @ResponseStatus(HttpStatus.CREATED).
Vamos executar o teste mais uma vez, voltando ao arquivo "CodeChellaApplicationTests" e executaremos o cadastraNovoEvento() clicando na seta verde do lado esquerdo dessa linha de código.
Após corrigir o controlador, executaremos novamente o teste para verificar se ele passa. O teste passou, indicando que o banco H2 foi corretamente configurado, a tabela de eventos foi criada e os dados foram inseridos conforme esperado.

ℹ️ Testes são fundamentais para garantir a qualidade da aplicação e identificar possíveis erros antes de liberar para produção.
Para confirmar se nossa migration é executada com sucesso, vamos fazer um método GET. Em "src > main > resources > db > migration", encontramos a migration V002__insert_table_eventos.sql, responsável por inserir eventos, onde temos 14 itens.
V002__insert_table_eventos.sql:
INSERT INTO eventos (tipo, nome, data, descricao) VALUES
('SHOW', 'Taylor Swift', '2024-02-15', 'Um evento imperdível para todos os amantes da música pop.'),
('TEATRO', 'A Comédia da Vida', '2024-07-20', 'Uma peça teatral emocionante que retrata com humor momentos complexos da vida. Você não pode perder.'),
('CONCERTO', 'Concerto de Verão', '2024-06-10', 'Um concerto ao ar livre com grandes nomes da música clássica.'),
('PALESTRA', 'Palestra sobre Inteligência Artificial', '2024-09-05', 'Uma palestra informativa sobre as últimas tendências e ferramentas de IA.'),
('WORKSHOP', 'Workshop de Fotografia', '2024-11-30', 'Um workshop prático para aprimorar suas habilidades.'),
('SHOW', 'Stand-up Comedy', '2024-03-18', 'Uma noite de muito riso e diversão com os melhores comediantes do Brasil.'),
('CONCERTO', 'O Fantasma da Ópera', '2024-12-25', 'Uma apresentação clássica de ópera.'),
('TEATRO', 'Festival de Teatro', '2025-04-12', 'Um festival com as melhores peças teatrais do ano.'),
('PALESTRA', 'Fórum de Inovação e Empreendedorismo', '2025-10-08', 'Um fórum que reúne os maiores inovadores do país. Presença dos apresentadores do Shark Tank.'),
('WORKSHOP', 'Aulas de Culinária', '2025-05-20', 'Aulas práticas de culinária com chefs renomados.'),
('SHOW', 'Bruno Mars', '2025-05-22', 'De volta ao Brasil, Bruno promete entregar o maior e melhor show de sua carreira na turnê This is Mars.'),
('TEATRO', 'A Comédia da Vida', '2025-07-14', 'Uma peça teatral emocionante que você não pode perder.'),
('SHOW', 'The Weeknd', '2025-11-02', 'Um show eletrizante ao ar livre com muitos efeitos especiais.'),
('WORKSHOP', 'Café com Ideias', '2025-01-25', 'Um evento que ensina técnicas de brainstorming e priorização para alavancar projetos.');O décimo quarto item é um WORKSHOP chamado "Café com Ideias". Podemos fazer uma configuração para verificar, por exemplo, se o décimo terceiro item, logo acima, cadastra corretamente o SHOW do "The Weeknd", ou seja, se ele segue sequencialmente e confere o ID.
Com o arquivo CodechellaApplicationTests.java aberto, podemos reaproveitar trechos de código para agilizar o processo. Nesse caso, vamos copiar o @Test de cadastraNovoEvento().
@Test
void cadastraNovoEvento() {
EventoDto dto = new EventoDto(null, TipoEvento.SHOW, "Kiss",
LocalDate.parse("2025-01-01"), "Show da melhor banda que existe");
webTestClient.post().uri("/eventos").bodyValue(dto)
.exchange()
.expectStatus().isCreated()
.expectBody(EventoDto.class)
.value(response -> {
assertNotNull(response.id());
assertEquals(dto.tipo(), response.tipo());
assertEquals(dto.nome(), response.nome());
assertEquals(dto.data(), response.data());
assertEquals(dto.descricao(), response.descricao());
});
}Após colar o trecho ao final do código, em vez de cadastraNovoEvento(), teremos um teste chamado buscarEvento(). Além disso, o evento será o décimo quarto do arquivo V002__insert_table_eventos.sql, cujo ID, provavelmente, será 13, uma vez que a primeira linha é o comando INSERT. Sendo assim, teremos o SHOW do "The Weeknd" na data especificada.
Para criar um evento do show do The Weeknd, definiremos o id de EventoDto() como 13L, o tipo será TipoEvento.SHOW, e o nome será "The Weeknd".
Também podemos adicionar a data ("2025-11-2") em LocalDate.parse(). Por fim, copiaremos a mesma descrição (descricao): "Um show eletrizante ao ar livre com muitos efeitos especiais.".
// código omitido
@Test
void buscarEvento() {
EventoDto dto = new EventoDto(13L, TipoEvento.SHOW, "The Weeknd",
LocalDate.parse("2025-11-02"), "Um show eletrizante ao ar livre com muitos efeitos especiais.");
webTestClient.post().uri("/eventos").bodyValue(dto)
.exchange()
.expectStatus().isCreated()
.expectBody(EventoDto.class)
.value(response -> {
assertNotNull(response.id());
assertEquals(dto.tipo(), response.tipo());
assertEquals(dto.nome(), response.nome());
assertEquals(dto.data(), response.data());
assertEquals(dto.descricao(), response.descricao());
});
}Com essas informações, criaremos o dto corretamente.
Em seguida, faremos um método GET (get()) para comparar se ele busca corretamente. Portanto, em vez de webTestClient.post(), executaremos webTestClient.get().
Não haverá body nesse caso, então podemos retirar o bodyValue(dto). Manteremos o exchange() na linha abaixo, mas em expectStatus(), vamos substituir isCreated() por is2xxSuccessful(), que deve retornar o status 200. Abaixo, esperamos EventoDto.class em expectBody().
Na sequência, conferimos se os IDs estão corretos. Porém, em vez de assertNotNull(), queremos conferir se o id será 13 de fato. Sendo assim, podemos remover o assertNotNull() e, no lugar disso, comparar o ID enviado com o ID da resposta (assertEquals(dto.id(), eventoResponse.id())).
// código omitido
@Test
void buscarEvento() {
EventoDto dto = new EventoDto(20L, TipoEvento.SHOW, "The Weeknd",
LocalDate.parse("2025-11-02"), "Um show eletrizante ao ar livre com muitos efeitos especiais.");
// código omitidoQuando enviamos uma requisição GET, recebemos um array com vários eventos. Como chamamos o response inteiro no código (value(response -> {})), não foi possível desserializar.
Sendo assim, precisamos pegar a posição desejada da response, que é a 13, o décimo terceiro item cadastrado na migration. Portanto, após response, faremos um EventoDto chamado eventoResponse, que receberá response.get() na posição 13.
// código omitido
@Test
void buscarEvento() {
EventoDto dto = new EventoDto(20L, TipoEvento.SHOW, "The Weeknd",
LocalDate.parse("2025-11-02"), "Um show eletrizante ao ar livre com muitos efeitos especiais.");
webTestClient.get().uri("/eventos")
.exchange()
.expectStatus().is2xxSuccessful()
.expectBody(EventoDto.class)
.value(response -> {
EventoDto eventoResponse = response.get(13);
assertEquals(dto.id(), response.id());
assertEquals(dto.tipo(), response.tipo());
assertEquals(dto.nome(), response.nome());
assertEquals(dto.data(), response.data());
assertEquals(dto.descricao(), response.descricao());
});
}Nesse momento, é retornado um erro no método get(). Para o get(), não esperamos um body de resposta, então trocaremos expectBody() acima por expectBodyList(), pois ele devolverá uma lista com vários itens. Afinal, estamos lidando com um array.
Após pegar a posição 13 no método get(), comparamos todos os itens com eventoResponse. Assim, o primeiro assertEquals() receberá dto.id() e eventoResponse.id(). Faremos o mesmo para as linhas abaixo: dto.tipo() e eventoResponse.tipo(); dto.nome() com eventoResponse.nome(); dto.data() com eventoResponse.data(); e dto.descricao() com eventoResponse.descricao().
// código omitido
@Test
void buscarEvento() {
EventoDto dto = new EventoDto(20L, TipoEvento.SHOW, "The Weeknd",
LocalDate.parse("2025-11-02"), "Um show eletrizante ao ar livre com muitos efeitos especiais.");
webTestClient.get().uri("/eventos")
.exchange()
.expectStatus().is2xxSuccessful()
.expectBodyList(EventoDto.class)
.value(response -> {
EventoDto eventoResponse = response.get(13);
assertEquals(dto.id(), eventoResponse.id());
assertEquals(dto.tipo(), eventoResponse.tipo());
assertEquals(dto.nome(), eventoResponse.nome());
assertEquals(dto.data(), eventoResponse.data());
assertEquals(dto.descricao(), eventoResponse.descricao());
});
}Isso nos ajuda a verificar questões de paginação. Se precisarmos paginar, por exemplo, 10 itens, não poderíamos pegar a posição 13, pois geraria um erro. Portanto, os testes servem para muitas coisas.
Ao executar o teste com o id esperado definido como 20L, deve ser retornado um erro, pois o id deve ser 13L. Agora, conforme esperado, recebemos o erro específico do ID.
org.opentest4j.AssertionFailedError:
Expected :20
Actual :14O erro ocorreu conforme esperado, indicando que esperávamos 20, mas o evento inserido foi o 14. Nesse caso, algo aconteceu na inserção que impediu a sequência esperada, pois esperávamos que o "The Weeknd" fosse o id igual a 13L. Vamos verificar o que aconteceu?
Para testar novamente, vamos alterar o id para a posição 13L em EventoDto() e comparar as descrições. O que veio no item 13? O que foi diferente? Com a posição 13, qual item foi retornado? O de cima ou o de baixo? Será que ele inseriu com um id diferente? Podemos executar para conferir.
// código omitido
@Test
void buscarEvento() {
EventoDto dto = new EventoDto(13L, TipoEvento.SHOW, "The Weeknd",
LocalDate.parse("2025-11-02"), "Um show eletrizante ao ar livre com muitos efeitos especiais.");
// código omitidoAo executar novamente, recebemos a mensagem de que esperávamos 13 e foi retornado 14.
org.opentest4j.AssertionFailedError:
Expected :13
Actual :14Ao trazer uma lista, ele começa a contar do zero. Sendo assim, se queremos conferir o evento com id 13, devemos buscar a posição 12, não 13. Portanto, devemos fazer o response.get() na posição 12, para trazer o que foi cadastrado com id igual a 13.
// código omitido
@Test
void buscarEvento() {
EventoDto dto = new EventoDto(13L, TipoEvento.SHOW, "The Weeknd",
LocalDate.parse("2025-11-02"), "Um show eletrizante ao ar livre com muitos efeitos especiais.");
webTestClient.get().uri("/eventos")
.exchange()
.expectStatus().is2xxSuccessful()
.expectBodyList(EventoDto.class)
.value(response -> {
EventoDto eventoResponse = response.get(12);
assertEquals(dto.id(), eventoResponse.id());
assertEquals(dto.tipo(), eventoResponse.tipo());
assertEquals(dto.nome(), eventoResponse.nome());
assertEquals(dto.data(), eventoResponse.data());
assertEquals(dto.descricao(), eventoResponse.descricao());
});
}Ao testar novamente, a posição 12 deve corresponder ao show do The Weeknd.
Neste capítulo, aprendemos a testar a busca de eventos em uma aplicação reativa utilizando WebFlux.
Primeiro, consultamos a migration que insere eventos no banco de dados para entender a ordem dos eventos. Em seguida, configuramos um teste chamado buscarEvento() no CodechellaApplicationTests.java.
O teste simula uma requisição GET para buscar um evento específico (o show do The Weeknd) e verifica se os dados retornados correspondem aos dados esperados.
Durante o processo, enfrentamos alguns desafios, como a desserialização do array de eventos retornado pela requisição GET e a necessidade de ajustar o índice da posição do evento na lista de resposta.
No final, o teste é executado com sucesso, validando a funcionalidade de busca de eventos na aplicação. A aula também incentiva a exploração de outras possibilidades de teste e o compartilhamento de experiências na comunidade Alura.
CodeChella
by jnsdev