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,25 @@
+package com.codeit.team5.mopl.config;
+
+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);
+        });
+    }
+}

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

@@ -1,19 +1,27 @@
 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.entity.ContentSortByType;
+import com.codeit.team5.mopl.content.entity.ContentType;
 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.beans.PropertyEditorSupport;
 import java.util.UUID;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.http.HttpStatus;
 import org.springframework.http.MediaType;
 import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.WebDataBinder;
 import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.InitBinder;
 import org.springframework.web.bind.annotation.PatchMapping;
 import org.springframework.web.bind.annotation.PathVariable;
 import org.springframework.web.bind.annotation.PostMapping;
@@ -30,6 +38,22 @@ public class ContentController implements ContentApi {
 
     private final ContentService contentService;
 
+    @InitBinder
+    public void initBinder(WebDataBinder binder) {
+        binder.registerCustomEditor(ContentType.class, new PropertyEditorSupport() {
+            @Override
+            public void setAsText(String text) {
+                setValue(ContentType.from(text));
+            }
+        });
+        binder.registerCustomEditor(ContentSortByType.class, new PropertyEditorSupport() {
+            @Override
+            public void setAsText(String text) {
+                setValue(ContentSortByType.from(text));
+            }
+        });
+    }
+
     @Override
     @PostMapping(consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
     public ResponseEntity<ContentResponse> postContent(
@@ -53,6 +77,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,34 @@
+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;
+
+@ValidCursor
+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/dto/request/ValidCursor.java

@@ -0,0 +1,20 @@
+package com.codeit.team5.mopl.content.dto.request;
+
+import jakarta.validation.Constraint;
+import jakarta.validation.Payload;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Target(ElementType.TYPE)
+@Retention(RetentionPolicy.RUNTIME)
+@Constraint(validatedBy = ValidCursorValidator.class)
+public @interface ValidCursor {
+
+    String message() default "커서 값이 유효하지 않습니다.";
+
+    Class<?>[] groups() default {};
+
+    Class<? extends Payload>[] payload() default {};
+}

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

@@ -0,0 +1,40 @@
+package com.codeit.team5.mopl.content.dto.request;
+
+import jakarta.validation.ConstraintValidator;
+import jakarta.validation.ConstraintValidatorContext;
+import java.time.Instant;
+import java.util.UUID;
+
+public class ValidCursorValidator implements ConstraintValidator<ValidCursor, ContentCursorRequest> {
+
+    @Override
+    public boolean isValid(ContentCursorRequest request, ConstraintValidatorContext context) {
+        String cursor = request.cursor();
+        String idAfter = request.idAfter();
+
+        if ((cursor == null) ^ (idAfter == null)) return false;
+
+        if (cursor == null) return true;
+
+        try {
+            UUID.fromString(idAfter);
+        } catch (IllegalArgumentException e) {
+            return false;
+        }
+
+        try {
+            switch (request.sortBy()) {
+                case CREATED_AT -> Instant.parse(cursor);
+                case WATCHER_COUNT -> Long.parseLong(cursor);
+                case RATE -> {
+                    double val = Double.parseDouble(cursor);
+                    if (!Double.isFinite(val)) return false;
+                }
+            }
+        } catch (Exception e) {
+            return false;
+        }
+
+        return true;
+    }
+}

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

@@ -1,5 +1,6 @@
 package com.codeit.team5.mopl.content.entity;
 
+import com.codeit.team5.mopl.content.exception.InvalidContentStatsException;
 import com.codeit.team5.mopl.global.entity.BaseUpdatableEntity;
 import jakarta.persistence.Column;
 import jakarta.persistence.Entity;
@@ -30,4 +31,23 @@ 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) {
+        if (newReviewCount < 0) {
+            throw new InvalidContentStatsException("reviewCount는 음수일 수 없습니다.");
+        }
+        if (!Double.isFinite(newRatingSum) || newRatingSum < 0) {
+            throw new InvalidContentStatsException("ratingSum은 음수이거나 비정상 값(NaN, Infinity)일 수 없습니다.");
+        }
+        if (newReviewCount == 0 && newRatingSum != 0) {
+            throw new InvalidContentStatsException("reviewCount가 0이면 ratingSum도 0이어야 합니다.");
+        }
+        this.ratingSum = newRatingSum;
+        this.reviewCount = newReviewCount;
+    }
 }