feat: PagedResponse 구현 및 레슨 수강 도메인에 적용 (#85)

* feat: PagedResponse 구현 및 레슨 수강 도메인에 적용

* feat: PageResponse 응답 Wrapper 적용

Author: Ji-minhyeok

src/main/java/com/threestar/trainus/domain/lesson/student/controller/StudentLessonController.java

@@ -13,12 +13,15 @@
 import com.threestar.trainus.domain.lesson.student.dto.LessonApplicationResponseDto;
 import com.threestar.trainus.domain.lesson.student.dto.LessonDetailResponseDto;
 import com.threestar.trainus.domain.lesson.student.dto.LessonSearchListResponseDto;
+import com.threestar.trainus.domain.lesson.student.dto.LessonSearchListWrapperDto;
 import com.threestar.trainus.domain.lesson.student.dto.LessonSimpleResponseDto;
 import com.threestar.trainus.domain.lesson.student.dto.MyLessonApplicationListResponseDto;
+import com.threestar.trainus.domain.lesson.student.dto.MyLessonApplicationListWrapperDto;
 import com.threestar.trainus.domain.lesson.student.service.StudentLessonService;
 import com.threestar.trainus.global.exception.domain.ErrorCode;
 import com.threestar.trainus.global.exception.handler.BusinessException;
 import com.threestar.trainus.global.unit.BaseResponse;
+import com.threestar.trainus.global.unit.PagedResponse;
 
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
@@ -36,7 +39,7 @@ public class StudentLessonController {
 
 	@GetMapping
 	@Operation(summary = "레슨 검색 api", description = "category(필수, Default: \"ALL\") / search(선택) / 그외 법정동 선택 필수")
-	public ResponseEntity<BaseResponse<LessonSearchListResponseDto>> searchLessons(
+	public ResponseEntity<PagedResponse<LessonSearchListWrapperDto>> searchLessons(
 		@RequestParam(defaultValue = "1") @Min(value = 1, message = "페이지는 1 이상이어야 합니다.")
 		@Max(value = 1000, message = "페이지는 1000 이하여야 합니다.") int page,
 		@RequestParam(defaultValue = "5") @Min(value = 1, message = "limit는 1 이상이어야 합니다.")
@@ -47,9 +50,13 @@ public ResponseEntity<BaseResponse<LessonSearchListResponseDto>> searchLessons(
 		@RequestParam String district,
 		@RequestParam String dong
 	) {
-		LessonSearchListResponseDto lessonList = studentLessonService.searchLessons(page, limit, category, search, city,
-			district, dong);
-		return BaseResponse.ok("레슨 검색 조회 완료.", lessonList, HttpStatus.OK);
+
+		LessonSearchListResponseDto serviceResponse = studentLessonService.searchLessons(
+			page, limit, category, search, city, district, dong
+		);
+		LessonSearchListWrapperDto response = new LessonSearchListWrapperDto(serviceResponse.lessons());
+
+		return PagedResponse.ok("레슨 검색 조회 완료.", response, serviceResponse.count(), HttpStatus.OK);
 	}
 
 	@GetMapping("/{lessonId}")
@@ -91,7 +98,7 @@ public ResponseEntity<BaseResponse<Void>> deleteLessonApplication(
 
 	@GetMapping("/my-applications")
 	@Operation(summary = "나의 레슨 신청 목록 조회", description = "현재 로그인한 사용자의 레슨 신청 목록을 조회합니다.")
-	public ResponseEntity<BaseResponse<MyLessonApplicationListResponseDto>> getMyLessonApplications(
+	public ResponseEntity<PagedResponse<MyLessonApplicationListWrapperDto>> getMyLessonApplications(
 		@RequestParam(defaultValue = "1") @Min(value = 1, message = "페이지는 1 이상이어야 합니다.")
 		@Max(value = 1000, message = "페이지는 1000 이하여야 합니다.") int page,
 		@RequestParam(defaultValue = "5") @Min(value = 1, message = "limit는 1 이상이어야 합니다.")
@@ -104,9 +111,12 @@ public ResponseEntity<BaseResponse<MyLessonApplicationListResponseDto>> getMyLes
 			throw new BusinessException(ErrorCode.AUTHENTICATION_REQUIRED);
 		}
 
-		MyLessonApplicationListResponseDto response = studentLessonService.getMyLessonApplications(userId, page, limit,
-			status);
-		return BaseResponse.ok("나의 레슨 신청 목록 조회 완료.", response, HttpStatus.OK);
+		MyLessonApplicationListResponseDto serviceResponse = studentLessonService.getMyLessonApplications(userId, page,
+			limit, status);
+		MyLessonApplicationListWrapperDto response = new MyLessonApplicationListWrapperDto(
+			serviceResponse.lessonApplications());
+
+		return PagedResponse.ok("나의 레슨 신청 목록 조회 완료.", response, serviceResponse.count(), HttpStatus.OK);
 	}
 
 	@GetMapping("/summary/{lessonId}")

src/main/java/com/threestar/trainus/domain/lesson/student/dto/LessonSearchListWrapperDto.java

@@ -0,0 +1,8 @@
+package com.threestar.trainus.domain.lesson.student.dto;
+
+import java.util.List;
+
+public record LessonSearchListWrapperDto(
+	List<LessonSearchResponseDto> lessons
+) {
+}

src/main/java/com/threestar/trainus/domain/lesson/student/dto/MyLessonApplicationListWrapperDto.java

@@ -0,0 +1,8 @@
+package com.threestar.trainus.domain.lesson.student.dto;
+
+import java.util.List;
+
+public record MyLessonApplicationListWrapperDto(
+	List<MyLessonApplicationResponseDto> lessonApplications
+){
+}

src/main/java/com/threestar/trainus/global/unit/PagedResponse.java

@@ -0,0 +1,31 @@
+package com.threestar.trainus.global.unit;
+
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+
+@Getter
+@Builder
+@AllArgsConstructor
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class PagedResponse<T> {
+	private final int status;
+	private final String message;
+	private final T data;
+	private final int count;
+
+	public static <T> ResponseEntity<PagedResponse<T>> ok(String message, T data, int count, HttpStatus status) {
+		return ResponseEntity.status(status)
+			.body(PagedResponse.<T>builder()
+				.status(status.value())
+				.message(message)
+				.data(data)
+				.count(count)
+				.build());
+	}
+}