Completed Rick and Morty task

pom.xml

@@ -19,13 +19,28 @@
 		<maven.checkstyle.plugin.configLocation>
 			https://raw.githubusercontent.com/mate-academy/style-guides/master/java/checkstyle.xml
 		</maven.checkstyle.plugin.configLocation>
+		<mapstruct.version>1.5.5.Final</mapstruct.version>
 	</properties>
 	<dependencies>
 		<dependency>
 			<groupId>org.springframework.boot</groupId>
 			<artifactId>spring-boot-starter</artifactId>
 		</dependency>
-
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-web</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-devtools</artifactId>
+			<scope>runtime</scope>
+			<optional>true</optional>
+		</dependency>
+		<dependency>
+			<groupId>mysql</groupId>
+			<artifactId>mysql-connector-java</artifactId>
+			<version>8.0.32</version>
+		</dependency>
 		<dependency>
 			<groupId>org.springframework.boot</groupId>
 			<artifactId>spring-boot-starter-test</artifactId>
@@ -40,6 +55,42 @@
 		<dependency>
 			<groupId>com.h2database</groupId>
 			<artifactId>h2</artifactId>
+			<scope>test</scope>
+		</dependency>
+		<dependency>
+			<groupId>org.hibernate.validator</groupId>
+			<artifactId>hibernate-validator</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.projectlombok</groupId>
+			<artifactId>lombok</artifactId>
+			<optional>true</optional>
+		</dependency>
+
+		<dependency>
+			<groupId>org.mapstruct</groupId>
+			<artifactId>mapstruct</artifactId>
+			<version>${mapstruct.version}</version>
+		</dependency>
+		<dependency>
+			<groupId>org.mapstruct</groupId>
+			<artifactId>mapstruct-processor</artifactId>
+			<version>${mapstruct.version}</version>
+		</dependency>
+		<dependency>
+			<groupId>org.springdoc</groupId>
+			<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+			<version>2.1.0</version>
+		</dependency>
+		<dependency>
+			<groupId>org.mockito</groupId>
+			<artifactId>mockito-core</artifactId>
+			<scope>test</scope>
+		</dependency>
+		<dependency>
+			<groupId>org.testcontainers</groupId>
+			<artifactId>junit-jupiter</artifactId>
+			<scope>test</scope>
 		</dependency>
 	</dependencies>
 
@@ -62,6 +113,9 @@
 					</execution>
 				</executions>
 				<configuration>
+					<sourceDirectories>
+						<sourceDirectory>${project.build.sourceDirectory}</sourceDirectory>
+					</sourceDirectories>
 					<configLocation>${maven.checkstyle.plugin.configLocation}</configLocation>
 					<consoleOutput>true</consoleOutput>
 					<failsOnError>true</failsOnError>

src/main/java/mate/academy/rickandmorty/Application.java → src/main/java/mate/academy/rickandmorty/RickAndMortyApplication.java

@@ -4,9 +4,9 @@
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 
 @SpringBootApplication
