Implemented random character generator, and ability to search by name

pom.xml

@@ -25,22 +25,57 @@
 			<groupId>org.springframework.boot</groupId>
 			<artifactId>spring-boot-starter</artifactId>
 		</dependency>
-
 		<dependency>
 			<groupId>org.springframework.boot</groupId>
 			<artifactId>spring-boot-starter-test</artifactId>
 			<scope>test</scope>
 		</dependency>
-
 		<dependency>
 			<groupId>org.springframework.boot</groupId>
 			<artifactId>spring-boot-starter-data-jpa</artifactId>
 		</dependency>
-
 		<dependency>
 			<groupId>com.h2database</groupId>
 			<artifactId>h2</artifactId>
 		</dependency>
+		<dependency>
+			<groupId>com.mysql</groupId>
+			<artifactId>mysql-connector-j</artifactId>
+			<scope>runtime</scope>
+		</dependency>
+		<dependency>
+			<groupId>org.projectlombok</groupId>
+			<artifactId>lombok</artifactId>
+			<optional>true</optional>
+		</dependency>
+		<dependency>
+			<groupId>com.fasterxml.jackson.core</groupId>
+			<artifactId>jackson-databind</artifactId>
+			<version>2.17.0</version>
+		</dependency>
+		<dependency>
+			<groupId>org.springdoc</groupId>
+			<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+			<version>2.4.0</version>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-web</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-validation</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>net.adrianoluis</groupId>
+			<artifactId>rickandmortyapi-java</artifactId>
+			<version>1.1.1</version>
+		</dependency>
+		<dependency>
+			<groupId>org.mapstruct</groupId>
+			<artifactId>mapstruct</artifactId>
+			<version>1.5.5.Final</version>
+		</dependency>
 	</dependencies>
 
 	<build>
@@ -66,9 +101,46 @@
 					<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>
+				<version>3.11.0</version>
+				<configuration>
+					<source>11</source>
+					<target>11</target>
+					<annotationProcessorPaths>
+						<path>
+							<groupId>org.projectlombok</groupId>
+							<artifactId>lombok</artifactId>
+							<version>1.18.30</version>
+						</path>
+						<path>
+							<groupId>org.mapstruct</groupId>
+							<artifactId>mapstruct-processor</artifactId>
+							<version>1.5.5.Final</version>
+						</path>
+						<path>
+							<groupId>org.projectlombok</groupId>
+							<artifactId>lombok-mapstruct-binding</artifactId>
+							<version>0.2.0</version>
+						</path>
+					</annotationProcessorPaths>
 				</configuration>
 			</plugin>
 		</plugins>
 	</build>
 
+	<repositories>
+		<repository>
+			<id>rickandmortyapi-java-mvn-repo</id>
+			<url>https://raw.githubusercontent.com/adrianoluis/rickandmortyapi-java/mvn-repo/</url>
+			<releases>
+				<enabled>true</enabled>
+				<updatePolicy>never</updatePolicy>
+			</releases>
+		</repository>
+	</repositories>
 </project>

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.internal.CartoonCharacterDto;
+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 = "Rick and Mort API",
+        description = "Endpoints for random character or finding a "
+                + "character that contains specific name")
+@RestController
+@RequiredArgsConstructor
+@RequestMapping(value = "/api")
+public class CharacterController {
+
+    private final CharacterService characterService;
+
+    @GetMapping("/random")
+    @Operation(
+            summary = "Generate random character",
+            description = "Generates a wiki of a random character from Rick and Morty universe")
+    public CartoonCharacterDto getRandomCharacter() {
+        return characterService.getRandomCharacter();
+    }
+
+    @GetMapping("/search")
+    @Operation(
+            summary = "Search by name",
+            description = "Returns list of characters containing the search name")
+    public List<CartoonCharacterDto> searchByName(@RequestParam String name) {
+        return characterService.searchByName(name);
+    }
+}

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

@@ -0,0 +1,20 @@
+package mate.academy.rickandmorty.dto.external;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+
+public record CharacterDto(
+        @JsonProperty("id")
+        Long externalId,
+        String name,
+        String status,
+        String species,
+        String type,
+        String gender,
+        String image,
+        String url,
+        String created,
+        OriginDto origin,
+        LocationDto location,
+        List<String> episode
+) {}

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

@@ -0,0 +1,11 @@
+package mate.academy.rickandmorty.dto.external;
+
+import lombok.Data;
+
+@Data
+public class CharacterMetadataDto {
+    private int count;
+    private int pages;
+    private String next;
+    private String prev;
+}

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

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

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

@@ -0,0 +1,6 @@
+package mate.academy.rickandmorty.dto.external;
+
+public record LocationDto(
+        String name,
+        String url
+) {}

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

@@ -0,0 +1,6 @@
+package mate.academy.rickandmorty.dto.external;
+
+public record OriginDto(
+        String name,
+        String url
+) {}

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

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

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

@@ -0,0 +1,15 @@
+package mate.academy.rickandmorty.mapper;
+
+import mate.academy.rickandmorty.config.MapperConfig;
+import mate.academy.rickandmorty.dto.external.CharacterDto;
+import mate.academy.rickandmorty.dto.internal.CartoonCharacterDto;
+import mate.academy.rickandmorty.model.Character;
+import org.mapstruct.Mapper;
+
+@Mapper(config = MapperConfig.class)
+public interface CharacterMapper {
+
+    CartoonCharacterDto toDto(Character character);
+
+    Character toModel(CharacterDto characterDto);
+}

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

@@ -0,0 +1,45 @@
+package mate.academy.rickandmorty.model;
+
+import jakarta.persistence.CascadeType;
+import jakarta.persistence.ElementCollection;
+import jakarta.persistence.Entity;
+import jakarta.persistence.FetchType;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.JoinColumn;
+import jakarta.persistence.ManyToOne;
+import jakarta.persistence.Table;
+import java.util.List;
+import lombok.Data;
+
+@Entity
+@Data
+@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 species;
+    private String type;
+    private String gender;
+    private String image;
+    private String url;
+    private String created;
+
+    @ManyToOne(cascade = CascadeType.PERSIST)
+    @JoinColumn(name = "origins_id")
+    private Origin origin;
+
+    @ManyToOne(cascade = CascadeType.PERSIST)
+    @JoinColumn(name = "locations_id")
+    private Location location;
+
+    @ElementCollection(fetch = FetchType.EAGER)
+    private List<String> episode;
+}

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

@@ -0,0 +1,21 @@
+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;
+
+@Entity
+@Data
+@Table(name = "locations")
+public class Location {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    private String name;
+    private String url;
+}

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

@@ -0,0 +1,21 @@
+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;
+
+@Entity
+@Data
+@Table(name = "origins")
+public class Origin {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    private String name;
+    private String url;
+}

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

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