Create Rick & Morty API

pom.xml

@@ -19,13 +19,34 @@
 		<maven.checkstyle.plugin.configLocation>
 			https://raw.githubusercontent.com/mate-academy/style-guides/master/java/checkstyle.xml
 		</maven.checkstyle.plugin.configLocation>
+		<mysql.version>8.0.33</mysql.version>
+		<openapi.version>2.0.3</openapi.version>
+		<mapstruct.version>1.5.5.Final</mapstruct.version>
+		<lombok.mapstruct.binding.version>0.2.0</lombok.mapstruct.binding.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.springdoc</groupId>
+			<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+			<version>${openapi.version}</version>
+		</dependency>
+		<dependency>
+			<groupId>org.projectlombok</groupId>
+			<artifactId>lombok</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.mapstruct</groupId>
+			<artifactId>mapstruct</artifactId>
+			<version>${mapstruct.version}</version>
+		</dependency>
 		<dependency>
 			<groupId>org.springframework.boot</groupId>
 			<artifactId>spring-boot-starter-test</artifactId>
@@ -36,7 +57,11 @@
 			<groupId>org.springframework.boot</groupId>
 			<artifactId>spring-boot-starter-data-jpa</artifactId>
 		</dependency>
-
+		<dependency>
+			<groupId>mysql</groupId>
+			<artifactId>mysql-connector-java</artifactId>
+			<version>${mysql.version}</version>
+		</dependency>
 		<dependency>
 			<groupId>com.h2database</groupId>
 			<artifactId>h2</artifactId>
@@ -66,6 +91,32 @@
 					<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>

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

@@ -0,0 +1,61 @@
+package mate.academy.rickandmorty.config;
+
+import com.fasterxml.jackson.core.type.TypeReference;
+import com.fasterxml.jackson.databind.ObjectMapper;
+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.RequiredArgsConstructor;
+import mate.academy.rickandmorty.dto.external.CharacterResponseDataDto;
+import mate.academy.rickandmorty.dto.external.ExternalCharacterDto;
+import mate.academy.rickandmorty.service.CharacterService;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.boot.context.event.ApplicationReadyEvent;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.context.event.EventListener;
+
+@RequiredArgsConstructor
+@Configuration
+public class DataFetchConfig {
+    private final CharacterService service;
+    private final ObjectMapper objectMapper;
+    @Value("${rickandmorty.api.url}")
+    private String characterUrl;
+
+    @EventListener(ApplicationReadyEvent.class)
+    public void fetchData() {
+        List<ExternalCharacterDto> characters = new ArrayList<>();
+        CharacterResponseDataDto response = loadData(characterUrl);
+        do {
+            characters.addAll(response.results());
+            response = loadData(response.info().next());
+        } while (response.info().next() != null);
+        service.saveAll(characters);
+    }
+
+    private CharacterResponseDataDto loadData(String url) {
+        HttpClient httpClient = HttpClient.newHttpClient();
+
+        HttpRequest request = HttpRequest.newBuilder()
+                .GET()
+                .uri(URI.create(url))
+                .build();
+
+        try {
+            HttpResponse<byte[]> response = httpClient.send(
+                    request,
+                    HttpResponse.BodyHandlers.ofByteArray()
+            );
+            return objectMapper.readValue(
+                    response.body(), new TypeReference<>() {
+                    }
+            );
+        } catch (IOException | InterruptedException e) {
+            throw new RuntimeException(e);
+        }
+    }
+}

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

@@ -0,0 +1,13 @@
+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,39 @@
+package mate.academy.rickandmorty.controller;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import java.util.List;
+import lombok.RequiredArgsConstructor;
+import mate.academy.rickandmorty.dto.CharacterResponseDto;
+import mate.academy.rickandmorty.service.CharacterService;
+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 API", description = "Look at and search for characters")
+@RequiredArgsConstructor
+@RestController
+@RequestMapping(value = "/characters")
+public class CharacterController {
+    private final CharacterService characterService;
+
+    @Operation(
+            summary = "Get random character",
+            description = "The request randomly generates a wiki about one"
+                          + " character in the universe the animated series Rick & Morty"
+    )
+    @GetMapping("/random")
+    public CharacterResponseDto getRandom() {
+        return characterService.getRandom();
+    }
+
+    @Operation(
+            summary = "Search character",
+            description = "Search for characters based on the name"
+    )
+    @GetMapping("/search")
+    public List<CharacterResponseDto> search(@RequestParam String name) {
+        return characterService.search(name);
+    }
+}

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

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

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

