✨Feature/#4 공공데이터 저장

* 📦Chore: API 응답 파싱을 위한 의존성 라이브러리, 환경변수 추가

* ✨Feat: API 요청용 객체 추가

* 📦 Chore: 주석 추가

* ✨ Feat: 의약품 상세정보 API 호출 개발

* ✨ Feat: 샘플 검색 데이터 추출 개발

* ✨ Feat: 공공데이터 API 파싱 개발

* ♻️ Refactor: 파싱을 위한 Wrappeer 클래스 정리 (인터페이스 추가)

* ♻️ Refactor: 불필요한 생성자 삭제

* ♻️ Refactor: aricle parsing 가독성 개선

* 🐛 Fix: SectionWrapper parseElement 오타 수정

* ♻️ Refactor: 로직 수정 및 가독성 개선

* ♻️ Refactor: Paragraph 파싱 수정 및 헥사고날 아키텍처 적용

* ♻️ Refactor: 도메인 메소드 접근자 변경

* 📦 gitignore 수정 및 재 커밋

* ♻️ Refactor: 공공데이터 개요정보 API 파싱 수정

* ✨ Feat: API 전체 데이터 저장

* ✨ Feat: api 전체 데이터 저장

* 🐛 Fix: Xml 파서에 null 체크 로직 추가

* ✨  Feat: 공공데이터 전체 저장 기능 개발

* ♻️  Refactor: 전체 데이터 저장 함수 리팩토링

---------

Co-authored-by: HaechangLee <112938092+HaechangLee@users.noreply.github.com>

---------

Co-authored-by: HaechangLee <112938092+HaechangLee@users.noreply.github.com>

Author: thelightway24

build.gradle

