[feat] 방 검색 api 개발

src/main/java/konkuk/thip/common/exception/code/ErrorCode.java

@@ -63,7 +63,6 @@ public enum ErrorCode implements ResponseCode {
      */
     INVALID_SEARCH_TYPE(HttpStatus.BAD_REQUEST, 900000,"알맞은 검색어 타입을 찾을 수 없습니다."),
 
-
     /**
      * 100000 : room error
      */
@@ -72,6 +71,8 @@ public enum ErrorCode implements ResponseCode {
     ROOM_PASSWORD_MISMATCH(HttpStatus.BAD_REQUEST, 100002, "비밀번호가 일치하지 않습니다."),
     ROOM_PASSWORD_NOT_REQUIRED(HttpStatus.BAD_REQUEST, 100003, "공개방은 비밀번호가 필요하지 않습니다."),
     ROOM_RECRUITMENT_PERIOD_EXPIRED(HttpStatus.BAD_REQUEST, 100004, "모집기간이 만료된 방입니다."),
+    INVALID_ROOM_SEARCH_SORT(HttpStatus.BAD_REQUEST, 100005, "방 검색 시 정렬 조건이 잘못되었습니다."),
+
     /**
      * 110000 : vote error
      */

src/main/java/konkuk/thip/common/util/DateUtilsss.java

@@ -0,0 +1,31 @@
+package konkuk.thip.common.util;
+
+import java.time.Duration;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+public class DateUtilsss {
+
+    public static String formatAfterTime(LocalDate date) {
+        LocalDateTime now = LocalDateTime.now();
+        LocalDateTime dateTime = date.atStartOfDay();
+        Duration d = Duration.between(now, dateTime);
+
+        if (d.isNegative() || d.isZero()) {
+            return "??";
+        }
+
+        long days = d.toDays();
+        if (days > 0) {
+            return days + "일 뒤 ";
+        }
+
+        long hours = d.toHours();
+        if (hours > 0) {
+            return hours + "시간 뒤 ";
+        }
+
+        long minutes = d.toMinutes();
+        return minutes + "분 뒤 ";
+    }
+}

src/main/java/konkuk/thip/room/adapter/in/web/RoomQueryController.java

@@ -1,16 +1,32 @@
 package konkuk.thip.room.adapter.in.web;
 
-import jakarta.validation.Valid;
 import konkuk.thip.common.dto.BaseResponse;
+import konkuk.thip.room.adapter.in.web.response.RoomSearchResponse;
+import konkuk.thip.room.application.port.in.RoomSearchUseCase;
+import jakarta.validation.Valid;
 import konkuk.thip.room.adapter.in.web.request.RoomVerifyPasswordRequest;
 import konkuk.thip.room.application.port.in.RoomVerifyPasswordUseCase;
 import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
 import org.springframework.web.bind.annotation.*;
 
 @RestController
 @RequiredArgsConstructor
 public class RoomQueryController {
 
+    private final RoomSearchUseCase roomSearchUseCase;
+
+    @GetMapping("/rooms/search")
+    public BaseResponse<RoomSearchResponse> searchRooms(
+            @RequestParam(value = "keyword", required = false, defaultValue = "") final String keyword,
+            @RequestParam(value = "category", required = false, defaultValue = "") final String category,
+            @RequestParam("sort") final String sort,
+            @RequestParam("page") final int page
+    ) {
+        return BaseResponse.ok(roomSearchUseCase.searchRoom(keyword, category, sort, page));
+    }
     private final RoomVerifyPasswordUseCase roomVerifyPasswordUseCase;
 
     //비공개 방 비밀번호 입력 검증

src/main/java/konkuk/thip/room/adapter/in/web/response/RoomSearchResponse.java

@@ -0,0 +1,22 @@
+package konkuk.thip.room.adapter.in.web.response;
+
+import java.util.List;
+
+public record RoomSearchResponse(
+        List<RoomSearchResult> roomList,
+        int page,       // 현재 페이지
+        int size,       // 현재 페이지에 포함된 데이터 수
+        boolean last,
+        boolean first
+) {
+
+    public record RoomSearchResult(
+            Long roomId,
+            String bookImageUrl,
+            String roomName,
+            int memberCount,
+            int recruitCount,
+            String deadlineDate,
+            String category
+    ) {}
+}

src/main/java/konkuk/thip/room/adapter/out/persistence/CategoryName.java

@@ -0,0 +1,32 @@
+package konkuk.thip.room.adapter.out.persistence;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+import java.util.Arrays;
+
+@Getter
+@RequiredArgsConstructor
+public enum CategoryName {
+
+    /**
+     * DB에 저장되어 있는 모든 카테고리들의 이름
+     * TODO : DB에서 value를 통해 카테고리를 조회하는것보다 id로 조회하는게 성능상 좋으니, id 값도 같이 보관 ??
+     */
+    SCIENCE_IT("과학/IT"),
+    Literature("문학"),
+    ART("예술"),
+    SOCIAL_SCIENCE("사회과확"),
+    HUMANITY("인문학");
+
+    private final String value;
+
+    public static CategoryName from(String value) {
+        return Arrays.stream(CategoryName.values())
+                .filter(categoryName -> categoryName.getValue().equals(value))
+                .findFirst()
+                .orElseThrow(
+                        () -> new IllegalArgumentException("현재 카테고리 이름 : " + value)
+                );
+    }
+}

src/main/java/konkuk/thip/room/adapter/out/persistence/RoomJpaRepository.java

@@ -5,6 +5,9 @@
 
 import java.time.LocalDate;
 
-public interface RoomJpaRepository extends JpaRepository<RoomJpaEntity, Long> {
+public interface RoomJpaRepository extends JpaRepository<RoomJpaEntity, Long>, RoomQueryRepository {
+
     int countByBookJpaEntity_BookIdAndStartDateAfter(Long bookId, LocalDate currentDate);
+
+
 }

src/main/java/konkuk/thip/room/adapter/out/persistence/RoomQueryPersistenceAdapter.java

@@ -1,8 +1,11 @@
 package konkuk.thip.room.adapter.out.persistence;
 
+import konkuk.thip.room.adapter.in.web.response.RoomSearchResponse;
 import konkuk.thip.room.adapter.out.mapper.RoomMapper;
 import konkuk.thip.room.application.port.out.RoomQueryPort;
 import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
 import org.springframework.stereotype.Repository;
 
 import java.time.LocalDate;
@@ -18,4 +21,9 @@ public class RoomQueryPersistenceAdapter implements RoomQueryPort {
     public int countRecruitingRoomsByBookAndStartDateAfter(Long bookId, LocalDate currentDate) {
         return roomJpaRepository.countByBookJpaEntity_BookIdAndStartDateAfter(bookId, currentDate);
     }
+
+    @Override
+    public Page<RoomSearchResponse.RoomSearchResult> searchRoom(String keyword, String category, Pageable pageable) {
+        return roomJpaRepository.searchRoom(keyword, category, pageable);
+    }
 }

src/main/java/konkuk/thip/room/adapter/out/persistence/RoomQueryRepository.java

@@ -0,0 +1,10 @@
+package konkuk.thip.room.adapter.out.persistence;
+
+import konkuk.thip.room.adapter.in.web.response.RoomSearchResponse;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+
+public interface RoomQueryRepository {
+
+    Page<RoomSearchResponse.RoomSearchResult> searchRoom(String keyword, String category, Pageable pageable);
+}

src/main/java/konkuk/thip/room/adapter/out/persistence/RoomQueryRepositoryImpl.java

@@ -0,0 +1,140 @@
+package konkuk.thip.room.adapter.out.persistence;
+
+import com.querydsl.core.BooleanBuilder;
+import com.querydsl.core.Tuple;
+import com.querydsl.core.types.Order;
+import com.querydsl.core.types.OrderSpecifier;
+import com.querydsl.core.types.dsl.CaseBuilder;
+import com.querydsl.core.types.dsl.NumberExpression;
+import com.querydsl.jpa.impl.JPAQueryFactory;
+import konkuk.thip.book.adapter.out.jpa.QBookJpaEntity;
+import konkuk.thip.common.util.DateUtilsss;
+import konkuk.thip.room.adapter.in.web.response.RoomSearchResponse;
+import konkuk.thip.room.adapter.out.jpa.QRoomJpaEntity;
+import konkuk.thip.user.adapter.out.jpa.QUserRoomJpaEntity;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.PageImpl;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.domain.Sort;
+import org.springframework.stereotype.Repository;
+
+import java.time.LocalDate;
+import java.util.List;
+
+@Repository
+@RequiredArgsConstructor
+public class RoomQueryRepositoryImpl implements RoomQueryRepository {
+
+    private final JPAQueryFactory queryFactory;
+    private final QRoomJpaEntity room = QRoomJpaEntity.roomJpaEntity;
+    private final QBookJpaEntity book = QBookJpaEntity.bookJpaEntity;
+    private final QUserRoomJpaEntity userRoom = QUserRoomJpaEntity.userRoomJpaEntity;
+
+    @Override
+    public Page<RoomSearchResponse.RoomSearchResult> searchRoom(String keyword, String category, Pageable pageable) {
+        // 1. 검색 조건(where) 조립 : 방이름 or 첵제목에 keyword 포함, category 필터 적용, 멤버 모집중인(= 활동 시작전인) 방만 검색
+        BooleanBuilder where = new BooleanBuilder();
+        // keyword 필터 (빈 문자열이면 생략)
+        if (keyword != null && !keyword.isBlank()) {
+            where.and(room.title.containsIgnoreCase(keyword).or(book.title.containsIgnoreCase(keyword)));
+        }
+        // category 필터 (빈 문자열이면 생략)
+        if (category != null && !category.isBlank()) {
+            where.and(room.categoryJpaEntity.value.eq(category));
+        }
+        // 모집중인 방만
+        where.and(room.startDate.after(LocalDate.now()));
+
+        // 2. 페이징된 content 조회
+        // 우선순위 표현식 : keyword가 방 제목에 매칭되면 1, 아니면 0
+        NumberExpression<Integer> priorityExpr = new CaseBuilder()
+                .when(room.title.containsIgnoreCase(keyword)).then(1)
+                .otherwise(0);
+
+        NumberExpression<Long> memberCountExpr = userRoom.userRoomId.count();       // 방 별 멤버수 표현식
+
+        List<Tuple> tuples = queryFactory
+                .select(
+                        room.roomId,
+                        book.imageUrl,
+                        room.title,
+                        memberCountExpr,
+                        room.recruitCount,
+                        room.startDate,
+                        room.categoryJpaEntity.value
+                )
+                .from(room)
+                .join(room.bookJpaEntity, book)
+                .leftJoin(userRoom).on(userRoom.roomJpaEntity.eq(room))
+                .where(where)
+                .groupBy(
+                        room.roomId,
+                        book.imageUrl,
+                        room.title,
+                        room.recruitCount,
+                        room.startDate,
+                        room.categoryJpaEntity.value
+                )
+                .orderBy(
+                        // 1차 정렬 : 설정된 정렬 조건, 2차 정렬 : 방이름으로 방 검색 > 책제목으로 방 검색
+                        toOrderSpecifier(pageable.getSort(), room, memberCountExpr),
+                        priorityExpr.desc()
+                )
+                .offset(pageable.getOffset())
+                .limit(pageable.getPageSize())
+                .fetch();
+        // TODO : 추후에 오프셋 페이징이 아니라, 키셋 페이징 기법 도입 검토
+
+        // 3. Tuple → DTO 매핑
+        List<RoomSearchResponse.RoomSearchResult> content = tuples.stream()
+                .map(t -> new RoomSearchResponse.RoomSearchResult(
+                        t.get(room.roomId),
+                        t.get(book.imageUrl),
+                        t.get(room.title),
+                        // 참여자 수를 int로 캐스팅
+                        t.get(memberCountExpr).intValue(),
+                        t.get(room.recruitCount),
+                        // 모집마감일 까지 남은 시간 포맷
+                        DateUtilsss.formatAfterTime(t.get(room.startDate)),
+                        t.get(room.categoryJpaEntity.value)
+                ))
+                .toList();
+
+        // 4. 전체 개수 조회 (페이징 정보 계산용)
+        Long totalCount = queryFactory
+                .select(room.count())
+                .from(room)
+                .join(room.bookJpaEntity, book)
+                .where(where)
+                .fetchOne();
+        long total = (totalCount != null) ? totalCount : 0L;
+
+        // 5. PageImpl 생성하여 반환
+        return new PageImpl<>(content, pageable, total);
+    }
+
+    /**
+     * 지원하는 정렬 키에 대해, 미리 정의된 Q 필드를 반환합니다.
+     * sort가 없으면 '마감 임박순' 으로 기본 처리합니다.
+     */
+    private OrderSpecifier<?> toOrderSpecifier(Sort sort, QRoomJpaEntity room, NumberExpression<Long> memberCountExpr) {
+        // sort 파라미터가 없으면 기본 마감 임박순
+        if (sort.isUnsorted()) {
+            return room.startDate.asc();
+        }
+
+        // 클라이언트가 보낸 첫 번째 sort 키를 꺼냅니다.
+        String key = sort.stream().findFirst().get().getProperty();
+
+        switch (key) {
+            case "memberCount":
+                // user_rooms 테이블에서 현재 참여자 수 집계 → 내림차순
+                return new OrderSpecifier<>(Order.DESC, memberCountExpr);
+            case "deadLine":
+            default:
+                // deadLine: 마감 임박순 = startDate 빠른 순서대로(오름차순)
+                return room.startDate.asc();
+        }
+    }
+}

src/main/java/konkuk/thip/room/adapter/out/persistence/RoomSearchSortParam.java

@@ -0,0 +1,26 @@
+package konkuk.thip.room.adapter.out.persistence;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+import java.util.Arrays;
+
+@Getter
+@RequiredArgsConstructor
+public enum RoomSearchSortParam {
+
+    DEADLINE("deadline"),
+    MEMBER_COUNT("memberCount"),
+    RECOMMEND("인플루언서, 작가 추천");      // 개발 미정
+
+    private final String value;
+
+    public static RoomSearchSortParam from(String value) {
+        return Arrays.stream(RoomSearchSortParam.values())
+                .filter(param -> param.getValue().equals(value))
+                .findFirst()
+                .orElseThrow(
+                        () -> new IllegalArgumentException("현재 정렬 조건 param : " + value)
+                );
+    }
+}

src/main/java/konkuk/thip/room/application/port/in/RoomSearchUseCase.java

@@ -0,0 +1,8 @@
+package konkuk.thip.room.application.port.in;
+
+import konkuk.thip.room.adapter.in.web.response.RoomSearchResponse;
+
+public interface RoomSearchUseCase {
+
+    RoomSearchResponse searchRoom(String keyword, String category, String sort, int page);
+}

src/main/java/konkuk/thip/room/application/port/out/RoomQueryPort.java

@@ -1,7 +1,13 @@
 package konkuk.thip.room.application.port.out;
 
+import konkuk.thip.room.adapter.in.web.response.RoomSearchResponse;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+
 import java.time.LocalDate;
 
 public interface RoomQueryPort {
     int countRecruitingRoomsByBookAndStartDateAfter(Long bookId, LocalDate currentDate);
+
+    Page<RoomSearchResponse.RoomSearchResult> searchRoom(String keyword, String category, Pageable pageable);
 }