Here we will explain to use Junit 5 and Mockito 2 with Spring boot 2 when it comes to unit testing and integration tests .
First if you are interested to read more about Junit 5 and Mockito 2 , please check the following links :
- Junit 5: https://junit.org/junit5/
- Mockito 2 : https://github.com/mockito/mockito/wiki/What%27s-new-in-Mockito-2
Here we will show to the following :
- Gradle configuration for Junit 5 with spring boot 2
- How to define and execute unit test with Junit 5 and mockito 2
- How to define and execute spring boot integration test with Junit 5
Gradle configuration for Junit 5 with spring boot 2:
To add the needed Junit 5 dependencies , here what you need to add , whole code sample is on GitHub :
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| dependencies { | |
| compile group: 'org.springframework.boot', name: 'spring-boot-starter' | |
| testImplementation('org.junit.jupiter:junit-jupiter-api:5.2.0') | |
| testCompile('org.junit.jupiter:junit-jupiter-params:5.2.0') | |
| testRuntime('org.junit.jupiter:junit-jupiter-engine:5.2.0') | |
| testCompile "org.mockito:mockito-core:2.+" | |
| testCompile('org.mockito:mockito-junit-jupiter:2.18.3') | |
| testCompile('org.springframework.boot:spring-boot-starter-test') | |
| } |
How to define and execute unit test with Junit 5 and mockito 2:
To run Junit 5 test case with Mockito2 , we use Juipter extensions support and here we will use mockito extension , the purpose of Junit 5 extensions is to extend the behavior of test classes or methods, and these can be reused for multiple tests.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| @ExtendWith(MockitoExtension.class) | |
| @DisplayName("Spring boot 2 mockito2 Junit5 example") | |
| public class ShowServiceTests { | |
| private static final String MOCK_OUTPUT = "Mocked show label"; | |
| @Mock | |
| private TextService textService; | |
| @InjectMocks | |
| private ShowService showService; | |
| @BeforeEach | |
| void setMockOutput() { | |
| when(textService.getText()).thenReturn(MOCK_OUTPUT); | |
| } | |
| @Test | |
| @DisplayName("Mock the output of the text service using mockito") | |
| public void contextLoads() { | |
| assertEquals(showService.getShowLable(), MOCK_OUTPUT); | |
| } | |
| } |
How to define and execute spring boot integration test with Junit 5:
Now if we want to call the real service not the mocked one for integration test with Junit 5 , we will use spring extension to support that and now your integration test is running with Junit 5 support as well.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| @ExtendWith(SpringExtension.class) | |
| @SpringBootTest | |
| public class SpringBootJunit5IntegrationTest { | |
| @Autowired | |
| private ShowService showService; | |
| @Test | |
| @DisplayName("Integration test which will get the actual output of text service") | |
| public void contextLoads() { | |
| assertEquals(showService.getShowLable(), ORIGINAL_OUTPUT); | |
| } | |
| } |
Hoping this cover the starting jump when you want to use Junit 5 in your spring boot application .
The whole code sample is on GitHub
Romeh's TechBlog 