@@ -42,7 +42,6 @@ dependencies {
     implementation 'com.fasterxml.jackson.dataformat:jackson-dataformat-xml'
     implementation 'org.springframework.boot:spring-boot-starter-jdbc'
 
-
     // Elastic search
     implementation 'org.springframework.boot:spring-boot-starter-data-elasticsearch'
     implementation 'org.elasticsearch.client:elasticsearch-rest-high-level-client:7.17.10'

src/main/java/com/likelion/backendplus4/yakplus/scraper/drug/ApiResponseMapper.java

@@ -0,0 +1,41 @@
+package com.likelion.backendplus4.yakplus.scraper.drug;
+
+import org.springframework.stereotype.Component;
+
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+
+import lombok.extern.slf4j.Slf4j;
+
+@Slf4j
+public class ApiResponseMapper {
+
+	public static JsonNode getItemsFromResponse(String response) {
+		log.info("응답에서 items 값 추출");
+		try {
+			return new ObjectMapper().readTree(response)
+				.path("body")
+				.path("items");
+		} catch (JsonProcessingException e) {
+			log.error("items 추출 실패");
+			//TODO: CustomException 만들고, ControllerAdvice로 예외처리 필요
+			throw new RuntimeException(e);
+		}
+	}
+
+	public static int getTotalCountFromResponse(String response) {
+		log.info("응답에서 데이터 사이즈 추출");
+		try {
+			return new ObjectMapper().readTree(response)
+				.path("body")
+				.path("totalCount")
+				.asInt();
+		} catch (JsonProcessingException e) {
+			log.error("totalCount 추출 실패");
+			//TODO: CustomException 만들고, ControllerAdvice로 예외처리 필요
+			throw new RuntimeException(e);
+		}
+	}
+
+}

src/main/java/com/likelion/backendplus4/yakplus/scraper/drug/ApiRestTemplateConfig.java

@@ -0,0 +1,19 @@
+package com.likelion.backendplus4.yakplus.scraper.drug;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.web.client.RestTemplate;
+
+/**
+ * Api 요청을 보내기 위한 RestTemplate 빈 생성
+ *
+ * @since 2025-04-15
+ * @author 함예정
+ */
+@Configuration
+public class ApiRestTemplateConfig {
+	@Bean
+	public RestTemplate restTemplate() {
+		return new RestTemplate();
+	}
+}

src/main/java/com/likelion/backendplus4/yakplus/scraper/drug/detail/ApiDataDrugJPARepo.java

@@ -0,0 +1,10 @@
+package com.likelion.backendplus4.yakplus.scraper.drug.detail;
+
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import com.likelion.backendplus4.yakplus.scraper.drug.detail.adapter.out.persistence.GovDrugDetailEntity;
+
+@Repository
+public interface ApiDataDrugJPARepo extends JpaRepository<GovDrugDetailEntity, Long> {
+}

src/main/java/com/likelion/backendplus4/yakplus/scraper/drug/detail/adapter/in/batch/BatchConfig.java

@@ -0,0 +1,5 @@
+package com.likelion.backendplus4.yakplus.scraper.drug.detail.adapter.in.batch;
+
+public class BatchConfig {
+	//TODO: 추후 배치로 분리
+}

src/main/java/com/likelion/backendplus4/yakplus/scraper/drug/detail/adapter/in/batch/JobLauncher.java

@@ -0,0 +1,5 @@
+package com.likelion.backendplus4.yakplus.scraper.drug.detail.adapter.in.batch;
+
+public class JobLauncher {
+	//TODO: 추후 배치로 분리
+}

src/main/java/com/likelion/backendplus4/yakplus/scraper/drug/detail/adapter/in/web/DrugDetailController.java

@@ -0,0 +1,27 @@
+package com.likelion.backendplus4.yakplus.scraper.drug.detail.adapter.in.web;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.stereotype.Controller;
+import org.springframework.web.bind.annotation.GetMapping;
+
+import com.likelion.backendplus4.yakplus.scraper.drug.detail.application.port.in.DrugApprovalDetailScraperUseCase;
+
+import lombok.RequiredArgsConstructor;
+
+@Controller
+@RequiredArgsConstructor
+public class DrugDetailController {
+	private final DrugApprovalDetailScraperUseCase scraperUseCase;
+
+	@GetMapping("/gov/api/parser/detail/start")
+	public ResponseEntity saveAPIData(){
+		scraperUseCase.requestUpdateRawData();
+		return ResponseEntity.ok().build();
+	}
+
+	@GetMapping("/gov/api/parser/detail/startAll")
+	public ResponseEntity saveAPIDataAll(){
+		scraperUseCase.requestUpdateAllRawData();
+		return ResponseEntity.ok().build();
+	}
+}

src/main/java/com/likelion/backendplus4/yakplus/scraper/drug/detail/adapter/out/gov/ApiUriCompBuilder.java

@@ -0,0 +1,100 @@
+package com.likelion.backendplus4.yakplus.scraper.drug.detail.adapter.out.gov;
+
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.stereotype.Component;
+import org.springframework.web.util.UriComponentsBuilder;
+
+import java.net.URI;
+
+/***
+ * API 요청 URI 객체 생성 빌더
+ *
+ * application.yml에서 주입되는 속성 값으로,
+ * API HOST, PATH를 확인해 URI 객체를 만듭니다.
+ *
+ * @since 2025-04-15
+ * @author 함예정
+ */
+@Component
+public class ApiUriCompBuilder {
+    private final String SERVICE_KEY;
+    private final String HOST;
+    private final String API_DETAIL_PATH;
+    private final String API_IMG_PATH ;
+    private final String RESPONSE_TYPE;
+
+    public ApiUriCompBuilder(@Value("${gov.host}") String host,
+                            @Value("${gov.serviceKey}") String serviceKey,
+                            @Value("${gov.path.detail}") String pathDetail,
+                            @Value("${gov.path.img}") String pathImg,
+                            @Value("${gov.type}") String type) {
+        this.HOST = host;
+        this.SERVICE_KEY = serviceKey;
+        this.API_DETAIL_PATH = pathDetail;
+        this.API_IMG_PATH = pathImg;
+        this.RESPONSE_TYPE = type;
+    }
+
+    /***
+     * 입력 받은 path를 반영해 URI 객체를 생성, 반환
+     *
+     * @param path API 요청 경로
+     * @return URI
+     *
+     * @since 2025-04-15
+     * @author 함예정
+     */
+    private URI getUri(String path, int pageNo) {
+        return UriComponentsBuilder.newInstance()
+            .scheme("https")
+            .host(HOST)
+            .port(443)
+            .path(path)
+            .queryParam("serviceKey", SERVICE_KEY)
+            .queryParam("type", RESPONSE_TYPE)
+            .queryParam("pageNo", pageNo)
+            .queryParam("numOfRows", 100)
+            .build(true)
+            .toUri();
+    }
+
+    /***
+     * 식품의약품안전처 의약품 제품 허가 상세 정보 URI 반환
+     * @return URI 제품 허가 상세 정보
+     * 
+     * @since 2025-04-15
+     * @author 함예정
+     */
+    public URI getUriForDetailApi(int pageNo) {
+        return getUri(API_DETAIL_PATH, pageNo);
+    }
+
+    /***
+     * 식품의약품안전처 의약품 제품 허가 목록 URI 반환
+     * @return URI 제품 허가 목록
+     *
+     * @since 2025-04-15
+     * @author 함예정
+     */
+    public URI getUriForImgApi(int pageNo) {
+        return getUri(API_IMG_PATH, pageNo);
+    }
+
+    // TODO 추후 삭제
+    public URI getUriForImgApiBySeq(String seq) {
+        // 임시 URI
+        return UriComponentsBuilder.newInstance()
+            .scheme("https")
+            .host(HOST)
+            .port(443)
+            .path(API_IMG_PATH)
+            .queryParam("serviceKey", SERVICE_KEY)
+            .queryParam("type", RESPONSE_TYPE)
+            .queryParam("numOfRows", 1)
+            .queryParam("prdlst_Stdr_code", seq)
+            .build(true)
+            .toUri();
+
+    }
+
+}

src/main/java/com/likelion/backendplus4/yakplus/scraper/drug/detail/adapter/out/parser/MaterialParser.java

@@ -0,0 +1,59 @@
+package com.likelion.backendplus4.yakplus.scraper.drug.detail.adapter.out.parser;
+
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.node.ArrayNode;
+import com.fasterxml.jackson.databind.node.ObjectNode;
+
+public class MaterialParser {
+	public static String parseMaterial(String raw) throws Exception {
+		ObjectMapper result = new ObjectMapper();
+		ArrayNode resultArray = result.createArrayNode();
+		String[] blocks = splitBlock(raw);
+		parsingblocksAndPutArrayItem(blocks, resultArray);
+		return convertString(result, resultArray);
+	}
+
+	private static void parsingblocksAndPutArrayItem(String[] blocks, ArrayNode resultArray) {
+		for (String block : blocks) {
+			block = block.trim();
+			if (block.isEmpty()) {
+				continue;
+			}
+			String[] pairs = splitByPipe(block);
+			ObjectNode item = makeItem(pairs);
+			resultArray.add(item);
+		}
+	}
+
+	private static String convertString(ObjectMapper objectMapper, ArrayNode arrayNode) {
+		try {
+			return objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(arrayNode);
+		} catch (JsonProcessingException e) {
+			//TODO String 변환실패
+			throw new RuntimeException(e);
+		}
+	}
+
+	private static ObjectNode makeItem(String[] pairs) {
+		ObjectNode item = new ObjectMapper().createObjectNode();
+		for (String pair : pairs) {
+			String[] kv = pair.split(":", 2);
+			String key = kv[0].trim();
+			String value = "";
+			if(kv.length == 2){
+				value = kv[1].trim();
+			}
+			item.put(key, value);
+		}
+		return item;
+	}
+
+	private static String[] splitByPipe(String block) {
+		return block.split("\\|");
+	}
+
+	private static String[] splitBlock(String raw) {
+		return raw.split(";");
+	}
+}