[Feat] 응원 조회 API 구현

Author: leegwichan

build.gradle

@@ -56,6 +56,7 @@ dependencies {
     implementation 'org.springframework.boot:spring-boot-starter-actuator'
     implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
     implementation 'org.springframework.boot:spring-boot-starter-web'
+    implementation 'org.springframework.boot:spring-boot-starter-validation'
 
     // Lombok
     compileOnly 'org.projectlombok:lombok'

src/main/java/eatda/controller/store/CheerController.java

@@ -0,0 +1,23 @@
+package eatda.controller.store;
+
+import eatda.service.store.CheerService;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequiredArgsConstructor
+public class CheerController {
+
+    private final CheerService cheerService;
+
+    @GetMapping("/api/cheer")
+    public ResponseEntity<CheersResponse> getCheers(@RequestParam @Min(1) @Max(50) int size) {
+        CheersResponse response = cheerService.getCheers(size);
+        return ResponseEntity.ok(response);
+    }
+}

src/main/java/eatda/controller/store/CheerPreviewResponse.java

@@ -0,0 +1,29 @@
+package eatda.controller.store;
+
+import eatda.domain.store.Cheer;
+import eatda.domain.store.Store;
+
+public record CheerPreviewResponse(
+        long storeId,
+        String imageUrl,
+        String storeName,
+        String storeDistrict,
+        String storeNeighborhood,
+        String storeCategory,
+        long cheerId,
+        String cheerDescription
+) {
+
+    public CheerPreviewResponse(Cheer cheer, Store store, String imageUrl) {
+        this(
+                store.getId(),
+                imageUrl,
+                store.getName(),
+                store.getAddressDistrict(),
+                store.getAddressNeighborhood(),
+                store.getCategory().getCategoryName(),
+                cheer.getId(),
+                cheer.getDescription()
+        );
+    }
+}

src/main/java/eatda/controller/store/CheersResponse.java

@@ -0,0 +1,7 @@
+package eatda.controller.store;
+
+import java.util.List;
+
+public record CheersResponse(List<CheerPreviewResponse> cheers) {
+
+}

src/main/java/eatda/domain/store/Cheer.java

@@ -13,7 +13,6 @@
 import jakarta.persistence.JoinColumn;
 import jakarta.persistence.ManyToOne;
 import jakarta.persistence.Table;
-import java.time.LocalDateTime;
 import lombok.AccessLevel;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
@@ -56,6 +55,11 @@ public Cheer(Member member, Store store, String description, String imageKey) {
         this.isAdmin = false;
     }
 
+    public Cheer(Member member, Store store, String description, String imageKey, boolean isAdmin) {
+        this(member, store, description, imageKey);
+        this.isAdmin = isAdmin;
+    }
+
     private void validateDescription(String description) {
         if (description == null || description.isBlank()) {
             throw new BusinessException(BusinessErrorCode.INVALID_CHEER_DESCRIPTION);

src/main/java/eatda/domain/store/Store.java

@@ -70,4 +70,20 @@ private Store(String kakaoId,
         this.lotNumberAddress = lotNumberAddress;
         this.coordinates = new Coordinates(latitude, longitude);
     }
+
+    public String getAddressDistrict() {
+        String[] addressParts = lotNumberAddress.split(" ");
+        if (addressParts.length < 2) {
+            return "";
+        }
+        return addressParts[1];
+    }
+
+    public String getAddressNeighborhood() {
+        String[] addressParts = lotNumberAddress.split(" ");
+        if (addressParts.length < 3) {
+            return "";
+        }
+        return addressParts[2];
+    }
 }

src/main/java/eatda/exception/EtcErrorCode.java

@@ -15,8 +15,10 @@ public enum EtcErrorCode {
     NO_COOKIE_FOUND("CLIENT007", "필수 쿠키 값이 존재하지 않습니다.", HttpStatus.BAD_REQUEST),
     NO_HEADER_FOUND("CLIENT008", "필수 헤더 값이 존재하지 않습니다.", HttpStatus.BAD_REQUEST),
     NO_PARAMETER_FOUND("CLIENT009", "필수 파라미터 값이 존재하지 않습니다.", HttpStatus.BAD_REQUEST),
+    VALIDATION_ERROR("CLIENT010", "요청 데이터 값이 범위를 벗어났습니다", HttpStatus.BAD_REQUEST),
 
-    INTERNAL_SERVER_ERROR("SERVER001", "서버 내부 에러가 발생했습니다.", HttpStatus.INTERNAL_SERVER_ERROR);
+    INTERNAL_SERVER_ERROR("SERVER001", "서버 내부 에러가 발생했습니다.", HttpStatus.INTERNAL_SERVER_ERROR),
+    ;
 
     private final String code;
     private final String message;

src/main/java/eatda/exception/GlobalExceptionHandler.java

@@ -13,6 +13,7 @@
 import org.springframework.web.bind.MissingServletRequestParameterException;
 import org.springframework.web.bind.annotation.ExceptionHandler;
 import org.springframework.web.bind.annotation.RestControllerAdvice;
+import org.springframework.web.method.annotation.HandlerMethodValidationException;
 import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException;
 import org.springframework.web.servlet.resource.NoResourceFoundException;
 
@@ -77,6 +78,12 @@ public ResponseEntity<ErrorResponse> handleMissingServletRequestParameterExcepti
         return toErrorResponse(EtcErrorCode.NO_PARAMETER_FOUND);
     }
 
+    @ExceptionHandler(HandlerMethodValidationException.class)
+    public ResponseEntity<ErrorResponse> handleHandlerMethodValidationException(
+            HandlerMethodValidationException exception) {
+        return toErrorResponse(EtcErrorCode.VALIDATION_ERROR);
+    }
+
     @ExceptionHandler(BusinessException.class)
     public ResponseEntity<ErrorResponse> handleBusinessException(BusinessException exception) {
         log.error("[BusinessException] handled: {}", exception.getErrorCode());

src/main/java/eatda/repository/store/CheerRepository.java

@@ -0,0 +1,13 @@
+package eatda.repository.store;
+
+import eatda.domain.store.Cheer;
+import java.util.List;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.repository.Repository;
+
+public interface CheerRepository extends Repository<Cheer, Long> {
+
+    Cheer save(Cheer cheer);
+
+    List<Cheer> findAllByOrderByCreatedAtDesc(Pageable pageable);
+}

src/main/java/eatda/repository/store/StoreRepository.java

@@ -0,0 +1,9 @@
+package eatda.repository.store;
+
+import eatda.domain.store.Store;
+import org.springframework.data.repository.Repository;
+
+public interface StoreRepository extends Repository<Store, Long> {
+
+    Store save(Store store);
+}