@@ -0,0 +1,9 @@
+package mate.academy.rickandmorty.dto.external;
+
+import java.util.List;
+
+public record CharacterResponseDataDto(
+        ExternalCharacterInfoDto info,
+        List<ExternalCharacterDto> results
+) {
+}

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

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

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

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

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.CharacterResponseDto;
+import mate.academy.rickandmorty.dto.external.ExternalCharacterDto;
+import mate.academy.rickandmorty.model.Character;
+import org.mapstruct.Mapper;
+import org.mapstruct.Mapping;
+
+@Mapper(config = MapperConfig.class)
+public interface CharacterMapper {
+    CharacterResponseDto toDto(Character character);
+
+    @Mapping(target = "externalId", source = "id")
+    @Mapping(target = "id", ignore = true)
+    Character toModel(ExternalCharacterDto characterDto);
+}

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

@@ -0,0 +1,22 @@
+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.Data;
+
+@Data
+@Entity
+@Table(name = "characters")
+public class Character {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.AUTO)
+    private Long id;
+    private Long externalId;
+    private String name;
+    private String status;
+    private String gender;
+}

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

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

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

@@ -0,0 +1,14 @@
+package mate.academy.rickandmorty.service;
+
+import java.util.List;
+import mate.academy.rickandmorty.dto.CharacterResponseDto;
+import mate.academy.rickandmorty.dto.external.ExternalCharacterDto;
+import mate.academy.rickandmorty.model.Character;
+
+public interface CharacterService {
+    CharacterResponseDto getRandom();
+
+    List<CharacterResponseDto> search(String name);
+
+    List<Character> saveAll(List<ExternalCharacterDto> externalCharacterDtos);
+}

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

@@ -0,0 +1,48 @@
+package mate.academy.rickandmorty.service.impl;
+
+import java.util.List;
+import java.util.Random;
+import lombok.RequiredArgsConstructor;
+import mate.academy.rickandmorty.dto.CharacterResponseDto;
+import mate.academy.rickandmorty.dto.external.ExternalCharacterDto;
+import mate.academy.rickandmorty.mapper.CharacterMapper;
+import mate.academy.rickandmorty.model.Character;
+import mate.academy.rickandmorty.repository.CharacterRepository;
+import mate.academy.rickandmorty.service.CharacterService;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+@RequiredArgsConstructor
+@Service
+public class CharacterServiceImpl implements CharacterService {
+    private static final long minId = 1L;
+    private final CharacterRepository characterRepository;
+    private final CharacterMapper characterMapper;
+
+    @Override
+    public CharacterResponseDto getRandom() {
+        long numberOfCharacters = characterRepository.count();
+        Random random = new Random();
+        long randomId = random.nextLong(numberOfCharacters + minId);
+        return characterRepository.findById(randomId)
+                .map(characterMapper::toDto)
+                .orElseThrow();
+    }
+
+    @Override
+    public List<CharacterResponseDto> search(String name) {
+        return characterRepository.findCharacterByNameContaining(name)
+                .stream()
+                .map(characterMapper::toDto)
+                .toList();
+    }
+
+    @Transactional
+    @Override
+    public List<Character> saveAll(List<ExternalCharacterDto> externalCharacterDtos) {
+        List<Character> characters = externalCharacterDtos.stream()
+                .map(characterMapper::toModel)
+                .toList();
+        return characterRepository.saveAll(characters);
+    }
+}

src/main/resources/application.properties

@@ -1 +1,11 @@
+spring.datasource.url=jdbc:mysql://localhost:3306/rick_and_morty
+spring.datasource.username=test
+spring.datasource.password=StrongSecret1234
+spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
 
+spring.jpa.hibernate.ddl-auto=create-drop
+spring.jpa.open-in-view=false
+
+server.servlet.context-path=/api
+
+rickandmorty.api.url=https://rickandmortyapi.com/api/character

src/test/java/mate/academy/rickandmorty/ApplicationTests.java

@@ -5,9 +5,7 @@
 
 @SpringBootTest
 class ApplicationTests {
-
-	@Test
-	void contextLoads() {
-	}
-
+    @Test
+    void contextLoads() {
+    }
 }

src/test/resources/application.properties

@@ -3,3 +3,10 @@ spring.datasource.driverClassName=org.h2.Driver
 spring.datasource.username=sa
 spring.datasource.password=password
 spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
+
+spring.jpa.hibernate.ddl-auto=create-drop
+spring.jpa.open-in-view=false
+
+server.servlet.context-path=/api
+
+rickandmorty.api.url=https://rickandmortyapi.com/api/character