[feat] 책 검색 api 개발

src/main/java/konkuk/thip/book/adapter/in/web/BookQueryController.java

@@ -1,10 +1,23 @@
 package konkuk.thip.book.adapter.in.web;
 
+import konkuk.thip.book.adapter.in.web.response.GetBookSearchListResponse;
+import konkuk.thip.book.adapter.out.api.dto.NaverBookParseResult;
+import konkuk.thip.book.application.port.in.BookSearchUseCase;
+import konkuk.thip.common.dto.BaseResponse;
 import lombok.RequiredArgsConstructor;
-import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.bind.annotation.*;
 
 @RestController
 @RequiredArgsConstructor
 public class BookQueryController {
 
+    private final BookSearchUseCase bookSearchUseCase;
+
+    @GetMapping("/books")
+    public BaseResponse<GetBookSearchListResponse> getBookSearchList(@RequestParam final String keyword,
+                                                                     @RequestParam final int page) {
+        NaverBookParseResult result = bookSearchUseCase.searchBooks(keyword, page);
+        return BaseResponse.ok(GetBookSearchListResponse.of(result, page));
+    }
+
 }

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

@@ -0,0 +1,57 @@
+package konkuk.thip.book.adapter.in.web.response;
+
+import konkuk.thip.book.adapter.out.api.dto.NaverBookParseResult;
+import lombok.Builder;
+
+import java.util.List;
+
+import static konkuk.thip.book.adapter.out.api.NaverApiUtil.PAGE_SIZE;
+
+@Builder
+public record GetBookSearchListResponse(
+        List<BookDto> searchResult, // 책 목록
+        int page,                   // 현재 페이지 (1부터 시작)
+        int size,                   // 한 페이지에 포함되는 데이터 수 (페이지 크기)
+        long totalElements,         // 전체 데이터 개수
+        int totalPages,             // 전체 페이지 수
+        boolean last,               // 마지막 페이지 여부
+        boolean first               // 첫 페이지 여부
+) {
+    public static GetBookSearchListResponse of(NaverBookParseResult 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<BookDto> bookDtos = result.naverBooks().stream()
+                .map(BookDto::of)
+                .toList();
+
+        return new GetBookSearchListResponse(
+                bookDtos,
+                page,
+                PAGE_SIZE,
+                totalElements,
+                totalPages,
+                last,
+                first
+        );
+    }
+    public record BookDto(
+            String title,
+            String imageUrl,
+            String authorName,
+            String publisher,
+            String isbn
+    ) {
+        public static BookDto of(NaverBookParseResult.NaverBook naverBook) {
+            return new BookDto(
+                    naverBook.title(),
+                    naverBook.imageUrl(),
+                    naverBook.author(),
+                    naverBook.publisher(),
+                    naverBook.isbn()
+            );
+        }
+    }
+}

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

@@ -0,0 +1,19 @@
+package konkuk.thip.book.adapter.out.api;
+
+import konkuk.thip.book.adapter.out.api.dto.NaverBookParseResult;
+import konkuk.thip.book.application.port.out.SearchBookQueryPort;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+
+@Component
+@RequiredArgsConstructor
+public class BookApiAdapter implements SearchBookQueryPort {
+
+    private final NaverApiUtil naverApiUtil;
+
+    @Override
+    public NaverBookParseResult findBooksByKeyword(String keyword, int start) {
+        String xml = naverApiUtil.searchBook(keyword, start); // 네이버 API 호출
+        return NaverBookXmlParser.parse(xml);                // XML 파싱 + 페이징 정보 포함
+    }
+}

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

