feat: 구인글 검색 기능 추가

Author: larama-C

src/main/java/com/back/web7_9_codecrete_be/domain/community/post/controller/JoinPostController.java

@@ -8,11 +8,16 @@
 import com.back.web7_9_codecrete_be.global.rq.Rq;
 import com.back.web7_9_codecrete_be.global.rsData.RsData;
 import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.media.Schema;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Pageable;
 import org.springframework.web.bind.annotation.*;
 
+import java.util.List;
+
 @RestController
 @RequestMapping("/api/v1/join")
 @RequiredArgsConstructor
@@ -73,4 +78,23 @@ public RsData<?> close(
         joinPostService.close(postId, user.getId());
         return RsData.success("구인글이 마감되었습니다.");
     }
+
+    @Operation(summary = "구인글 검색", description = "제목 또는 내용에 키워드를 포함하고 있는 구인글을 검색합니다.")
+    @GetMapping("/search")
+    public RsData<List<JoinPostResponse>> search(
+            @Schema(description = """
+                <h3>검색어가 되는 Keyword입니다.</h3>
+                <hr/>
+                <b>?keyword={keyword}</b> 로 값을 넘기시면 됩니다.<br/>
+                제목 또는 내용에 해당 문자열을 포함하는 구인글을
+                페이징된 만큼 반환합니다.
+                """)
+            @RequestParam String keyword,
+            @Schema(description = "페이징 처리 또는 무한 스크롤 구현에 사용하는 Pageable 객체입니다.")
+            @Parameter(hidden = true) Pageable pageable
+    ) {
+        return RsData.success(
+                joinPostService.searchByKeyword(keyword, pageable)
+        );
+    }
 }

src/main/java/com/back/web7_9_codecrete_be/domain/community/post/repository/JoinPostRepository.java

@@ -4,7 +4,29 @@
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.Pageable;
 import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param;
+
+import java.util.List;
 
 public interface JoinPostRepository extends JpaRepository<JoinPost, Long> {
     Page<JoinPost> findByPost_UserId(Long userId, Pageable pageable);
+
+    @Query("""
+    SELECT
+        jp
+    FROM
+        JoinPost jp
+    JOIN FETCH
+        jp.post p
+    WHERE
+        p.title LIKE %:keyword%
+        OR p.content LIKE %:keyword%
+    ORDER BY
+        p.createdDate DESC
+""")
+    List<JoinPost> searchByKeyword(
+            @Param("keyword") String keyword,
+            Pageable pageable
+    );
 }

src/main/java/com/back/web7_9_codecrete_be/domain/community/post/service/JoinPostService.java

@@ -14,9 +14,12 @@
 import com.back.web7_9_codecrete_be.global.error.code.PostErrorCode;
 import com.back.web7_9_codecrete_be.global.error.exception.BusinessException;
 import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Pageable;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 
+import java.util.List;
+
 @Service
 @RequiredArgsConstructor
 public class JoinPostService {
@@ -117,4 +120,15 @@ public void close(Long postId, Long userId) {
 
         joinPost.close(); // status = CLOSED
     }
+
+    public List<JoinPostResponse> searchByKeyword(String keyword, Pageable pageable) {
+        if (keyword == null || keyword.isEmpty()) {
+            throw new BusinessException(PostErrorCode.KEYWORD_IS_NULL);
+        }
+
+        return joinPostRepository.searchByKeyword(keyword, pageable)
+                .stream()
+                .map(JoinPostResponse::from)
+                .toList();
+    }
 }