feat: add and implement new response DTOs

Author: vianavitor-dev

src/main/java/com/vianavitor/simplelibrarygame/controller/BookReadHistoryController.java

@@ -1,6 +1,8 @@
 package com.vianavitor.simplelibrarygame.controller;
 
 import com.vianavitor.simplelibrarygame.dto.ApiResponse;
+import com.vianavitor.simplelibrarygame.dto.response.UsersBookReadHistoryResponse;
+import com.vianavitor.simplelibrarygame.model.Book;
 import com.vianavitor.simplelibrarygame.model.BookReadHistory;
 import com.vianavitor.simplelibrarygame.service.BookReadHistoryService;
 import jakarta.servlet.http.HttpServletRequest;
@@ -10,6 +12,7 @@
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
+import java.util.stream.Collectors;
 
 @RestController
 @RequestMapping("/api/read-history")
@@ -32,10 +35,27 @@ public ResponseEntity<ApiResponse<BookReadHistory>> getById(@PathVariable Long i
         return ResponseEntity.ok(response);
     }
 
+    private UsersBookReadHistoryResponse bookReadHistoryToDto(BookReadHistory history) {
+        Book book = history.getBook();
+
+        return new UsersBookReadHistoryResponse(
+                history.getId(),
+                new UsersBookReadHistoryResponse.BookInfo(
+                        book.getId(),
+                        book.getTitle()
+                ),
+                history.getLastUpdate(), history.getLastPageRead()
+        );
+    }
+
     @GetMapping("/student/{studentId}")
