unit-test-application-events

Unit Testing Application Events

Overview

Provides actionable patterns for testing Spring ApplicationEvent publishers and @EventListener consumers using JUnit 5 and Mockito — without booting the full Spring context.

When to Use

• Writing unit tests for event publishers or listeners
• Verifying that an event was published with correct payload
• Testing @EventListener method invocation and side effects
• Testing event propagation through multiple listeners
• Validating async event handling (@Async + @EventListener)
• Mocking ApplicationEventPublisher in service tests

Instructions

1. Add test dependencies: spring-boot-starter, JUnit 5, Mockito, AssertJ
2. Mock ApplicationEventPublisher: use @Mock on the publisher field in the service under test
3. Capture events with ArgumentCaptor: ArgumentCaptor.forClass(EventType.class) to inspect published payload
4. Verify listener side effects: invoke listener directly against mocked dependencies
5. Test async handlers: use Thread.sleep() or Awaitility — then assert the async operation was called
6. Add validation checkpoints:
   • After capturing an event, confirm eventCaptor.getValue() is not null before asserting fields
   • If the listener is not invoked, verify publishEvent() was called with the correct event type
   • If async assertions fail, increase wait time and check the executor pool is not saturated
7. Cover error scenarios: assert listeners handle exceptions gracefully

Examples

Maven

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
  <groupId>org.junit.jupiter</groupId>
  <artifactId>junit-jupiter</artifactId>
  <scope>test</scope>
</dependency>
<dependency>
  <groupId>org.mockito</groupId>
  <artifactId>mockito-core</artifactId>
  <scope>test</scope>
</dependency>
<dependency>
  <groupId>org.assertj</groupId>
  <artifactId>assertj-core</artifactId>
  <scope>test</scope>
</dependency>