feat(tests): add UserGetByIdContainerTest with PostgreSQL integration

pom.xml

@@ -28,11 +28,24 @@
 	</scm>
 	<properties>
 		<java.version>25</java.version>
+		<testcontainers.version>1.19.8</testcontainers.version>
 		<skipDocker>false</skipDocker>
 		<sonar.coverage.exclusions>**/*Application.java</sonar.coverage.exclusions>
 		<sonar.test.exclusions>**/feature/SpringIntegrationTest.java</sonar.test.exclusions>
 		<sonar.coverage.jacoco.xmlReportPaths>${project.build.directory}/site/jacoco/jacoco.xml</sonar.coverage.jacoco.xmlReportPaths>
 	</properties>
+
+	<dependencyManagement>
+		<dependencies>
+			<dependency>
+				<groupId>org.testcontainers</groupId>
+				<artifactId>testcontainers-bom</artifactId>
+				<version>${testcontainers.version}</version>
+				<type>pom</type>
+				<scope>import</scope>
+			</dependency>
+		</dependencies>
+	</dependencyManagement>
 	<dependencies>
 		<dependency>
 			<groupId>com.h2database</groupId>
@@ -117,6 +130,21 @@
 			<artifactId>spring-boot-starter-test</artifactId>
 			<scope>test</scope>
 		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-testcontainers</artifactId>
+			<scope>test</scope>
+		</dependency>
+		<dependency>
+			<groupId>org.testcontainers</groupId>
+			<artifactId>junit-jupiter</artifactId>
+			<scope>test</scope>
+		</dependency>
+		<dependency>
+			<groupId>org.testcontainers</groupId>
+			<artifactId>postgresql</artifactId>
+			<scope>test</scope>
+		</dependency>
 		<dependency>
 			<groupId>org.liquibase</groupId>
 			<artifactId>liquibase-core</artifactId>

src/test/java/com/xpeho/spring_boot_java_random_user/presentation/UserGetByIdContainerTest.java

@@ -0,0 +1,89 @@
+package com.xpeho.spring_boot_java_random_user.presentation;
+
+import com.xpeho.spring_boot_java_random_user.data.models.database.User;
+import com.xpeho.spring_boot_java_random_user.data.sources.database.UserRepository;
+import com.xpeho.spring_boot_java_random_user.domain.entities.UserEntity;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.resttestclient.autoconfigure.AutoConfigureTestRestTemplate;
+import org.springframework.boot.testcontainers.service.connection.ServiceConnection;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.boot.resttestclient.TestRestTemplate;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.test.context.ActiveProfiles;
+import org.testcontainers.containers.PostgreSQLContainer;
+import org.testcontainers.junit.jupiter.Container;
+import org.testcontainers.junit.jupiter.Testcontainers;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+@Testcontainers
+@AutoConfigureTestRestTemplate
+@ActiveProfiles("test")
+@SpringBootTest(
+        webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT,
+        properties = {
+                "spring.sql.init.mode=never",
+                "spring.jpa.hibernate.ddl-auto=create-drop"
+        }
+)
+class UserGetByIdContainerTest {
+
+    @Container
+    @ServiceConnection
+    static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:16-alpine");
+
+    @Autowired
+    private TestRestTemplate restTemplate;
+
+    @Autowired
+    private UserRepository userRepository;
+
+    @BeforeEach
+    void setUp() {
+        userRepository.deleteAll();
+    }
+
+    @Test
+    @DisplayName("GET /random-users/{id} should return 200 with persisted user")
+    void shouldReturnUserByIdWhenUserExists() {
+        User user = new User();
+        user.setGender("female");
+        user.setFirstname("Jane");
+        user.setLastname("Doe");
+        user.setCivility("Ms");
+        user.setEmail("jane.doe@example.com");
+        user.setPhone("0600000000");
+        user.setPicture("https://example.com/jane.jpg");
+        user.setNationality("FR");
+
+        User saved = userRepository.saveAndFlush(user);
+
+        ResponseEntity<UserEntity> response = restTemplate.getForEntity(
+            "/random-users/{id}",
+                UserEntity.class,
+                saved.getId()
+        );
+
+        assertThat(response.getStatusCode()).isEqualTo(HttpStatus.OK);
+        assertThat(response.getBody()).isNotNull();
+        assertThat(response.getBody().id()).isEqualTo(saved.getId());
+        assertThat(response.getBody().firstname()).isEqualTo("Jane");
+        assertThat(response.getBody().nat()).isEqualTo("FR");
+    }
+
+    @Test
+    @DisplayName("GET /random-users/{id} should return 404 when user does not exist")
+    void shouldReturnNotFoundWhenUserDoesNotExist() {
+        ResponseEntity<UserEntity> response = restTemplate.getForEntity(
+            "/random-users/{id}",
+                UserEntity.class,
+            -1
+        );
+
+        assertThat(response.getStatusCode()).isEqualTo(HttpStatus.NOT_FOUND);
+    }
+}