swagger, pagination, sorting added

pom.xml

@@ -92,6 +92,16 @@
             <artifactId>hibernate-validator</artifactId>
             <version>7.0.5.Final</version>
         </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-validation</artifactId>
+            <version>3.3.3</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+            <version>2.6.0</version>
+        </dependency>
     </dependencies>
 
     <build>

src/main/java/project/bookstore/controller/BookController.java

@@ -1,8 +1,11 @@
 package project.bookstore.controller;
 
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.validation.Valid;
 import java.util.List;
 import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Pageable;
 import org.springframework.web.bind.annotation.DeleteMapping;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PathVariable;
@@ -17,6 +20,7 @@
 import project.bookstore.mapper.BookMapper;
 import project.bookstore.service.BookService;
 
+@Tag(name = "Book controller", description = "endpoints for managing library")
 @RequiredArgsConstructor
 @RestController
 @RequestMapping("/books")
@@ -25,21 +29,31 @@ public class BookController {
     private final BookMapper bookMapper;
 
     @GetMapping
-    public List<BookDto> getAll() {
-        return bookService.findAll();
+    @Operation(
+            summary = "Get all books",
+            description = "Get all books from db")
+    public List<BookDto> getAll(Pageable pageable) {
+        return bookService.findAll(pageable);
     }
 
     @GetMapping("/{id}")
+    @Operation(
+            summary = "Get book by id",
+            description = "Get book by id from db")
     public BookDto getBookById(@PathVariable Long id) {
         return bookService.getBookById(id);
     }
 
     @PostMapping
+    @Operation(
+            summary = "Create new book",
+            description = "Create new book and add to db")
     public BookDto createBook(@RequestBody @Valid CreateBookRequestDto requestDto) {
         return bookMapper.toDto(bookService.save(requestDto));
     }
 
     @PutMapping("/{id}")
+    @Operation(summary = "Update book's info", description = "Update book's info")
     public BookDto updateBook(
             @RequestBody @Valid CreateBookRequestDto requestDto,
             @PathVariable Long id
@@ -48,11 +62,15 @@ public BookDto updateBook(
     }
 
     @DeleteMapping("/{id}")
+    @Operation(summary = "Delete book", description = "Delete book from db")
     public void deleteBook(@PathVariable Long id) {
         bookService.deleteBookById(id);
     }
 
     @GetMapping("/search")
+    @Operation(
+            summary = "Search books by parameters",
+            description = "Search books by parameters: title, author and price")
     public List<BookDto> searchBook(BookSearchParameters searchParameters) {
         return bookService.search(searchParameters);
     }

src/main/java/project/bookstore/repository/BookRepository.java

@@ -2,7 +2,11 @@
 
 import org.springframework.data.jpa.repository.JpaRepository;
 import org.springframework.data.jpa.repository.JpaSpecificationExecutor;
+import org.springframework.data.repository.PagingAndSortingRepository;
 import project.bookstore.model.Book;
 
-public interface BookRepository extends JpaRepository<Book, Long>, JpaSpecificationExecutor<Book> {
+public interface BookRepository extends
+        JpaRepository<Book, Long>,
+        JpaSpecificationExecutor<Book>,
+        PagingAndSortingRepository<Book, Long> {
 }

src/main/java/project/bookstore/service/BookService.java

@@ -1,6 +1,7 @@
 package project.bookstore.service;
 
 import java.util.List;
+import org.springframework.data.domain.Pageable;
 import project.bookstore.dto.BookDto;
 import project.bookstore.dto.BookSearchParameters;
 import project.bookstore.dto.CreateBookRequestDto;
@@ -9,7 +10,7 @@
 public interface BookService {
     Book save(CreateBookRequestDto requestBookDto);
 
-    List<BookDto> findAll();
+    List<BookDto> findAll(Pageable pageable);
 
     BookDto getBookById(Long id);
 

src/main/java/project/bookstore/service/impl/BookServiceImpl.java

@@ -2,6 +2,7 @@
 
 import java.util.List;
 import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Pageable;
 import org.springframework.data.jpa.domain.Specification;
 import org.springframework.stereotype.Service;
 import project.bookstore.dto.BookDto;
@@ -28,8 +29,8 @@ public Book save(CreateBookRequestDto requestBookDto) {
     }
 
     @Override
-    public List<BookDto> findAll() {
-        return bookRepository.findAll().stream()
+    public List<BookDto> findAll(Pageable pageable) {
+        return bookRepository.findAll(pageable).stream()
                 .map(bookMapper::toDto)
                 .toList();
     }