@@ -0,0 +1,108 @@
+package konkuk.thip.book.adapter.out.api;
+
+import konkuk.thip.common.exception.BusinessException;
+import lombok.RequiredArgsConstructor;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.stereotype.Component;
+
+import java.io.*;
+import java.net.HttpURLConnection;
+import java.net.MalformedURLException;
+import java.net.URL;
+import java.net.URLEncoder;
+import java.util.HashMap;
+import java.util.Map;
+
+import static konkuk.thip.common.exception.code.ErrorCode.*;
+
+@RequiredArgsConstructor
+@Component
+public class NaverApiUtil {
+
+    @Value("${naver.clientId}")
+    private String clientId;
+    @Value("${naver.clientSecret}")
+    private String clientSecret;
+    @Value("${naver.bookSearchUrl}")
+    private String bookSearchUrl;
+
+    public static final int PAGE_SIZE = 10;
+
+    public String searchBook(String keyword, int start){
+        String query = keywordToEncoding(keyword);
+        String url = buildSearchApiUrl(query, start);
+
+        Map<String, String> requestHeaders = new HashMap<>();
+        requestHeaders.put("X-Naver-Client-Id", clientId);
+        requestHeaders.put("X-Naver-Client-Secret", clientSecret);
+
+        return get(url,requestHeaders);
+    }
+
+    private String buildSearchApiUrl(String query,Integer start) {
+        return bookSearchUrl+query+"&display="+PAGE_SIZE+"&start="+start;
+    }
+
+    private String keywordToEncoding(String keyword) {
+        String text = null;
+        try {
+            text = URLEncoder.encode(keyword, "UTF-8");
+        } catch (UnsupportedEncodingException e) {
+            throw new BusinessException(BOOK_KEYWORD_ENCODING_FAILED);
+        }
+        return text;
+    }
+
+
+    String get(String apiUrl, Map<String, String> requestHeaders){
+        HttpURLConnection con = connect(apiUrl);
+        try {
+            con.setRequestMethod("GET");
+            for(Map.Entry<String, String> header :requestHeaders.entrySet()) {
+                con.setRequestProperty(header.getKey(), header.getValue());
+            }
+
+            int responseCode = con.getResponseCode();
+            if (responseCode == HttpURLConnection.HTTP_OK) { // 정상 호출
+                return readBody(con.getInputStream());
+            } else { // 오류 발생
+                return readBody(con.getErrorStream());
+            }
+        } catch (IOException e) {
+            throw new BusinessException(BOOK_NAVER_API_REQUEST_ERROR);
+        } finally {
+            con.disconnect();
+        }
+    }
+
+
+    private HttpURLConnection connect(String apiUrl){
+        try {
+            URL url = new URL(apiUrl);
+            return (HttpURLConnection)url.openConnection();
+        } catch (MalformedURLException e) {
+            throw new BusinessException(BOOK_NAVER_API_URL_ERROR);
+        } catch (IOException e) {
+            throw new BusinessException(BOOK_NAVER_API_URL_HTTP_CONNECT_FAILED);
+        }
+    }
+
+
+    private String readBody(InputStream body){
+        InputStreamReader streamReader = new InputStreamReader(body);
+
+        try (BufferedReader lineReader = new BufferedReader(streamReader)) {
+            StringBuilder responseBody = new StringBuilder();
+
+            String line;
+            while ((line = lineReader.readLine()) != null) {
+                responseBody.append(line);
+            }
+
+            return responseBody.toString();
+        } catch (IOException e) {
+            throw new BusinessException(BOOK_NAVER_API_RESPONSE_ERROR);
+        }
+    }
+
+}

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

@@ -0,0 +1,63 @@
+package konkuk.thip.book.adapter.out.api;
+
+import konkuk.thip.book.adapter.out.api.dto.NaverBookParseResult;
+import konkuk.thip.common.exception.BusinessException;
+import konkuk.thip.common.exception.code.ErrorCode;
+import org.w3c.dom.*;
+import javax.xml.parsers.*;
+import java.io.StringReader;
+import java.util.ArrayList;
+import java.util.List;
+import org.xml.sax.InputSource;
+
+public class NaverBookXmlParser {
+
+    public static NaverBookParseResult parse(String xml) {
+        List<NaverBookParseResult.NaverBook> Naverbooks = new ArrayList<>();
+        int total = -1;
+        int start = -1;
+        try {
+            DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
+            DocumentBuilder builder = factory.newDocumentBuilder();
+            InputSource is = new InputSource(new StringReader(xml));
+            Document doc = builder.parse(is);
+
+            NodeList channelNodes = doc.getElementsByTagName("channel");
+            if (channelNodes.getLength() > 0) {
+                Element channel = (Element) channelNodes.item(0);
+                total = Integer.parseInt(getTagValue(channel, "total"));
+                start = Integer.parseInt(getTagValue(channel, "start"));
+
+                NodeList itemNodes = channel.getElementsByTagName("item");
+                for (int i = 0; i < itemNodes.getLength(); i++) {
+                    Element item = (Element) itemNodes.item(i);
+                    String title = getTagValue(item, "title");
+                    String imageUrl = getTagValue(item, "image");
+                    String author = getTagValue(item, "author");
+                    String publisher = getTagValue(item, "publisher");
+                    String isbn = getTagValue(item, "isbn");
+                    NaverBookParseResult.NaverBook naverBook = NaverBookParseResult.NaverBook.builder()
+                            .title(title)
+                            .imageUrl(imageUrl)
+                            .author(author)
+                            .publisher(publisher)
+                            .isbn(isbn)
+                            .build();
+                    Naverbooks.add(naverBook);
+                }
+            }
+        } catch (Exception e) {
+           throw new BusinessException(ErrorCode.BOOK_NAVER_API_PARSING_ERROR);
+        }
+        return NaverBookParseResult.of(Naverbooks, total, start);
+    }
+
+    private static String getTagValue(Element element, String tag) {
+        NodeList nodeList = element.getElementsByTagName(tag);
+        if (nodeList.getLength() > 0 && nodeList.item(0).getFirstChild() != null) {
+            return nodeList.item(0).getFirstChild().getNodeValue();
+        }
+        return "";
+    }
+
+}

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

