feat(be) TourResponse Dto 구조 변경에 따른 Client, Service 리팩토링

Author: YangHJ2415

src/main/kotlin/com/back/koreaTravelGuide/domain/ai/tour/client/TourApiClient.kt

@@ -1,7 +1,8 @@
 package com.back.koreaTravelGuide.domain.ai.tour.client
 
-import com.back.koreaTravelGuide.domain.ai.tour.dto.InternalData
+import com.back.koreaTravelGuide.domain.ai.tour.dto.TourItem
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourResponse
+import com.back.koreaTravelGuide.domain.ai.tour.dto.TourSearchParams
 import com.fasterxml.jackson.databind.ObjectMapper
 import org.slf4j.LoggerFactory
 import org.springframework.beans.factory.annotation.Value
@@ -22,7 +23,7 @@ class TourApiClient(
     private val logger = LoggerFactory.getLogger(TourApiClient::class.java)
 
     // 요청 URL 구성
-    private fun buildUrl(params: InternalData): URI =
+    private fun buildUrl(params: TourSearchParams): URI =
         UriComponentsBuilder.fromUri(URI.create(apiUrl))
             .path("/areaBasedList2")
             .queryParam("serviceKey", serviceKey)
@@ -39,7 +40,7 @@ class TourApiClient(
             .toUri()
 
     // 지역 기반 관광 정보 조회 (areaBasedList2)
-    fun fetchTourInfo(params: InternalData): List<TourResponse> {
+    fun fetchTourInfo(params: TourSearchParams): TourResponse {
         logger.info("지역 기반 관광 정보 조회 시작")
 
         val url = buildUrl(params)
@@ -51,14 +52,17 @@ class TourApiClient(
          * takeUnless { it.isNullOrBlank() }: 공백 응답을 걸러냄
          * ?.let { parseItems(it) } ?: emptyList(): 유효한 응답은 파싱, 아니면 빈 리스트 반환
          */
-        return runCatching { restTemplate.getForObject(url, String::class.java) }
-            .onFailure { logger.error("관광 정보 조회 실패", it) }
-            .getOrNull()
-            .takeUnless { it.isNullOrBlank() }
-            ?.let { parseItems(it) } ?: emptyList()
+        val response =
+            runCatching { restTemplate.getForObject(url, String::class.java) }
+                .onFailure { logger.error("관광 정보 조회 실패", it) }
+                .getOrNull()
+                .takeUnless { it.isNullOrBlank() }
+                ?.let { parseItems(it) }
+
+        return response ?: TourResponse(items = emptyList())
     }
 
-    private fun parseItems(json: String): List<TourResponse> {
+    private fun parseItems(json: String): TourResponse {
         val root = objectMapper.readTree(json)
 
         // header.resultCode 값 추출위한 노스 탐색 과정
@@ -72,7 +76,7 @@ class TourApiClient(
         // resultCode가 "0000"이 아닌 경우 체크
         if (resultCode != "0000") {
             logger.warn("관광 정보 API resultCode={}", resultCode)
-            return emptyList()
+            return TourResponse(items = emptyList())
         }
 
         // path("키") 형태로 노드를 탐색, 응답 Json 형태의 순서에 따라 순차적으로 내려감
@@ -84,27 +88,30 @@ class TourApiClient(
                 .path("item")
 
         // 탐색 결과가 비어 있는 경우
-        if (!itemsNode.isArray || itemsNode.isEmpty) return emptyList()
+        if (!itemsNode.isArray || itemsNode.isEmpty) return TourResponse(items = emptyList())
 
-        // itemsNode가 배열이므로 map으로 각 노드를 TourResponse로 변환
-        return itemsNode.map { node ->
-            TourResponse(
-                contentId = node.path("contentid").asText(),
-                contentTypeId = node.path("contenttypeid").asText(),
-                createdTime = node.path("createdtime").asText(),
-                modifiedTime = node.path("modifiedtime").asText(),
-                title = node.path("title").asText(),
-                addr1 = node.path("addr1").takeIf { it.isTextual }?.asText(),
-                areaCode = node.path("areacode").takeIf { it.isTextual }?.asText(),
-                firstimage = node.path("firstimage").takeIf { it.isTextual }?.asText(),
-                firstimage2 = node.path("firstimage2").takeIf { it.isTextual }?.asText(),
-                mapX = node.path("mapx").takeIf { it.isTextual }?.asText(),
-                mapY = node.path("mapy").takeIf { it.isTextual }?.asText(),
-                mlevel = node.path("mlevel").takeIf { it.isTextual }?.asText(),
-                sigunguCode = node.path("sigungucode").takeIf { it.isTextual }?.asText(),
-                lDongRegnCd = node.path("lDongRegnCd").takeIf { it.isTextual }?.asText(),
-                lDongSignguCd = node.path("lDongSignguCd").takeIf { it.isTextual }?.asText(),
-            )
-        }
+        // itemsNode가 배열이므로 map으로 각 노드를 TourItem으로 변환 후 컨테이너로 감싼다.
+        val items =
+            itemsNode.map { node ->
+                TourItem(
+                    contentId = node.path("contentid").asText(),
+                    contentTypeId = node.path("contenttypeid").asText(),
+                    createdTime = node.path("createdtime").asText(),
+                    modifiedTime = node.path("modifiedtime").asText(),
+                    title = node.path("title").asText(),
+                    addr1 = node.path("addr1").takeIf { it.isTextual }?.asText(),
+                    areaCode = node.path("areacode").takeIf { it.isTextual }?.asText(),
+                    firstimage = node.path("firstimage").takeIf { it.isTextual }?.asText(),
+                    firstimage2 = node.path("firstimage2").takeIf { it.isTextual }?.asText(),
+                    mapX = node.path("mapx").takeIf { it.isTextual }?.asText(),
+                    mapY = node.path("mapy").takeIf { it.isTextual }?.asText(),
+                    mlevel = node.path("mlevel").takeIf { it.isTextual }?.asText(),
+                    sigunguCode = node.path("sigungucode").takeIf { it.isTextual }?.asText(),
+                    lDongRegnCd = node.path("lDongRegnCd").takeIf { it.isTextual }?.asText(),
+                    lDongSignguCd = node.path("lDongSignguCd").takeIf { it.isTextual }?.asText(),
+                )
+            }
+
+        return TourResponse(items = items)
     }
 }

src/main/kotlin/com/back/koreaTravelGuide/domain/ai/tour/dto/TourResponse.kt

@@ -6,7 +6,6 @@ package com.back.koreaTravelGuide.domain.ai.tour.dto
  * API 매뉴얼에서 필수인 값은 NonNull로 지정.
  */
 
-// 관광 정보 응답
 data class TourResponse(
     val items: List<TourItem>,
 )

src/main/kotlin/com/back/koreaTravelGuide/domain/ai/tour/service/TourService.kt

@@ -20,8 +20,8 @@ class TourService(
         contentTypeId: String? = null,
         areaCode: String? = null,
         sigunguCode: String? = null,
-    ): List<TourResponse> {
-        // InternalData 객체 생성, null 또는 비정상 값은 기본값으로 대체
+    ): TourResponse {
+        // null 또는 비정상 값은 기본값으로 대체
         val request =
             TourSearchParams(
                 numOfRows = numOfRows?.takeIf { it > 0 } ?: TourSearchParams.DEFAULT_ROWS,
@@ -35,15 +35,15 @@ class TourService(
         val tours = tourApiClient.fetchTourInfo(request)
 
         // 관광 정보 결과 로깅
-        if (tours.isEmpty()) {
+        if (tours.items.isEmpty()) {
             logger.info(
                 "관광 정보 없음: params={} / {} {}",
                 request.areaCode,
                 request.sigunguCode,
                 request.contentTypeId,
             )
         } else {
-            logger.info("관광 정보 {}건 조회 성공", tours.size)
+            logger.info("관광 정보 {}건 조회 성공", tours.items.size)
         }
         return tours
     }