feat: 콘텐츠 관리 - 콘텐츠 조회 구현

build.gradle

@@ -30,6 +30,10 @@ dependencies {
     implementation 'org.flywaydb:flyway-database-postgresql'
     implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.17'
     implementation 'org.mapstruct:mapstruct:1.6.3'
+    implementation 'com.querydsl:querydsl-jpa:5.1.0:jakarta'
+    annotationProcessor 'com.querydsl:querydsl-apt:5.1.0:jakarta'
+    annotationProcessor 'jakarta.annotation:jakarta.annotation-api'
+    annotationProcessor 'jakarta.persistence:jakarta.persistence-api'
     // AWS SDK (S3)
     implementation platform('software.amazon.awssdk:bom:2.46.7')
     implementation 'software.amazon.awssdk:s3'

src/main/java/com/codeit/team5/mopl/config/QueryDslConfig.java

@@ -0,0 +1,19 @@
+package com.codeit.team5.mopl.config;
+
+import com.querydsl.jpa.impl.JPAQueryFactory;
+import jakarta.persistence.EntityManager;
+import jakarta.persistence.PersistenceContext;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+@Configuration
+public class QueryDslConfig {
+
+    @PersistenceContext
+    private EntityManager entityManager;
+
+    @Bean
+    public JPAQueryFactory jpaQueryFactory() {
+        return new JPAQueryFactory(entityManager);
+    }
+}

src/main/java/com/codeit/team5/mopl/config/WebConfig.java

@@ -0,0 +1,30 @@
+package com.codeit.team5.mopl.config;
+
+import com.codeit.team5.mopl.content.entity.ContentSortByType;
+import com.codeit.team5.mopl.content.entity.ContentType;
+import com.codeit.team5.mopl.global.exception.InvalidSortDirectionException;
+import com.codeit.team5.mopl.watcher.constant.SortByType;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.data.domain.Sort;
+import org.springframework.format.FormatterRegistry;
+import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
+
+@Configuration
+public class WebConfig implements WebMvcConfigurer {
+
+    @Override
+    public void addFormatters(FormatterRegistry registry) {
+        registry.addConverter(String.class, Sort.Direction.class, value -> {
+            if (value.equalsIgnoreCase("ASCENDING") || value.equalsIgnoreCase("ASC")) {
+                return Sort.Direction.ASC;
+            }
+            if (value.equalsIgnoreCase("DESCENDING") || value.equalsIgnoreCase("DESC")) {
+                return Sort.Direction.DESC;
+            }
+            throw new InvalidSortDirectionException(value);
+        });
+        registry.addConverter(String.class, ContentSortByType.class, ContentSortByType::from);
+        registry.addConverter(String.class, ContentType.class, ContentType::from);
+        registry.addConverter(String.class, SortByType.class, SortByType::from);
+    }
+}

src/main/java/com/codeit/team5/mopl/content/controller/ContentController.java

@@ -1,11 +1,13 @@
 package com.codeit.team5.mopl.content.controller;
 
+import com.codeit.team5.mopl.binarycontent.support.MultipartFiles;
 import com.codeit.team5.mopl.content.controller.api.ContentApi;
 import com.codeit.team5.mopl.content.dto.request.ContentCreateRequest;
+import com.codeit.team5.mopl.content.dto.request.ContentCursorRequest;
 import com.codeit.team5.mopl.content.dto.request.ContentUpdateRequest;
 import com.codeit.team5.mopl.content.dto.response.ContentResponse;
 import com.codeit.team5.mopl.content.service.ContentService;
-import com.codeit.team5.mopl.binarycontent.support.MultipartFiles;
+import com.codeit.team5.mopl.global.dto.CursorResponse;
 import jakarta.validation.Valid;
 import java.util.UUID;
 import lombok.RequiredArgsConstructor;
@@ -14,6 +16,7 @@
 import org.springframework.http.MediaType;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PatchMapping;
 import org.springframework.web.bind.annotation.PathVariable;
 import org.springframework.web.bind.annotation.PostMapping;
@@ -53,6 +56,22 @@ public ResponseEntity<ContentResponse> patchContent(
         return ResponseEntity.ok(response);
     }
 
+    @Override
+    @GetMapping("/{contentId}")
+    public ResponseEntity<ContentResponse> getContent(@PathVariable UUID contentId) {
+        log.info("Content Get request: GET /api/contents/{}", contentId);
+        ContentResponse response = contentService.findById(contentId);
+        return ResponseEntity.ok(response);
+    }
+
+    @Override
+    @GetMapping
+    public ResponseEntity<CursorResponse<ContentResponse>> getContents(@Valid ContentCursorRequest request) {
+        log.info("Content List request: GET /api/contents");
+        CursorResponse<ContentResponse> response = contentService.findContents(request);
+        return ResponseEntity.ok(response);
+    }
+
     @Override
     @DeleteMapping("/{contentId}")
     public ResponseEntity<Void> deleteContent(@PathVariable UUID contentId) {

src/main/java/com/codeit/team5/mopl/content/controller/api/ContentApi.java

@@ -1,18 +1,25 @@
 package com.codeit.team5.mopl.content.controller.api;
 
 import com.codeit.team5.mopl.content.dto.request.ContentCreateRequest;
+import com.codeit.team5.mopl.content.dto.request.ContentCursorRequest;
 import com.codeit.team5.mopl.content.dto.request.ContentUpdateRequest;
 import com.codeit.team5.mopl.content.dto.response.ContentResponse;
+import com.codeit.team5.mopl.global.dto.CursorResponse;
 import com.codeit.team5.mopl.global.dto.suggestion.ErrorResponseSuggestion;
+import com.codeit.team5.mopl.content.entity.ContentSortByType;
+import com.codeit.team5.mopl.content.entity.ContentType;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.media.ArraySchema;
 import io.swagger.v3.oas.annotations.media.Content;
 import io.swagger.v3.oas.annotations.media.Encoding;
 import io.swagger.v3.oas.annotations.media.Schema;
 import io.swagger.v3.oas.annotations.parameters.RequestBody;
 import io.swagger.v3.oas.annotations.responses.ApiResponse;
 import io.swagger.v3.oas.annotations.responses.ApiResponses;
 import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.data.domain.Sort;
 import java.util.UUID;
 import org.springframework.http.MediaType;
 import org.springframework.http.ResponseEntity;
@@ -55,13 +62,14 @@ ResponseEntity<ContentResponse> postContent(
 
     @Schema(name = "ContentUpdateMultipartRequest")
     class ContentUpdateMultipartRequest {
+
         @Schema(implementation = ContentUpdateRequest.class)
-        public ContentCreateRequest request;
+        public ContentUpdateRequest request;
 
         @Schema(type = "string", format = "binary", description = "썸네일 이미지")
         public MultipartFile thumbnail;
-    }
 
+    }
     @Operation(summary = "[어드민] 콘텐츠 수정", description = "콘텐츠의 제목, 설명, 태그를 수정합니다.")
     @ApiResponses({
             @ApiResponse(responseCode = "200", description = "성공",
@@ -87,6 +95,47 @@ ResponseEntity<ContentResponse> patchContent(
             @Parameter(hidden = true) ContentUpdateRequest request,
             @Parameter(hidden = true) MultipartFile thumbnail
     );
+    @Operation(summary = "콘텐츠 단건 조회", description = "콘텐츠 ID로 단건 조회합니다.")
+    @ApiResponses({
+            @ApiResponse(responseCode = "200", description = "성공",
+                    content = @Content(schema = @Schema(implementation = ContentResponse.class))),
+            @ApiResponse(responseCode = "400", description = "잘못된 요청",
+                    content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class))),
+            @ApiResponse(responseCode = "401", description = "인증 오류",
+                    content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class))),
+            @ApiResponse(responseCode = "404", description = "콘텐츠 없음",
+                    content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class))),
+            @ApiResponse(responseCode = "500", description = "서버 오류",
+                    content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class)))
+    })
+    ResponseEntity<ContentResponse> getContent(@Parameter(description = "콘텐츠 ID") UUID contentId);
+
+    @Operation(summary = "콘텐츠 목록 조회", description = "콘텐츠 목록을 커서 기반 페이지네이션으로 조회합니다.")
+    @ApiResponses({
+            @ApiResponse(responseCode = "200", description = "성공"),
+            @ApiResponse(responseCode = "400", description = "잘못된 요청",
+                    content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class))),
+            @ApiResponse(responseCode = "401", description = "인증 오류",
+                    content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class))),
+            @ApiResponse(responseCode = "500", description = "서버 오류",
+                    content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class)))
+    })
+    @Parameters({
+            @Parameter(name = "typeEqual", description = "콘텐츠 타입",
+                    schema = @Schema(implementation = ContentType.class)),
+            @Parameter(name = "keywordLike", description = "검색 키워드"),
+            @Parameter(name = "tagsIn", description = "태그 목록",
+                    array = @ArraySchema(schema = @Schema(type = "string", example = "string"))),
+            @Parameter(name = "cursor", description = "커서"),
+            @Parameter(name = "idAfter", description = "보조 커서"),
+            @Parameter(name = "limit", description = "한 번에 가져올 개수", example = "20", required = true),
+            @Parameter(name = "sortDirection", description = "정렬 방향", required = true,
+                    schema = @Schema(type = "string", allowableValues = {"ASCENDING", "DESCENDING"}, defaultValue = "DESCENDING")),
+            @Parameter(name = "sortBy", description = "정렬 기준", required = true,
+                    schema = @Schema(type = "string", allowableValues = {"createdAt", "watcherCount", "rate"}, defaultValue = "createdAt"))
+    })
+    ResponseEntity<CursorResponse<ContentResponse>> getContents(
+            @Parameter(hidden = true) ContentCursorRequest request);
 
     @Operation(summary = "[어드민] 콘텐츠 삭제", description = "콘텐츠를 삭제합니다.")
     @ApiResponses({
@@ -103,4 +152,4 @@ ResponseEntity<ContentResponse> patchContent(
                     content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class)))
     })
     ResponseEntity<Void> deleteContent(@Parameter(description = "콘텐츠 ID") UUID contentId);