-    public ResponseEntity<ApiResponse<List<BookReadHistory>>> getByStudent(@PathVariable Long studentId, HttpServletRequest request) {
-        List<BookReadHistory> list = historyService.getByStudent(studentId);
-        ApiResponse<List<BookReadHistory>> response = ApiResponse.success(list, request.getRequestURI());
+    public ResponseEntity<ApiResponse<List<UsersBookReadHistoryResponse>>> getByStudent(@PathVariable Long studentId, HttpServletRequest request) {
+        List<UsersBookReadHistoryResponse> list = historyService.getByStudent(studentId)
+                .stream()
+                .map(this::bookReadHistoryToDto)
+                .toList();
+
+        ApiResponse<List<UsersBookReadHistoryResponse>> response = ApiResponse.success(list, request.getRequestURI());
         return ResponseEntity.ok(response);
     }
 
@@ -47,9 +67,12 @@ public ResponseEntity<ApiResponse<List<BookReadHistory>>> getByBook(@PathVariabl
     }
 
     @GetMapping("/student/{studentId}/last")
-    public ResponseEntity<ApiResponse<BookReadHistory>> getLastByStudent(@PathVariable Long studentId, HttpServletRequest request) {
-        BookReadHistory last = historyService.getByStudentTheLastOne(studentId);
-        ApiResponse<BookReadHistory> response = ApiResponse.success(last, request.getRequestURI());
+    public ResponseEntity<ApiResponse<UsersBookReadHistoryResponse>> getLastByStudent(@PathVariable Long studentId, HttpServletRequest request) {
+        UsersBookReadHistoryResponse last = this.bookReadHistoryToDto(
+                historyService.getByStudentTheLastOne(studentId)
+        );
+
+        ApiResponse<UsersBookReadHistoryResponse> response = ApiResponse.success(last, request.getRequestURI());
         return ResponseEntity.ok(response);
     }
 }

src/main/java/com/vianavitor/simplelibrarygame/controller/BookSummaryController.java

@@ -2,7 +2,10 @@
 
 import com.vianavitor.simplelibrarygame.dto.ApiResponse;
 import com.vianavitor.simplelibrarygame.dto.request.SubmitSummaryRequest;
+import com.vianavitor.simplelibrarygame.dto.response.BookSummaryResponse;
+import com.vianavitor.simplelibrarygame.model.Book;
 import com.vianavitor.simplelibrarygame.model.BookSummary;
+import com.vianavitor.simplelibrarygame.model.Student;
 import com.vianavitor.simplelibrarygame.service.BookSummaryService;
 import jakarta.servlet.http.HttpServletRequest;
 import jakarta.validation.Valid;
@@ -29,17 +32,41 @@ public ResponseEntity<ApiResponse<Void>> submitSummary(@Valid @RequestBody Submi
                 .body(ApiResponse.success(null, "Summary submitted", req.getRequestURI()));
     }
 
+    private BookSummaryResponse bookSummaryToDto(BookSummary summary) {
+        Student student = summary.getStudent();
+        Book book = summary.getBook();
+
+        return new BookSummaryResponse(
+                summary.getId(), summary.getText(),
+                new BookSummaryResponse.StudentInfo(
+                        student.getId(), student.getName()
+                ),
+                new BookSummaryResponse.BookInfo(
+                        book.getId(), book.getTitle()
+                ),
+                summary.getWrittenAt()
+        );
+    }
+
     @GetMapping("/student/{studentId}")
-    public ResponseEntity<ApiResponse<List<BookSummary>>> getByStudent(@PathVariable Long studentId, HttpServletRequest request) {
-        List<BookSummary> summaries = summaryService.getByStudent(studentId);
-        ApiResponse<List<BookSummary>> response = ApiResponse.success(summaries, request.getRequestURI());
+    public ResponseEntity<ApiResponse<List<BookSummaryResponse>>> getByStudent(@PathVariable Long studentId, HttpServletRequest request) {
+        List<BookSummaryResponse> summaries = summaryService.getByStudent(studentId)
+                .stream()
+                .map(this::bookSummaryToDto)
+                .toList();
+
+        ApiResponse<List<BookSummaryResponse>> response = ApiResponse.success(summaries, request.getRequestURI());
         return ResponseEntity.ok(response);
     }
 
     @GetMapping("/book/{bookId}")
-    public ResponseEntity<ApiResponse<List<BookSummary>>> getByBook(@PathVariable Long bookId, HttpServletRequest request) {
-        List<BookSummary> summaries = summaryService.getByBook(bookId);
-        ApiResponse<List<BookSummary>> response = ApiResponse.success(summaries, request.getRequestURI());
+    public ResponseEntity<ApiResponse<List<BookSummaryResponse>>> getByBook(@PathVariable Long bookId, HttpServletRequest request) {
+        List<BookSummaryResponse> summaries = summaryService.getByBook(bookId)
+                .stream()
+                .map(this::bookSummaryToDto)
+                .toList();
+
+        ApiResponse<List<BookSummaryResponse>> response = ApiResponse.success(summaries, request.getRequestURI());
         return ResponseEntity.ok(response);
     }
 }

src/main/java/com/vianavitor/simplelibrarygame/dto/response/BookSummaryResponse.java

@@ -0,0 +1,23 @@
+package com.vianavitor.simplelibrarygame.dto.response;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+import java.time.LocalDate;
+
+public record BookSummaryResponse(
+        Long id,
+        String text,
+        @JsonProperty("written_by") StudentInfo writtenBy,
+        BookInfo book,
+        @JsonProperty("written_at") LocalDate writtenAt
+) {
+    public record StudentInfo(
+            Long id,
+            String name
+    ) {}
+
+    public record BookInfo(
+            Long id,
+            String title
+    ) {}
+}

src/main/java/com/vianavitor/simplelibrarygame/dto/response/UsersBookReadHistoryResponse.java

@@ -0,0 +1,18 @@
+package com.vianavitor.simplelibrarygame.dto.response;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import jakarta.annotation.Nullable;
+
+import java.time.LocalDate;
+
+public record UsersBookReadHistoryResponse(
+        Long id,
+        BookInfo book,
+        @JsonProperty("last_update") @Nullable LocalDate lastUpdate,
+        @JsonProperty("last_page_read") int lastPageRead
+) {
+    public record BookInfo(
+            Long id,
+            String title
+    ) {}
+}

src/main/java/com/vianavitor/simplelibrarygame/model/Book.java

@@ -1,5 +1,6 @@
 package com.vianavitor.simplelibrarygame.model;
 
+import com.fasterxml.jackson.annotation.JsonIgnore;
 import com.vianavitor.simplelibrarygame.model.utils.fields.ReadingLevel;
 import jakarta.annotation.Nullable;
 import jakarta.persistence.*;
@@ -48,6 +49,7 @@ public class Book {
     private double ratingValue;
 
     @Column(columnDefinition = "int not null default 0")
+    @JsonIgnore
     private int ratingCount;
 
     @Column(columnDefinition = "int not null default 1")

src/main/java/com/vianavitor/simplelibrarygame/model/Group.java

@@ -1,5 +1,6 @@
 package com.vianavitor.simplelibrarygame.model;
 
+import com.fasterxml.jackson.annotation.JsonIgnore;
 import jakarta.persistence.*;
 
 @Entity
@@ -12,6 +13,7 @@ public class Group {
 
     @ManyToOne
     @JoinColumn(name = "user_id")
+    @JsonIgnore
     private Student student;
 
     public Long getId() {