executed the task

pom.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+		 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
 	<modelVersion>4.0.0</modelVersion>
 	<parent>
 		<groupId>org.springframework.boot</groupId>
@@ -15,12 +15,17 @@
 	<description>jv-rick-and-morty</description>
 	<properties>
 		<java.version>17</java.version>
+		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+		<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
 		<maven.checkstyle.plugin.version>3.1.1</maven.checkstyle.plugin.version>
 		<maven.checkstyle.plugin.configLocation>
 			https://raw.githubusercontent.com/mate-academy/style-guides/master/java/checkstyle.xml
 		</maven.checkstyle.plugin.configLocation>
+		<lombok.mapstruct.binding.version>0.2.0</lombok.mapstruct.binding.version>
+		<mapstruct.version>1.5.5.Final</mapstruct.version>
 	</properties>
 	<dependencies>
+
 		<dependency>
 			<groupId>org.springframework.boot</groupId>
 			<artifactId>spring-boot-starter</artifactId>
@@ -37,9 +42,38 @@
 			<artifactId>spring-boot-starter-data-jpa</artifactId>
 		</dependency>
 
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-web</artifactId>
+		</dependency>
+
+		<dependency>
+			<groupId>com.mysql</groupId>
+			<artifactId>mysql-connector-j</artifactId>
+			<version>8.0.33</version>
+		</dependency>
+
+		<dependency>
+			<groupId>org.projectlombok</groupId>
+			<artifactId>lombok</artifactId>
+		</dependency>
+
 		<dependency>
 			<groupId>com.h2database</groupId>
 			<artifactId>h2</artifactId>
+			<scope>test</scope>
+		</dependency>
+
+		<dependency>
+			<groupId>org.mapstruct</groupId>
+			<artifactId>mapstruct</artifactId>
+			<version>${mapstruct.version}</version>
+		</dependency>
+
+		<dependency>
+			<groupId>org.springdoc</groupId>
+			<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+			<version>2.1.0</version>
 		</dependency>
 	</dependencies>
 
@@ -49,6 +83,7 @@
 				<groupId>org.springframework.boot</groupId>
 				<artifactId>spring-boot-maven-plugin</artifactId>
 			</plugin>
+
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-checkstyle-plugin</artifactId>
@@ -66,9 +101,35 @@
 					<consoleOutput>true</consoleOutput>
 					<failsOnError>true</failsOnError>
 					<linkXRef>false</linkXRef>
+					<sourceDirectories>src</sourceDirectories>
+				</configuration>
+			</plugin>
+
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-compiler-plugin</artifactId>
+				<configuration>
+					<source>${java.version}</source>
+					<target>${java.version}</target>
+					<annotationProcessorPaths>
+						<path>
+							<groupId>org.projectlombok</groupId>
+							<artifactId>lombok</artifactId>
+							<version>${lombok.version}</version>
+						</path>
+						<path>
+							<groupId>org.projectlombok</groupId>
+							<artifactId>lombok-mapstruct-binding</artifactId>
+							<version>${lombok.mapstruct.binding.version}</version>
+						</path>
+						<path>
+							<groupId>org.mapstruct</groupId>
+							<artifactId>mapstruct-processor</artifactId>
+							<version>${mapstruct.version}</version>
+						</path>
+					</annotationProcessorPaths>
 				</configuration>
 			</plugin>
 		</plugins>
 	</build>
-
-</project>
+</project>

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

@@ -0,0 +1,12 @@
+package mate.academy.rickandmorty.config;
+
+import org.mapstruct.InjectionStrategy;
+import org.mapstruct.NullValueCheckStrategy;
+
+@org.mapstruct.MapperConfig(
+        componentModel = "spring",
+        injectionStrategy = InjectionStrategy.CONSTRUCTOR,
+        nullValueCheckStrategy = NullValueCheckStrategy.ALWAYS,
+        implementationPackage = "<PACKAGE_NAME>.impl")
+public class MapperConfig {
+}

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

