[fix] 종료된 네이버 책 API를 알라딘으로 전환 (#372)

src/main/java/konkuk/thip/book/adapter/in/web/response/BookDetailSearchResponse.java

@@ -18,12 +18,12 @@ public record BookDetailSearchResponse(
     public static BookDetailSearchResponse of(BookDetailSearchResult result) {
 
         return new BookDetailSearchResponse(
-                result.naverDetailBook().title(),
-                result.naverDetailBook().imageUrl(),
-                result.naverDetailBook().author(),
-                result.naverDetailBook().publisher(),
-                result.naverDetailBook().isbn(),
-                result.naverDetailBook().description(),
+                result.bookDetail().title(),
+                result.bookDetail().imageUrl(),
+                result.bookDetail().author(),
+                result.bookDetail().publisher(),
+                result.bookDetail().isbn(),
+                result.bookDetail().description(),
                 result.recruitingRoomCount(),
                 result.readCount(),
                 result.isSaved());

src/main/java/konkuk/thip/book/adapter/in/web/response/BookSearchListResponse.java

@@ -1,10 +1,10 @@
 package konkuk.thip.book.adapter.in.web.response;
 
-import konkuk.thip.book.adapter.out.api.dto.NaverBookParseResult;
+import konkuk.thip.book.adapter.out.api.dto.BookSearchResult;
 
 import java.util.List;
 
-import static konkuk.thip.book.adapter.out.api.naver.NaverApiUtil.PAGE_SIZE;
+import static konkuk.thip.book.adapter.out.api.dto.BookSearchResult.PAGE_SIZE;
 
 public record BookSearchListResponse(
         List<BookSearchDto> searchResult, // 책 목록
@@ -15,13 +15,13 @@ public record BookSearchListResponse(
         boolean last,               // 마지막 페이지 여부
         boolean first               // 첫 페이지 여부
 ) {
-    public static BookSearchListResponse of(NaverBookParseResult result, int page) {
+    public static BookSearchListResponse of(BookSearchResult result, int page) {
         int totalElements = result.total();
         int totalPages = (int) Math.ceil((double) totalElements / PAGE_SIZE);
         boolean last = (page >= totalPages);
         boolean first = (page == 1);
 
-        List<BookSearchDto> bookSearchDtos = result.naverBooks().stream()
+        List<BookSearchDto> bookSearchDtos = result.books().stream()
                 .map(BookSearchDto::of)
                 .toList();
 
@@ -42,13 +42,13 @@ public record BookSearchDto(
             String publisher,
             String isbn
     ) {
-        public static BookSearchDto of(NaverBookParseResult.NaverBook naverBook) {
+        public static BookSearchDto of(BookSearchResult.BookSummary book) {
             return new BookSearchDto(
-                    naverBook.title(),
-                    naverBook.imageUrl(),
-                    naverBook.author(),
-                    naverBook.publisher(),
-                    naverBook.isbn()
+                    book.title(),
+                    book.imageUrl(),
+                    book.author(),
+                    book.publisher(),
+                    book.isbn()
             );
         }
     }

src/main/java/konkuk/thip/book/adapter/out/api/CompositeBookApiAdapter.java

@@ -1,9 +1,9 @@
 package konkuk.thip.book.adapter.out.api;
 
 import konkuk.thip.book.adapter.out.api.aladin.AladinApiClient;
-import konkuk.thip.book.adapter.out.api.dto.NaverBookParseResult;
-import konkuk.thip.book.adapter.out.api.dto.NaverDetailBookParseResult;
-import konkuk.thip.book.adapter.out.api.naver.NaverApiClient;
+import konkuk.thip.book.adapter.out.api.aladin.AladinApiUtil;
+import konkuk.thip.book.adapter.out.api.dto.BookSearchResult;
+import konkuk.thip.book.adapter.out.api.dto.BookDetailResult;
 import konkuk.thip.book.application.port.out.BookApiQueryPort;
 import konkuk.thip.book.domain.Book;
 import lombok.RequiredArgsConstructor;
@@ -13,17 +13,16 @@
 @RequiredArgsConstructor
 public class CompositeBookApiAdapter implements BookApiQueryPort {
 
-    private final NaverApiClient naverApiClient;
     private final AladinApiClient aladinApiClient;
 
     @Override
-    public NaverBookParseResult findBooksByKeyword(String keyword, int start) {
-        return naverApiClient.findBooksByKeyword(keyword, start);
+    public BookSearchResult findBooksByKeyword(String keyword, int start) {
+        return aladinApiClient.findBooksByKeyword(keyword, start);
     }
 
     @Override
-    public NaverDetailBookParseResult findDetailBookByIsbn(String isbn) {
-        return naverApiClient.findDetailBookByIsbn(isbn);
+    public BookDetailResult findDetailBookByIsbn(String isbn) {
+        return aladinApiClient.findDetailBookByIsbn(isbn);
     }
 
     @Override
@@ -33,22 +32,19 @@ public Integer findPageCountByIsbn(String isbn) {
 
     @Override
     public Book loadBookWithPageByIsbn(String isbn) {
-        // 1. naver 상세정보 조회 api 로 책 상세정보(without page) load
-        NaverDetailBookParseResult detailBookByKeyword = findDetailBookByIsbn(isbn);
+        // 상세정보 + page 정보를 알라딘 ItemLookUp 한 번의 호출로 함께 조회
+        AladinApiUtil.AladinDetailResult result = aladinApiClient.findDetailBookWithPageCountByIsbn(isbn);
+        BookDetailResult detail = result.detail();
 
-        // 2. 알라딘으로부터 책 page 정보 load
-        Integer pageCount = findPageCountByIsbn(isbn);
-
-        // 3. pageCount 정보를 포함한 Book 반환
         return Book.withoutId(
-                detailBookByKeyword.title(),
+                detail.title(),
                 isbn,
-                detailBookByKeyword.author(),
+                detail.author(),
                 false,      // TODO : 추후 BestSeller 도입되면 고려해야함
-                detailBookByKeyword.publisher(),
-                detailBookByKeyword.imageUrl(),
-                pageCount,
-                detailBookByKeyword.description()
+                detail.publisher(),
+                detail.imageUrl(),
+                result.pageCount(),
+                detail.description()
         );
     }
 }

src/main/java/konkuk/thip/book/adapter/out/api/aladin/AladinApiClient.java

@@ -1,5 +1,7 @@
 package konkuk.thip.book.adapter.out.api.aladin;
 
+import konkuk.thip.book.adapter.out.api.dto.BookSearchResult;
+import konkuk.thip.book.adapter.out.api.dto.BookDetailResult;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Component;
 
@@ -9,7 +11,19 @@ public class AladinApiClient {
 
     private final AladinApiUtil aladinApiUtil;
 
+    public BookSearchResult findBooksByKeyword(String keyword, int start) {
+        return aladinApiUtil.searchBooks(keyword, start);
+    }
+
+    public BookDetailResult findDetailBookByIsbn(String isbn) {
+        return aladinApiUtil.getBookDetail(isbn);
+    }
+
     public Integer findPageCountByIsbn(String isbn) {
         return aladinApiUtil.getPageCount(isbn);
     }
+
+    public AladinApiUtil.AladinDetailResult findDetailBookWithPageCountByIsbn(String isbn) {
+        return aladinApiUtil.getBookDetailWithPageCount(isbn);
+    }
 }

src/main/java/konkuk/thip/book/adapter/out/api/aladin/AladinApiParam.java

@@ -6,7 +6,9 @@ public enum AladinApiParam {
     OUTPUT("js"),
     API_VERSION("20131101"),
     SUB_INFO_PARSING_KEY("subInfo"),
-    PAGE_COUNT_PARSING_KEY("itemPage");
+    PAGE_COUNT_PARSING_KEY("itemPage"),
+    QUERY_TYPE("Keyword"),
+    SEARCH_TARGET("Book");
 
     private final String value;
 

src/main/java/konkuk/thip/book/adapter/out/api/aladin/AladinApiUtil.java

@@ -2,6 +2,8 @@
 
 import com.fasterxml.jackson.databind.JsonNode;
 import com.fasterxml.jackson.databind.ObjectMapper;
+import konkuk.thip.book.adapter.out.api.dto.BookSearchResult;
+import konkuk.thip.book.adapter.out.api.dto.BookDetailResult;
 import konkuk.thip.common.exception.ExternalApiException;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
@@ -10,16 +12,21 @@
 import org.springframework.web.client.RestTemplate;
 
 import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
 
 import static konkuk.thip.book.adapter.out.api.aladin.AladinApiParam.*;
-import static konkuk.thip.common.exception.code.ErrorCode.BOOK_ALADIN_API_ISBN_NOT_FOUND;
-import static konkuk.thip.common.exception.code.ErrorCode.BOOK_ALADIN_API_PARSING_ERROR;
+import static konkuk.thip.book.adapter.out.api.dto.BookSearchResult.PAGE_SIZE;
+import static konkuk.thip.common.exception.code.ErrorCode.*;
 
 @Component
 @RequiredArgsConstructor
 @Slf4j
 public class AladinApiUtil {
 
+    // 알라딘 정책상 한 검색어당 실제로 조회 가능한 결과는 최대 200건까지로 제한된다.
+    private static final int MAX_TOTAL_RESULTS = 200;
+
     private final RestTemplate restTemplate;
     private final ObjectMapper objectMapper;
 
@@ -29,6 +36,10 @@ public class AladinApiUtil {
     @Value("${aladin.baseUrl}")
     private String baseUrl;
 
+    @Value("${aladin.searchUrl}")
+    private String searchUrl;
+
+    public record AladinDetailResult(BookDetailResult detail, Integer pageCount) {}
 
     private String buildLookupUrl(String isbn) {
         return String.format(
@@ -41,7 +52,34 @@ private String buildLookupUrl(String isbn) {
         );
     }
 
+    // Query 값은 RestTemplate가 URI 템플릿 변수로 한 번만 인코딩하도록 {query} 플레이스홀더로 남겨둔다.
+    // 여기서 미리 URLEncoder로 인코딩해버리면 RestTemplate이 다시 인코딩(이중 인코딩)하여 키워드가 깨진다.
+    private String buildSearchUrlTemplate(int page) {
+        return String.format(
+                searchUrl + "ttbkey=%s&Query={query}&QueryType=%s&SearchTarget=%s&MaxResults=%s&start=%d&output=%s&Version=%s",
+                ttbKey,
+                QUERY_TYPE.getValue(),
+                SEARCH_TARGET.getValue(),
+                PAGE_SIZE,
+                page,
+                OUTPUT.getValue(),
+                API_VERSION.getValue()
+        );
+    }
+
     public Integer getPageCount(String isbn) {
+        return fetchDetail(isbn).pageCount();
+    }
+
+    public BookDetailResult getBookDetail(String isbn) {
+        return fetchDetail(isbn).detail();
+    }
+
+    public AladinDetailResult getBookDetailWithPageCount(String isbn) {
+        return fetchDetail(isbn);
+    }
+
+    private AladinDetailResult fetchDetail(String isbn) {
         String url = buildLookupUrl(isbn);
         String response = restTemplate.getForObject(url, String.class);
 
@@ -50,19 +88,63 @@ public Integer getPageCount(String isbn) {
             JsonNode items = jsonNode.path("item");
 
             // json 응답 결과에 item 키값이 없는 경우
+            // TODO : 알라딘으로부터 page 정보가 없으면 ??
+            // 보상 시나리오 : 유저에게 "page 정보를 찾을 수 없는 책입니다. 직접 page 정보를 입력하세요" 라고 안내
+            // 일단 지금은 exception throw 만 진행
             if (!items.isArray() || items.isEmpty()) {
-                // TODO : 알라딘으로부터 page 정보가 없으면 ??
-                // 보상 시나리오 : 유저에게 "page 정보를 찾을 수 없는 책입니다. 직접 page 정보를 입력하세요" 라고 안내
-                // 일단 지금은 exception throw 만 진행
                 throw new ExternalApiException(BOOK_ALADIN_API_ISBN_NOT_FOUND);
             }
 
-            JsonNode subInfo = items.get(0).path(SUB_INFO_PARSING_KEY.getValue());
+            JsonNode item = items.get(0);
+            JsonNode subInfo = item.path(SUB_INFO_PARSING_KEY.getValue());
+            int pageCount = subInfo.path(PAGE_COUNT_PARSING_KEY.getValue()).asInt();
 
-            return subInfo.path(PAGE_COUNT_PARSING_KEY.getValue()).asInt();
+            BookDetailResult detail = BookDetailResult.builder()
+                    .title(item.path("title").asText())
+                    .imageUrl(item.path("cover").asText())
+                    .author(item.path("author").asText())
+                    .publisher(item.path("publisher").asText())
+                    .isbn(item.path("isbn13").asText())
+                    .description(item.path("description").asText())
+                    .build();
+
+            return new AladinDetailResult(detail, pageCount);
         } catch (IOException e) {
             throw new ExternalApiException(BOOK_ALADIN_API_PARSING_ERROR);
         }
     }
-}
 
+    public BookSearchResult searchBooks(String keyword, int start) {
+        // BookSearchService가 넘기는 start는 (page-1)*PAGE_SIZE+1 형태의 아이템 오프셋이므로
+        // 알라딘이 요구하는 "페이지 번호"로 역산한다.
+        int page = ((start - 1) / PAGE_SIZE) + 1;
+        String urlTemplate = buildSearchUrlTemplate(page);
+        String response = restTemplate.getForObject(urlTemplate, String.class, keyword);
+
+        try {
+            JsonNode jsonNode = objectMapper.readTree(response);
+            // totalResults는 전체 매칭 건수를 그대로 보고하지만 실제로 조회 가능한 건 MAX_TOTAL_RESULTS까지뿐이므로,
+            // 페이지네이션(totalPages/last)이 정확히 그 지점에서 끝나도록 캡핑한다.
+            int total = Math.min(jsonNode.path("totalResults").asInt(), MAX_TOTAL_RESULTS);
+            int startIndex = jsonNode.path("startIndex").asInt();
+
+            List<BookSearchResult.BookSummary> books = new ArrayList<>();
+            JsonNode items = jsonNode.path("item");
+            if (items.isArray()) {
+                for (JsonNode item : items) {
+                    books.add(BookSearchResult.BookSummary.builder()
+                            .title(item.path("title").asText())
+                            .imageUrl(item.path("cover").asText())
+                            .author(item.path("author").asText())
+                            .publisher(item.path("publisher").asText())
+                            .isbn(item.path("isbn13").asText())
+                            .build());
+                }
+            }
+
+            return BookSearchResult.of(books, total, startIndex);
+        } catch (IOException e) {
+            throw new ExternalApiException(BOOK_ALADIN_API_PARSING_ERROR);
+        }
+    }
+}

src/main/java/konkuk/thip/book/adapter/out/api/dto/NaverDetailBookParseResult.java → src/main/java/konkuk/thip/book/adapter/out/api/dto/BookDetailResult.java

@@ -4,7 +4,7 @@
 import lombok.Builder;
 
 @Builder
-public record NaverDetailBookParseResult(
+public record BookDetailResult(
             String title,
             String imageUrl,
             String author,

src/main/java/konkuk/thip/book/adapter/out/api/dto/NaverBookParseResult.java → src/main/java/konkuk/thip/book/adapter/out/api/dto/BookSearchResult.java

@@ -5,19 +5,22 @@
 import java.util.List;
 
 
-public record NaverBookParseResult(
-        List<NaverBook> naverBooks,
+public record BookSearchResult(
+        List<BookSummary> books,
         int total,
         int start) {
+
+    public static final int PAGE_SIZE = 10;
+
     @Builder
-    public record NaverBook(
+    public record BookSummary(
             String title,
             String imageUrl,
             String author,
             String publisher,
             String isbn
     ) {}
-    public static NaverBookParseResult of(List<NaverBook> books, int total, int start) {
-        return new NaverBookParseResult(books, total, start);
+    public static BookSearchResult of(List<BookSummary> books, int total, int start) {
+        return new BookSearchResult(books, total, start);
     }
 }

src/main/java/konkuk/thip/book/adapter/out/api/naver/NaverApiClient.java

@@ -1,7 +1,7 @@
 package konkuk.thip.book.adapter.out.api.naver;
 
-import konkuk.thip.book.adapter.out.api.dto.NaverBookParseResult;
-import konkuk.thip.book.adapter.out.api.dto.NaverDetailBookParseResult;
+import konkuk.thip.book.adapter.out.api.dto.BookSearchResult;
+import konkuk.thip.book.adapter.out.api.dto.BookDetailResult;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Component;
 
@@ -11,12 +11,12 @@ public class NaverApiClient {
 
     private final NaverApiUtil naverApiUtil;
 
-    public NaverBookParseResult findBooksByKeyword(String keyword, int start) {
+    public BookSearchResult findBooksByKeyword(String keyword, int start) {
         String xml = naverApiUtil.searchBook(keyword, start); // 네이버 API 호출
         return NaverBookXmlParser.parseBookList(xml); // XML 파싱 + 페이징 정보 포함
     }
 
-    public NaverDetailBookParseResult findDetailBookByIsbn(String isbn) {
+    public BookDetailResult findDetailBookByIsbn(String isbn) {
         String xml = naverApiUtil.detailSearchBook(isbn); // 네이버 API 호출
         return NaverBookXmlParser.parseBookDetail(xml); // XML 파싱
     }