@@ -0,0 +1,23 @@
+package konkuk.thip.book.adapter.out.api.dto;
+
+import lombok.Builder;
+
+import java.util.List;
+
+
+public record NaverBookParseResult(
+        List<NaverBook> naverBooks,
+        int total,
+        int start) {
+    @Builder
+    public record NaverBook(
+            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);
+    }
+}

src/main/java/konkuk/thip/book/application/port/in/BookSearchUseCase.java

@@ -0,0 +1,9 @@
+package konkuk.thip.book.application.port.in;
+
+import konkuk.thip.book.adapter.out.api.dto.NaverBookParseResult;
+
+public interface BookSearchUseCase {
+
+    NaverBookParseResult searchBooks(String keyword, int page);
+
+}

src/main/java/konkuk/thip/book/application/port/out/SearchBookQueryPort.java

@@ -0,0 +1,7 @@
+package konkuk.thip.book.application.port.out;
+
+import konkuk.thip.book.adapter.out.api.dto.NaverBookParseResult;
+
+public interface SearchBookQueryPort {
+    NaverBookParseResult findBooksByKeyword(String keyword, int start);
+}

src/main/java/konkuk/thip/book/application/service/BookSearchService.java

@@ -0,0 +1,44 @@
+package konkuk.thip.book.application.service;
+
+import konkuk.thip.book.adapter.out.api.dto.NaverBookParseResult;
+import konkuk.thip.book.application.port.in.BookSearchUseCase;
+import konkuk.thip.book.application.port.out.SearchBookQueryPort;
+import konkuk.thip.common.exception.BusinessException;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+
+import static konkuk.thip.book.adapter.out.api.NaverApiUtil.PAGE_SIZE;
+import static konkuk.thip.common.exception.code.ErrorCode.*;
+
+@Service
+@RequiredArgsConstructor
+public class BookSearchService implements BookSearchUseCase {
+
+    private final SearchBookQueryPort searchBookQueryPort;
+
+    @Override
+    public NaverBookParseResult searchBooks(String keyword, int page) {
+
+        if (keyword == null || keyword.isBlank()) {
+            throw new BusinessException(BOOK_KEYWORD_REQUIRED);
+        }
+
+        if (page < 1) {
+            throw new BusinessException(BOOK_PAGE_NUMBER_INVALID);
+        }
+
+        //유저의 최근검색어 로직 추가
+
+        int start = (page - 1) * PAGE_SIZE + 1; //검색 시작 위치
+        NaverBookParseResult result = searchBookQueryPort.findBooksByKeyword(keyword, start);
+
+        int totalElements = result.total();
+        int totalPages = (totalElements + PAGE_SIZE - 1) / PAGE_SIZE;
+        if ( totalElements!=0 && page > totalPages) {
+            throw new BusinessException(BOOK_SEARCH_PAGE_OUT_OF_RANGE);
+        }
+
+        return result;
+    }
+
+}

src/main/java/konkuk/thip/common/dto/ErrorResponse.java

@@ -8,7 +8,7 @@
 @JsonPropertyOrder({"success", "code", "message"})
 public class ErrorResponse {
 
-    @JsonProperty("isSuccess:")
+    @JsonProperty("isSuccess")
     private final boolean success;
 
     private final int code;