-}
+}

src/main/java/com/codeit/team5/mopl/content/dto/request/ContentCursorRequest.java

@@ -0,0 +1,33 @@
+package com.codeit.team5.mopl.content.dto.request;
+
+import com.codeit.team5.mopl.content.entity.ContentSortByType;
+import com.codeit.team5.mopl.content.entity.ContentType;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Positive;
+import java.util.List;
+import org.springframework.data.domain.Sort;
+
+public record ContentCursorRequest(
+        ContentType typeEqual,
+
+        String keywordLike,
+
+        List<String> tagsIn,
+
+        String cursor,
+
+        String idAfter,
+
+        @NotNull
+        @Positive
+        @Max(100)
+        Integer limit,
+
+        @NotNull
+        Sort.Direction sortDirection,
+
+        @NotNull
+        ContentSortByType sortBy
+) {
+}

src/main/java/com/codeit/team5/mopl/content/entity/Content.java

@@ -22,6 +22,7 @@
 import lombok.AccessLevel;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
+import org.hibernate.annotations.BatchSize;
 import org.hibernate.annotations.JdbcTypeCode;
 import org.hibernate.type.SqlTypes;
 import org.springframework.util.StringUtils;
@@ -73,6 +74,7 @@ public class Content extends BaseUpdatableEntity {
     private ContentStats stats;
 
     @OneToMany(mappedBy = "content", fetch = FetchType.LAZY, cascade = CascadeType.ALL, orphanRemoval = true)
+    @BatchSize(size = 30)
     private Set<ContentTag> contentTags = new HashSet<>();
 
     public static Content createByAdmin(ContentType type, String title, String description) {

src/main/java/com/codeit/team5/mopl/content/entity/ContentSortByType.java

@@ -0,0 +1,24 @@
+package com.codeit.team5.mopl.content.entity;
+
+import com.codeit.team5.mopl.content.exception.ContentIncorrectSortByException;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum ContentSortByType {
+    CREATED_AT("createdAt"),
+    WATCHER_COUNT("watcherCount"),
+    RATE("rate")
+    ;
+    private final String value;
+
+    public static ContentSortByType from(String text) {
+        for (ContentSortByType type : ContentSortByType.values()) {
+            if (type.getValue().equalsIgnoreCase(text)) {
+                return type;
+            }
+        }
+        throw new ContentIncorrectSortByException(text);
+    }
+}

src/main/java/com/codeit/team5/mopl/content/entity/ContentStats.java

@@ -30,4 +30,14 @@ public static ContentStats create() {
         stats.watcherCount = 0;
         return stats;
     }
+
+    public double getAverageRating() {
+        if (reviewCount == 0) return 0.0;
+        return ratingSum / reviewCount;
+    }
+
+    public void updateRating(double newRatingSum, int newReviewCount) {
+        this.ratingSum = newRatingSum;
+        this.reviewCount = newReviewCount;
+    }
 }

src/main/java/com/codeit/team5/mopl/content/entity/ContentType.java

@@ -9,21 +9,21 @@ public enum ContentType {
     TV_SERIES("tvSeries"),
     SPORT("sport");
 
-    private final String response;
+    private final String value;
 
-    ContentType(String response) {
-        this.response = response;
+    ContentType(String value) {
+        this.value = value;
     }
 
     @JsonValue
-    public String getResponse() {
-        return response;
+    public String getValue() {
+        return value;
     }
 
     @JsonCreator
     public static ContentType from(String value) {
         for (ContentType type : values()) {
-            if (type.response.equals(value)) {
+            if (type.value.equals(value)) {
                 return type;
             }
         }

src/main/java/com/codeit/team5/mopl/content/exception/ContentIncorrectSortByException.java

@@ -0,0 +1,11 @@
+package com.codeit.team5.mopl.content.exception;
+
+import java.util.Map;
+import org.springframework.http.HttpStatus;
+
+public class ContentIncorrectSortByException extends ContentException {
+
+    public ContentIncorrectSortByException(String sortBy) {
+        super(HttpStatus.BAD_REQUEST, "SortBy 입력값이 올바르지 않습니다.", Map.of("incorrectSortBy", sortBy));
+    }
+}

src/main/java/com/codeit/team5/mopl/content/exception/CursorIdAfterNotTogetherException.java

@@ -0,0 +1,10 @@
+package com.codeit.team5.mopl.content.exception;
+
+import org.springframework.http.HttpStatus;
+
+public class CursorIdAfterNotTogetherException extends ContentException {
+
+    public CursorIdAfterNotTogetherException() {
+        super(HttpStatus.BAD_REQUEST, "cursor와 idAfter가 같이 제공되지 않습니다.");
+    }
+}

src/main/java/com/codeit/team5/mopl/content/exception/InvalidCursorException.java

@@ -0,0 +1,10 @@
+package com.codeit.team5.mopl.content.exception;
+
+import org.springframework.http.HttpStatus;
+
+public class InvalidCursorException extends ContentException {
+
+    public InvalidCursorException() {
+        super(HttpStatus.BAD_REQUEST, "커서 값이 유효하지 않습니다.");
+    }
+}