@@ -0,0 +1,34 @@
+package mate.academy.rickandmorty.controller;
+
+import io.swagger.v3.oas.annotations.tags.Tag;
+import java.util.List;
+import lombok.RequiredArgsConstructor;
+import mate.academy.rickandmorty.dto.internal.CharacterDto;
+import mate.academy.rickandmorty.service.CharacterClient;
+import mate.academy.rickandmorty.service.CharacterService;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.web.PageableDefault;
+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;
+
+@Tag(name = "Character management", description = "Endpoints for managing characters")
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/characters")
+public class CharacterController {
+    private final CharacterClient characterClient;
+    private final CharacterService characterService;
+
+    @GetMapping("/random")
+    public CharacterDto testCharacters() {
+        return characterService.findByRandomId();
+    }
+
+    @GetMapping("/search")
+    public List<CharacterDto> searchByName(@RequestParam("name") String name,
+                                           @PageableDefault Pageable pageable) {
+        return characterService.findByName(name, pageable);
+    }
+}

src/main/java/mate/academy/rickandmorty/dto/external/CharacterResponseDataDto.java

@@ -0,0 +1,10 @@
+package mate.academy.rickandmorty.dto.external;
+
+import java.util.List;
+import lombok.Data;
+
+@Data
+public class CharacterResponseDataDto {
+    private List<Result> results;
+    private Info info;
+}

src/main/java/mate/academy/rickandmorty/dto/external/Info.java

@@ -0,0 +1,6 @@
+package mate.academy.rickandmorty.dto.external;
+
+public record Info(Long count,
+        Long pages,
+        String next) {
+}

src/main/java/mate/academy/rickandmorty/dto/external/Result.java

@@ -0,0 +1,8 @@
+package mate.academy.rickandmorty.dto.external;
+
+public record Result(
+        String id,
+        String name,
+        String status,
+        String gender) {
+}

src/main/java/mate/academy/rickandmorty/dto/internal/CharacterDto.java

@@ -0,0 +1,10 @@
+package mate.academy.rickandmorty.dto.internal;
+
+public record CharacterDto(
+        Long id,
+        String externalId,
+        String name,
+        String status,
+        String gender
+){
+}

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

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

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

@@ -0,0 +1,17 @@
+package mate.academy.rickandmorty.mapper;
+
+import mate.academy.rickandmorty.config.MapperConfig;
+import mate.academy.rickandmorty.dto.external.Result;
+import mate.academy.rickandmorty.dto.internal.CharacterDto;
+import mate.academy.rickandmorty.model.Character;
+import org.mapstruct.Mapper;
+import org.mapstruct.Mapping;
+
+@Mapper(config = MapperConfig.class)
+public interface CharacterMapper {
+    CharacterDto toDto(Character character);
+
+    @Mapping(target = "id", ignore = true)
+    @Mapping(source = "id", target = "externalId")
+    Character toModel(Result result);
+}

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

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

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

@@ -0,0 +1,12 @@
+package mate.academy.rickandmorty.repository;
+
+import java.util.List;
+import mate.academy.rickandmorty.model.Character;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface CharacterRepository extends JpaRepository<Character, Long> {
+    List<Character> findCharactersByNameContainingIgnoreCase(String name, Pageable pageable);
+}

src/main/java/mate/academy/rickandmorty/service/CharacterClient.java