-public class Application {
+public class RickAndMortyApplication {
 
     public static void main(String[] args) {
-        SpringApplication.run(Application.class, args);
+        SpringApplication.run(RickAndMortyApplication.class, args);
     }
 }

src/main/java/mate/academy/rickandmorty/config/HttpConfig.java

@@ -0,0 +1,14 @@
+package mate.academy.rickandmorty.config;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.web.client.RestTemplate;
+
+@Configuration
+public class HttpConfig {
+
+    @Bean
+    public RestTemplate restTemplate() {
+        return new RestTemplate();
+    }
+}

src/main/java/mate/academy/rickandmorty/controller/CharacterController.java

@@ -0,0 +1,38 @@
+package mate.academy.rickandmorty.controller;
+
+import io.swagger.v3.oas.annotations.Operation;
+import java.util.List;
+import lombok.RequiredArgsConstructor;
+import mate.academy.rickandmorty.dto.CharacterResponseDto;
+import mate.academy.rickandmorty.service.InternalCharacterService;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api/characters")
+public class CharacterController {
+    private final InternalCharacterService internalCharacterService;
+
+    @Operation(summary = "Get a random character",
+            description = "Returns a randomly selected character from the database, "
+            + "including all available details such as: id, name, gender, and status")
+    @GetMapping("/random")
+    public CharacterResponseDto getRandomCharacter() {
+        return internalCharacterService.getRandomCharacter();
+    }
+
+    @Operation(summary = "Search for characters by name",
+            description = "Retrieves a list of characters whose names contain "
+                    + "the provided search string.")
+    @GetMapping("/search")
+    public List<CharacterResponseDto> searchCharacterByName(@RequestParam String name) {
+        if (!name.matches("[a-zA-Z]+")) {
+            throw new IllegalArgumentException("Invalid name format");
+        }
+
+        return internalCharacterService.searchCharacterByName(name);
+    }
+}

src/main/java/mate/academy/rickandmorty/dto/CharacterResponseDto.java

@@ -0,0 +1,16 @@
+package mate.academy.rickandmorty.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+public class CharacterResponseDto {
+    private Long id;
+    private Long externalId;
+    private String name;
+    private String status;
+    private String gender;
+}

src/main/java/mate/academy/rickandmorty/dto/ExternalApiResponse.java

@@ -0,0 +1,13 @@
+package mate.academy.rickandmorty.dto;
+
+import java.util.List;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+public class ExternalApiResponse {
+    private List<ExternalCharacterDto> results;
+}

src/main/java/mate/academy/rickandmorty/dto/ExternalCharacterDto.java

@@ -0,0 +1,15 @@
+package mate.academy.rickandmorty.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+public class ExternalCharacterDto {
+    private Long id;
+    private String name;
+    private String status;
+    private String gender;
+}

src/main/java/mate/academy/rickandmorty/entity/Character.java

@@ -0,0 +1,25 @@
+package mate.academy.rickandmorty.entity;
+
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Table;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Entity
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Table(name = "characters")
+public class Character {
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+    private Long externalId;
+    private String name;
+    private String status;
+    private String gender;
+}

src/main/java/mate/academy/rickandmorty/entity/Gender.java

@@ -0,0 +1,14 @@
+package mate.academy.rickandmorty.entity;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+public enum Gender {
+    MALE("Male"),
+    FEMALE("Female"),
+    UNKNOWN("Unknown");
+
+    private final String gender;
+}

src/main/java/mate/academy/rickandmorty/entity/Status.java

@@ -0,0 +1,14 @@
+package mate.academy.rickandmorty.entity;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+public enum Status {
+    ALIVE("Alive"),
+    DEAD("Dead"),
+    UNKNOWN("Unknown");
+
+    private final String status;
+}

src/main/java/mate/academy/rickandmorty/exception/CharacterNotFoundException.java

@@ -0,0 +1,7 @@
+package mate.academy.rickandmorty.exception;
+
+public class CharacterNotFoundException extends RuntimeException {
+    public CharacterNotFoundException(String message) {
+        super(message);
+    }
+}

src/main/java/mate/academy/rickandmorty/exception/ExternalApiException.java

@@ -0,0 +1,7 @@
+package mate.academy.rickandmorty.exception;
+
+public class ExternalApiException extends RuntimeException {
+    public ExternalApiException(String message) {
+        super(message);
+    }
+}

src/main/java/mate/academy/rickandmorty/exception/GlobalExceptionHandler.java

@@ -0,0 +1,42 @@
+package mate.academy.rickandmorty.exception;
+
+import java.util.Map;
+import org.springframework.http.HttpStatus;
+import org.springframework.web.bind.MissingServletRequestParameterException;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.ResponseStatus;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+
+@RestControllerAdvice
+public class GlobalExceptionHandler {
+    @ExceptionHandler(CharacterNotFoundException.class)
+    @ResponseStatus(HttpStatus.NOT_FOUND)
+    public Map<String, String> handleCharacterNotFound(CharacterNotFoundException e) {
+        return Map.of("error", e.getMessage());
+    }
+
+    @ExceptionHandler(ExternalApiException.class)
+    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
+    public Map<String, String> handleExternalApiException(ExternalApiException e) {
+        return Map.of("error", e.getMessage());
+    }
+
+    @ExceptionHandler(Exception.class)
+    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
+    public Map<String, String> handleGenericException(Exception e) {
+        return Map.of("error", "Unexpected error occurred", "details", e.getMessage());
+    }
+
+    @ExceptionHandler(MissingServletRequestParameterException.class)
+    @ResponseStatus(HttpStatus.BAD_REQUEST)
+    public Map<String, String> handleMissingServletRequestParameter(
+            MissingServletRequestParameterException e) {
+        return Map.of("error", "Missing required parameter: " + e.getParameterName());
+    }
+
+    @ExceptionHandler(IllegalArgumentException.class)
+    @ResponseStatus(HttpStatus.BAD_REQUEST)
+    public Map<String, String> handleIllegalArgumentException(IllegalArgumentException e) {
+        return Map.of("error", e.getMessage());
+    }
+}

src/main/java/mate/academy/rickandmorty/initdata/DataInitializer.java

@@ -0,0 +1,25 @@
+package mate.academy.rickandmorty.initdata;
+
+import java.util.List;
+import lombok.RequiredArgsConstructor;
+import mate.academy.rickandmorty.entity.Character;
+import mate.academy.rickandmorty.service.ExternalCharacterService;
+import mate.academy.rickandmorty.service.InternalCharacterService;
+import org.springframework.boot.context.event.ApplicationReadyEvent;
+import org.springframework.context.event.EventListener;
+import org.springframework.stereotype.Component;
+
+@Component
+@RequiredArgsConstructor
+public class DataInitializer {
+    private final ExternalCharacterService externalCharacterService;
+    private final InternalCharacterService internalCharacterService;
+
+    @EventListener(ApplicationReadyEvent.class)
+    public void initData() {
+        if (internalCharacterService.getAllCharacters().isEmpty()) {
+            List<Character> characters = externalCharacterService.fetchAllCharactersFromApi();
+            internalCharacterService.saveAllCharacters(characters);
+        }
+    }
+}

src/main/java/mate/academy/rickandmorty/mapper/CharacterMapper.java

@@ -0,0 +1,40 @@
+package mate.academy.rickandmorty.mapper;
+
+import java.util.Arrays;
+import mate.academy.rickandmorty.dto.CharacterResponseDto;
+import mate.academy.rickandmorty.dto.ExternalCharacterDto;
+import mate.academy.rickandmorty.entity.Character;
+import mate.academy.rickandmorty.entity.Gender;
+import mate.academy.rickandmorty.entity.Status;
+import org.mapstruct.Mapper;
+import org.mapstruct.Mapping;
+import org.mapstruct.Named;
+
+@Mapper(componentModel = "spring")
+public interface CharacterMapper {
+    @Mapping(source = "externalId", target = "externalId")
+    @Mapping(source = "status", target = "status", qualifiedByName = "stringToStatus")
+    @Mapping(source = "gender", target = "gender", qualifiedByName = "stringToGender")
+    CharacterResponseDto toDto(Character character);
+
+    @Mapping(source = "id", target = "externalId")
+    @Mapping(source = "status", target = "status", qualifiedByName = "stringToStatus")
+    @Mapping(source = "gender", target = "gender", qualifiedByName = "stringToGender")
+    Character toEntity(ExternalCharacterDto dto);
+
+    @Named("stringToStatus")
+    default Status stringToStatus(String status) {
+        return Arrays.stream(Status.values())
+                .filter(s -> s.getStatus().equalsIgnoreCase(status))
+                .findFirst()
+                .orElse(Status.UNKNOWN);
+    }
+
+    @Named("stringToGender")
+    default Gender stringToGender(String gender) {
+        return Arrays.stream(Gender.values())
+                .filter(g -> g.getGender().equalsIgnoreCase(gender))
+                .findFirst()
+                .orElse(Gender.UNKNOWN);
+    }
+}

src/main/java/mate/academy/rickandmorty/repository/CharacterRepository.java

@@ -0,0 +1,16 @@
+package mate.academy.rickandmorty.repository;
+
+import java.util.List;
+import java.util.Optional;
+import mate.academy.rickandmorty.entity.Character;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface CharacterRepository extends JpaRepository<Character, Long> {
+    Optional<Character> findByExternalId(Long externalId);
+
+    @Query("SELECT c FROM Character c WHERE LOWER(c.name) LIKE LOWER(CONCAT('%', :name, '%'))")
+    List<Character> findByNameContainingIgnoreCase(String name);
+}