@@ -0,0 +1,59 @@
+package mate.academy.rickandmorty.service;
+
+import com.fasterxml.jackson.databind.ObjectMapper;
+import jakarta.annotation.PostConstruct;
+import java.io.IOException;
+import java.net.URI;
+import java.net.http.HttpClient;
+import java.net.http.HttpRequest;
+import java.net.http.HttpResponse;
+import java.util.ArrayList;
+import java.util.List;
+import lombok.AllArgsConstructor;
+import mate.academy.rickandmorty.dto.external.CharacterResponseDataDto;
+import mate.academy.rickandmorty.mapper.CharacterMapper;
+import mate.academy.rickandmorty.model.Character;
+import org.springframework.stereotype.Service;
+
+@AllArgsConstructor
+@Service
+public class CharacterClient {
+    private final ObjectMapper objectMapper;
+    private final CharacterService characterService;
+    private final CharacterMapper characterMapper;
+
+    @PostConstruct
+    public void getCharactersAndSaveToDatabase() {
+        if (characterService.count() > 0) {
+            return;
+        }
+        List<Character> characterList = getCharactersRates();
+        characterService.saveAll(characterList);
+    }
+
+    public List<Character> getCharactersRates() {
+        List<Character> characters = new ArrayList<>();
+        HttpClient httpClient = HttpClient.newHttpClient();
+        try {
+            String url = "https://rickandmortyapi.com/api/character";
+            CharacterResponseDataDto dataDto;
+            do {
+                HttpRequest httpRequest = HttpRequest.newBuilder()
+                        .GET()
+                        .uri(URI.create(url))
+                        .build();
+                HttpResponse<String> response = httpClient.send(httpRequest,
+                        HttpResponse.BodyHandlers.ofString());
+                dataDto = objectMapper
+                    .readValue(response.body(), CharacterResponseDataDto.class);
+                characters.addAll(dataDto.getResults().stream()
+                        .map(characterMapper::toModel)
+                        .toList());
+                url = dataDto.getInfo().next();
+            } while (url != null);
+            return characters;
+        } catch (IOException | InterruptedException e) {
+            throw new RuntimeException(e);
+        }
+    }
+}

src/main/java/mate/academy/rickandmorty/service/CharacterService.java

@@ -0,0 +1,16 @@
+package mate.academy.rickandmorty.service;
+
+import java.util.List;
+import mate.academy.rickandmorty.dto.internal.CharacterDto;
+import mate.academy.rickandmorty.model.Character;
+import org.springframework.data.domain.Pageable;
+
+public interface CharacterService {
+    void saveAll(List<Character> characterList);
+
+    Long count();
+
+    CharacterDto findByRandomId();
+
+    List<CharacterDto> findByName(String name, Pageable pageable);
+}

src/main/java/mate/academy/rickandmorty/service/CharacterServiceImpl.java

@@ -0,0 +1,45 @@
+package mate.academy.rickandmorty.service;
+
+import java.util.List;
+import java.util.Random;
+import lombok.RequiredArgsConstructor;
+import mate.academy.rickandmorty.dto.internal.CharacterDto;
+import mate.academy.rickandmorty.exception.DataProcessingException;
+import mate.academy.rickandmorty.mapper.CharacterMapper;
+import mate.academy.rickandmorty.model.Character;
+import mate.academy.rickandmorty.repository.CharacterRepository;
+import org.springframework.data.domain.Pageable;
+import org.springframework.stereotype.Service;
+
+@RequiredArgsConstructor
+@Service
+public class CharacterServiceImpl implements CharacterService {
+    private final CharacterRepository characterRepository;
+    private final CharacterMapper characterMapper;
+
+    @Override
+    public void saveAll(List<Character> characterList) {
+        characterRepository.saveAll(characterList);
+    }
+
+    @Override
+    public Long count() {
+        return characterRepository.count();
+    }
+
+    @Override
+    public CharacterDto findByRandomId() {
+        Random random = new Random();
+        Character character = characterRepository.findById(random.nextLong(826)).orElseThrow(
+                () -> new DataProcessingException("Cannot find character by random id"));
+        return characterMapper.toDto(character);
+    }
+
+    @Override
+    public List<CharacterDto> findByName(String name, Pageable pageable) {
+        return characterRepository.findCharactersByNameContainingIgnoreCase(name, pageable)
+                .stream()
+                .map(characterMapper::toDto)
+                .toList();
+    }
+}

src/main/resources/application.properties

@@ -1 +1,7 @@
-
+spring.datasource.url=jdbc:mysql://localhost:3306/character_test
+spring.datasource.username=root
+spring.datasource.password=1234
+spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
+spring.jpa.hibernate.ddl-auto=update
+spring.jpa.show-sql=true
+spring.jpa.open-in-view=false