박성영
1 month ago
parent
b160476ddc
commit
6c677f7f69
@ -0,0 +1,802 @@
|
|||||||
|
# VMIS 통합 전략 설계 문서
|
||||||
|
|
||||||
|
**작성일**: 2025-11-06
|
||||||
|
**목적**: 설정 기반으로 내부/외부 차량 정보 조회 방식을 선택할 수 있는 아키텍처 설계
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 목차
|
||||||
|
|
||||||
|
1. [요구사항](#1-요구사항)
|
||||||
|
2. [아키텍처 설계](#2-아키텍처-설계)
|
||||||
|
3. [구현 가이드](#3-구현-가이드)
|
||||||
|
4. [설정 예시](#4-설정-예시)
|
||||||
|
5. [테스트 방법](#5-테스트-방법)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. 요구사항
|
||||||
|
|
||||||
|
### 1.1 핵심 요구사항
|
||||||
|
|
||||||
|
**application.yml 설정에 따라 두 가지 방식 중 선택 가능**:
|
||||||
|
|
||||||
|
1. **Internal Mode (내부 모드)**
|
||||||
|
- 신규 통합된 VMIS 모듈을 직접 호출
|
||||||
|
- 네트워크 오버헤드 없음
|
||||||
|
- 단일 트랜잭션 처리 가능
|
||||||
|
- 높은 성능
|
||||||
|
|
||||||
|
2. **External Mode (외부 모드)**
|
||||||
|
- 기존 ExternalVehicleApiService를 통해 외부 REST API 호출
|
||||||
|
- 독립적인 VMIS-interface 서버와 통신
|
||||||
|
- 기존 방식 유지 (하위 호환성)
|
||||||
|
|
||||||
|
### 1.2 전환 시나리오
|
||||||
|
|
||||||
|
- **개발 단계**: External 모드로 테스트 (기존 방식)
|
||||||
|
- **통합 테스트**: Internal 모드로 전환하여 성능 검증
|
||||||
|
- **점진적 배포**: 일부 서버는 External, 일부는 Internal
|
||||||
|
- **롤백 대비**: 문제 발생 시 External 모드로 즉시 전환
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. 아키텍처 설계
|
||||||
|
|
||||||
|
### 2.1 전략 패턴 (Strategy Pattern) 적용
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────┐
|
||||||
|
│ VehicleInfoServiceFacade │ (클라이언트 코드)
|
||||||
|
│ - getBasicInfo(vhrno) │
|
||||||
|
│ - getLedgerInfo(vhrno) │
|
||||||
|
└─────────────────┬───────────────────────┘
|
||||||
|
│ 의존
|
||||||
|
↓
|
||||||
|
┌─────────────────────────────────────────┐
|
||||||
|
│ <<interface>> │
|
||||||
|
│ VehicleInfoService │ (전략 인터페이스)
|
||||||
|
│ + getBasicInfo(vhrno): ResponseDTO │
|
||||||
|
│ + getLedgerInfo(vhrno): ResponseDTO │
|
||||||
|
└─────────────────┬───────────────────────┘
|
||||||
|
│
|
||||||
|
┌────────┴─────────┐
|
||||||
|
↓ ↓
|
||||||
|
┌──────────────────┐ ┌─────────────────────────┐
|
||||||
|
│ Internal모드 │ │ External모드 │
|
||||||
|
│ │ │ │
|
||||||
|
│ Internal │ │ External │
|
||||||
|
│ VehicleInfo │ │ VehicleInfo │
|
||||||
|
│ ServiceImpl │ │ ServiceImpl │
|
||||||
|
│ │ │ │
|
||||||
|
│ @Conditional │ │ @Conditional │
|
||||||
|
│ OnProperty │ │ OnProperty │
|
||||||
|
│ (internal) │ │ (external) │
|
||||||
|
│ │ │ │
|
||||||
|
│ ↓ │ │ ↓ │
|
||||||
|
│ VMIS 모듈 │ │ RestTemplate │
|
||||||
|
│ 직접 호출 │ │ (HTTP 호출) │
|
||||||
|
└──────────────────┘ └─────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2.2 컴포넌트 설계
|
||||||
|
|
||||||
|
#### 2.2.1 인터페이스
|
||||||
|
|
||||||
|
**VehicleInfoService.java** (전략 인터페이스)
|
||||||
|
```java
|
||||||
|
package go.kr.project.common.service;
|
||||||
|
|
||||||
|
import go.kr.project.common.vo.VehicleBasicInfoResponseVO;
|
||||||
|
import go.kr.project.common.vo.VehicleLedgerResponseVO;
|
||||||
|
|
||||||
|
public interface VehicleInfoService {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 차량 기본정보 조회
|
||||||
|
* @param vhrno 차량번호
|
||||||
|
* @return 차량 기본정보 응답
|
||||||
|
*/
|
||||||
|
VehicleBasicInfoResponseVO getBasicInfo(String vhrno);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 차량 등록원부 조회
|
||||||
|
* @param vhrno 차량번호
|
||||||
|
* @return 차량 등록원부 응답
|
||||||
|
*/
|
||||||
|
VehicleLedgerResponseVO getLedgerInfo(String vhrno);
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 2.2.2 구현체 1: Internal Mode
|
||||||
|
|
||||||
|
**InternalVehicleInfoServiceImpl.java**
|
||||||
|
```java
|
||||||
|
package go.kr.project.vmis.service;
|
||||||
|
|
||||||
|
import go.kr.project.common.service.VehicleInfoService;
|
||||||
|
import go.kr.project.common.vo.*;
|
||||||
|
import go.kr.project.vmis.service.CarBassMatterInqireService;
|
||||||
|
import go.kr.project.vmis.service.CarLedgerFrmbkService;
|
||||||
|
import go.kr.project.vmis.model.vo.*;
|
||||||
|
import lombok.RequiredArgsConstructor;
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
|
||||||
|
import org.springframework.stereotype.Service;
|
||||||
|
|
||||||
|
@Slf4j
|
||||||
|
@Service
|
||||||
|
@RequiredArgsConstructor
|
||||||
|
@ConditionalOnProperty(name = "vmis.integration.mode", havingValue = "internal")
|
||||||
|
public class InternalVehicleInfoServiceImpl implements VehicleInfoService {
|
||||||
|
|
||||||
|
private final CarBassMatterInqireService carBassMatterInqireService;
|
||||||
|
private final CarLedgerFrmbkService carLedgerFrmbkService;
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public VehicleBasicInfoResponseVO getBasicInfo(String vhrno) {
|
||||||
|
log.info("[INTERNAL MODE] 차량 기본정보 조회 - 차량번호: {}", vhrno);
|
||||||
|
|
||||||
|
try {
|
||||||
|
// 내부 VMIS 모듈 직접 호출
|
||||||
|
CarBassMatterInqireRequestVO request = new CarBassMatterInqireRequestVO();
|
||||||
|
request.setVhrno(vhrno);
|
||||||
|
|
||||||
|
Envelope<VehicleBasicInfoDTO> response =
|
||||||
|
carBassMatterInqireService.getBasicInfo(request);
|
||||||
|
|
||||||
|
// DTO → VO 변환
|
||||||
|
return convertToBasicInfoResponse(response);
|
||||||
|
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.error("[INTERNAL MODE] 차량 기본정보 조회 실패 - 차량번호: {}", vhrno, e);
|
||||||
|
return createErrorResponse(vhrno, e.getMessage());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public VehicleLedgerResponseVO getLedgerInfo(String vhrno) {
|
||||||
|
log.info("[INTERNAL MODE] 차량 등록원부 조회 - 차량번호: {}", vhrno);
|
||||||
|
|
||||||
|
try {
|
||||||
|
// 내부 VMIS 모듈 직접 호출
|
||||||
|
CarLedgerFrmbkRequestVO request = new CarLedgerFrmbkRequestVO();
|
||||||
|
request.setVhrno(vhrno);
|
||||||
|
|
||||||
|
Envelope<VehicleLedgerDTO> response =
|
||||||
|
carLedgerFrmbkService.getLedgerInfo(request);
|
||||||
|
|
||||||
|
// DTO → VO 변환
|
||||||
|
return convertToLedgerResponse(response);
|
||||||
|
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.error("[INTERNAL MODE] 차량 등록원부 조회 실패 - 차량번호: {}", vhrno, e);
|
||||||
|
return createLedgerErrorResponse(vhrno, e.getMessage());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// DTO → VO 변환 메서드들...
|
||||||
|
private VehicleBasicInfoResponseVO convertToBasicInfoResponse(Envelope<VehicleBasicInfoDTO> envelope) {
|
||||||
|
// 구현...
|
||||||
|
}
|
||||||
|
|
||||||
|
private VehicleLedgerResponseVO convertToLedgerResponse(Envelope<VehicleLedgerDTO> envelope) {
|
||||||
|
// 구현...
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 2.2.3 구현체 2: External Mode
|
||||||
|
|
||||||
|
**ExternalVehicleInfoServiceImpl.java**
|
||||||
|
```java
|
||||||
|
package go.kr.project.externalApi.service;
|
||||||
|
|
||||||
|
import go.kr.project.common.service.VehicleInfoService;
|
||||||
|
import go.kr.project.common.vo.*;
|
||||||
|
import lombok.RequiredArgsConstructor;
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.beans.factory.annotation.Value;
|
||||||
|
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
|
||||||
|
import org.springframework.stereotype.Service;
|
||||||
|
import org.springframework.web.client.RestTemplate;
|
||||||
|
|
||||||
|
@Slf4j
|
||||||
|
@Service
|
||||||
|
@RequiredArgsConstructor
|
||||||
|
@ConditionalOnProperty(name = "vmis.integration.mode", havingValue = "external", matchIfMissing = true)
|
||||||
|
public class ExternalVehicleInfoServiceImpl implements VehicleInfoService {
|
||||||
|
|
||||||
|
private final RestTemplate restTemplate;
|
||||||
|
|
||||||
|
@Value("${vmis.external.api.url:http://localhost:8081/api/v1/vehicles}")
|
||||||
|
private String vmisApiUrl;
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public VehicleBasicInfoResponseVO getBasicInfo(String vhrno) {
|
||||||
|
log.info("[EXTERNAL MODE] 차량 기본정보 조회 - 차량번호: {}", vhrno);
|
||||||
|
|
||||||
|
try {
|
||||||
|
String url = vmisApiUrl + "/basic";
|
||||||
|
|
||||||
|
// 기존 ExternalVehicleApiService 로직 활용
|
||||||
|
// RestTemplate으로 외부 API 호출
|
||||||
|
VehicleBasicRequestVO request = new VehicleBasicRequestVO();
|
||||||
|
request.setVhrno(vhrno);
|
||||||
|
|
||||||
|
VehicleBasicInfoResponseVO response = restTemplate.postForObject(
|
||||||
|
url,
|
||||||
|
request,
|
||||||
|
VehicleBasicInfoResponseVO.class
|
||||||
|
);
|
||||||
|
|
||||||
|
return response;
|
||||||
|
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.error("[EXTERNAL MODE] 차량 기본정보 조회 실패 - 차량번호: {}", vhrno, e);
|
||||||
|
return createErrorResponse(vhrno, e.getMessage());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public VehicleLedgerResponseVO getLedgerInfo(String vhrno) {
|
||||||
|
log.info("[EXTERNAL MODE] 차량 등록원부 조회 - 차량번호: {}", vhrno);
|
||||||
|
|
||||||
|
try {
|
||||||
|
String url = vmisApiUrl + "/ledger";
|
||||||
|
|
||||||
|
VehicleLedgerRequestVO request = new VehicleLedgerRequestVO();
|
||||||
|
request.setVhrno(vhrno);
|
||||||
|
|
||||||
|
VehicleLedgerResponseVO response = restTemplate.postForObject(
|
||||||
|
url,
|
||||||
|
request,
|
||||||
|
VehicleLedgerResponseVO.class
|
||||||
|
);
|
||||||
|
|
||||||
|
return response;
|
||||||
|
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.error("[EXTERNAL MODE] 차량 등록원부 조회 실패 - 차량번호: {}", vhrno, e);
|
||||||
|
return createLedgerErrorResponse(vhrno, e.getMessage());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 2.2.4 설정 클래스
|
||||||
|
|
||||||
|
**VmisIntegrationConfig.java**
|
||||||
|
```java
|
||||||
|
package go.kr.project.vmis.config;
|
||||||
|
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
|
||||||
|
import org.springframework.boot.context.properties.EnableConfigurationProperties;
|
||||||
|
import org.springframework.context.annotation.Configuration;
|
||||||
|
|
||||||
|
import javax.annotation.PostConstruct;
|
||||||
|
|
||||||
|
@Slf4j
|
||||||
|
@Configuration
|
||||||
|
@EnableConfigurationProperties(VmisProperties.class)
|
||||||
|
public class VmisIntegrationConfig {
|
||||||
|
|
||||||
|
@Configuration
|
||||||
|
@ConditionalOnProperty(name = "vmis.integration.mode", havingValue = "internal")
|
||||||
|
static class InternalModeConfig {
|
||||||
|
@PostConstruct
|
||||||
|
public void init() {
|
||||||
|
log.info("=================================================");
|
||||||
|
log.info("VMIS Integration Mode: INTERNAL");
|
||||||
|
log.info("차량 정보 조회: 내부 VMIS 모듈 직접 호출");
|
||||||
|
log.info("=================================================");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Configuration
|
||||||
|
@ConditionalOnProperty(name = "vmis.integration.mode", havingValue = "external", matchIfMissing = true)
|
||||||
|
static class ExternalModeConfig {
|
||||||
|
@PostConstruct
|
||||||
|
public void init() {
|
||||||
|
log.info("=================================================");
|
||||||
|
log.info("VMIS Integration Mode: EXTERNAL");
|
||||||
|
log.info("차량 정보 조회: 외부 REST API 호출");
|
||||||
|
log.info("=================================================");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. 구현 가이드
|
||||||
|
|
||||||
|
### 3.1 파일 구조
|
||||||
|
|
||||||
|
```
|
||||||
|
go/kr/project/
|
||||||
|
├── common/
|
||||||
|
│ ├── service/
|
||||||
|
│ │ └── VehicleInfoService.java (인터페이스)
|
||||||
|
│ └── vo/
|
||||||
|
│ ├── VehicleBasicInfoResponseVO.java
|
||||||
|
│ └── VehicleLedgerResponseVO.java
|
||||||
|
│
|
||||||
|
├── vmis/
|
||||||
|
│ ├── config/
|
||||||
|
│ │ ├── VmisProperties.java
|
||||||
|
│ │ └── VmisIntegrationConfig.java (설정)
|
||||||
|
│ └── service/
|
||||||
|
│ └── InternalVehicleInfoServiceImpl.java (내부 모드 구현)
|
||||||
|
│
|
||||||
|
└── externalApi/
|
||||||
|
└── service/
|
||||||
|
└── ExternalVehicleInfoServiceImpl.java (외부 모드 구현)
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.2 기존 코드 리팩토링
|
||||||
|
|
||||||
|
#### Before (기존 ExternalVehicleApiService)
|
||||||
|
```java
|
||||||
|
@Service
|
||||||
|
public class ExternalVehicleApiService {
|
||||||
|
|
||||||
|
private final RestTemplate restTemplate;
|
||||||
|
|
||||||
|
public VehicleApiResponseVO getBasicInfo(String vhrno) {
|
||||||
|
// RestTemplate으로 외부 API 호출
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### After (전략 패턴 적용)
|
||||||
|
```java
|
||||||
|
// 기존 ExternalVehicleApiService는 ExternalVehicleInfoServiceImpl로 대체
|
||||||
|
// 클라이언트 코드는 VehicleInfoService 인터페이스에 의존
|
||||||
|
|
||||||
|
@Service
|
||||||
|
@RequiredArgsConstructor
|
||||||
|
public class CarInspectionService {
|
||||||
|
|
||||||
|
private final VehicleInfoService vehicleInfoService; // 인터페이스 주입
|
||||||
|
|
||||||
|
public void processInspection(String vhrno) {
|
||||||
|
// 설정에 따라 자동으로 내부/외부 구현체가 주입됨
|
||||||
|
VehicleBasicInfoResponseVO info = vehicleInfoService.getBasicInfo(vhrno);
|
||||||
|
// ...
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.3 구현 순서
|
||||||
|
|
||||||
|
1. **VehicleInfoService 인터페이스 생성**
|
||||||
|
- 위치: `go/kr/project/common/service/`
|
||||||
|
- 메서드: getBasicInfo, getLedgerInfo
|
||||||
|
|
||||||
|
2. **InternalVehicleInfoServiceImpl 구현**
|
||||||
|
- 위치: `go/kr/project/vmis/service/`
|
||||||
|
- VMIS 모듈 직접 호출
|
||||||
|
|
||||||
|
3. **ExternalVehicleInfoServiceImpl 구현**
|
||||||
|
- 위치: `go/kr/project/externalApi/service/`
|
||||||
|
- 기존 ExternalVehicleApiService 로직 이전
|
||||||
|
|
||||||
|
4. **VmisIntegrationConfig 생성**
|
||||||
|
- 설정 로깅 및 검증
|
||||||
|
|
||||||
|
5. **기존 클라이언트 코드 수정**
|
||||||
|
- ExternalVehicleApiService → VehicleInfoService 의존성 변경
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. 설정 예시
|
||||||
|
|
||||||
|
### 4.1 application.yml (공통)
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# VMIS 통합 모드 설정
|
||||||
|
vmis:
|
||||||
|
integration:
|
||||||
|
mode: internal # internal | external
|
||||||
|
|
||||||
|
# Internal 모드 설정
|
||||||
|
system:
|
||||||
|
info-sys-id: "VMIS001"
|
||||||
|
info-sys-ip: "${SERVER_IP:192.168.1.100}"
|
||||||
|
manager-id: "admin"
|
||||||
|
manager-name: "관리자"
|
||||||
|
manager-tel: "02-1234-5678"
|
||||||
|
|
||||||
|
gpki:
|
||||||
|
enabled: false
|
||||||
|
cert-path: "${GPKI_CERT_PATH:/path/to/cert.der}"
|
||||||
|
private-key-path: "${GPKI_PRIVATE_KEY_PATH:/path/to/private.key}"
|
||||||
|
private-key-password: "${GPKI_PASSWORD:}"
|
||||||
|
|
||||||
|
government:
|
||||||
|
host: "https://www.vemanet.com"
|
||||||
|
base-path: "/openapi"
|
||||||
|
connect-timeout: 10000
|
||||||
|
read-timeout: 15000
|
||||||
|
services:
|
||||||
|
basic:
|
||||||
|
path: "/carBassMatterInqire"
|
||||||
|
api-key: "${GOV_API_KEY_BASIC:}"
|
||||||
|
ledger:
|
||||||
|
path: "/carLedgerFrmbk"
|
||||||
|
api-key: "${GOV_API_KEY_LEDGER:}"
|
||||||
|
|
||||||
|
# External 모드 설정
|
||||||
|
external:
|
||||||
|
api:
|
||||||
|
url: "http://localhost:8081/api/v1/vehicles"
|
||||||
|
connect-timeout: 5000
|
||||||
|
read-timeout: 10000
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.2 application-local.yml (개발 환경)
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
vmis:
|
||||||
|
integration:
|
||||||
|
mode: external # 개발 중에는 외부 API 사용
|
||||||
|
|
||||||
|
external:
|
||||||
|
api:
|
||||||
|
url: "http://localhost:8081/api/v1/vehicles"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.3 application-dev.yml (개발 서버)
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
vmis:
|
||||||
|
integration:
|
||||||
|
mode: internal # 개발 서버에서는 내부 모듈 테스트
|
||||||
|
|
||||||
|
gpki:
|
||||||
|
enabled: false # 개발 서버는 암호화 비활성화
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.4 application-prd.yml (운영 환경)
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
vmis:
|
||||||
|
integration:
|
||||||
|
mode: internal # 운영 환경은 내부 모듈 사용
|
||||||
|
|
||||||
|
gpki:
|
||||||
|
enabled: true # 운영 환경은 암호화 활성화
|
||||||
|
cert-path: "${GPKI_CERT_PATH}"
|
||||||
|
private-key-path: "${GPKI_PRIVATE_KEY_PATH}"
|
||||||
|
private-key-password: "${GPKI_PASSWORD}"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.5 환경변수 설정 예시
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Internal 모드 (운영)
|
||||||
|
export VMIS_INTEGRATION_MODE=internal
|
||||||
|
export GOV_API_KEY_BASIC=your-api-key-basic
|
||||||
|
export GOV_API_KEY_LEDGER=your-api-key-ledger
|
||||||
|
export GPKI_PASSWORD=your-gpki-password
|
||||||
|
|
||||||
|
# External 모드 (롤백 시)
|
||||||
|
export VMIS_INTEGRATION_MODE=external
|
||||||
|
export VMIS_EXTERNAL_API_URL=http://vmis-interface-server:8081/api/v1/vehicles
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. 테스트 방법
|
||||||
|
|
||||||
|
### 5.1 단위 테스트
|
||||||
|
|
||||||
|
#### InternalVehicleInfoServiceImplTest.java
|
||||||
|
```java
|
||||||
|
@SpringBootTest
|
||||||
|
@TestPropertySource(properties = {
|
||||||
|
"vmis.integration.mode=internal"
|
||||||
|
})
|
||||||
|
class InternalVehicleInfoServiceImplTest {
|
||||||
|
|
||||||
|
@Autowired
|
||||||
|
private VehicleInfoService vehicleInfoService;
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testGetBasicInfo() {
|
||||||
|
// given
|
||||||
|
String vhrno = "12가3456";
|
||||||
|
|
||||||
|
// when
|
||||||
|
VehicleBasicInfoResponseVO response = vehicleInfoService.getBasicInfo(vhrno);
|
||||||
|
|
||||||
|
// then
|
||||||
|
assertNotNull(response);
|
||||||
|
assertEquals(vhrno, response.getVhrno());
|
||||||
|
assertTrue(vehicleInfoService instanceof InternalVehicleInfoServiceImpl);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### ExternalVehicleInfoServiceImplTest.java
|
||||||
|
```java
|
||||||
|
@SpringBootTest
|
||||||
|
@TestPropertySource(properties = {
|
||||||
|
"vmis.integration.mode=external",
|
||||||
|
"vmis.external.api.url=http://localhost:8081/api/v1/vehicles"
|
||||||
|
})
|
||||||
|
class ExternalVehicleInfoServiceImplTest {
|
||||||
|
|
||||||
|
@Autowired
|
||||||
|
private VehicleInfoService vehicleInfoService;
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testGetBasicInfo() {
|
||||||
|
// given
|
||||||
|
String vhrno = "12가3456";
|
||||||
|
|
||||||
|
// when
|
||||||
|
VehicleBasicInfoResponseVO response = vehicleInfoService.getBasicInfo(vhrno);
|
||||||
|
|
||||||
|
// then
|
||||||
|
assertNotNull(response);
|
||||||
|
assertTrue(vehicleInfoService instanceof ExternalVehicleInfoServiceImpl);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5.2 통합 테스트
|
||||||
|
|
||||||
|
#### 1. Internal 모드 테스트
|
||||||
|
```bash
|
||||||
|
# application-local.yml 수정
|
||||||
|
vmis:
|
||||||
|
integration:
|
||||||
|
mode: internal
|
||||||
|
|
||||||
|
# 애플리케이션 실행
|
||||||
|
./gradlew bootRun --args='--spring.profiles.active=local'
|
||||||
|
|
||||||
|
# 로그 확인
|
||||||
|
# [INTERNAL MODE] 차량 기본정보 조회 - 차량번호: 12가3456
|
||||||
|
|
||||||
|
# API 호출
|
||||||
|
curl -X POST http://localhost:8080/api/inspection \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"vhrno":"12가3456"}'
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 2. External 모드 테스트
|
||||||
|
```bash
|
||||||
|
# 1. VMIS-interface 서버 실행 (8081 포트)
|
||||||
|
cd D:\workspace\git\VMIS-interface
|
||||||
|
./gradlew bootRun
|
||||||
|
|
||||||
|
# 2. application-local.yml 수정
|
||||||
|
vmis:
|
||||||
|
integration:
|
||||||
|
mode: external
|
||||||
|
external:
|
||||||
|
api:
|
||||||
|
url: "http://localhost:8081/api/v1/vehicles"
|
||||||
|
|
||||||
|
# 3. VIPS 실행
|
||||||
|
cd D:\workspace\git\VIPS
|
||||||
|
./gradlew bootRun --args='--spring.profiles.active=local'
|
||||||
|
|
||||||
|
# 로그 확인
|
||||||
|
# [EXTERNAL MODE] 차량 기본정보 조회 - 차량번호: 12가3456
|
||||||
|
|
||||||
|
# API 호출
|
||||||
|
curl -X POST http://localhost:8080/api/inspection \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"vhrno":"12가3456"}'
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5.3 성능 비교 테스트
|
||||||
|
|
||||||
|
```java
|
||||||
|
@SpringBootTest
|
||||||
|
class VehicleInfoServicePerformanceTest {
|
||||||
|
|
||||||
|
@Autowired
|
||||||
|
private VehicleInfoService vehicleInfoService;
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void comparePerformance() {
|
||||||
|
String vhrno = "12가3456";
|
||||||
|
int iterations = 100;
|
||||||
|
|
||||||
|
// Warmup
|
||||||
|
for (int i = 0; i < 10; i++) {
|
||||||
|
vehicleInfoService.getBasicInfo(vhrno);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Performance test
|
||||||
|
long startTime = System.currentTimeMillis();
|
||||||
|
for (int i = 0; i < iterations; i++) {
|
||||||
|
vehicleInfoService.getBasicInfo(vhrno);
|
||||||
|
}
|
||||||
|
long endTime = System.currentTimeMillis();
|
||||||
|
|
||||||
|
long avgTime = (endTime - startTime) / iterations;
|
||||||
|
log.info("평균 응답 시간: {}ms (모드: {})", avgTime,
|
||||||
|
vehicleInfoService.getClass().getSimpleName());
|
||||||
|
|
||||||
|
// Internal 모드가 External 모드보다 빠를 것으로 예상
|
||||||
|
assertTrue(avgTime < 100); // 100ms 이내
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5.4 장애 상황 테스트
|
||||||
|
|
||||||
|
#### 시나리오 1: External 모드에서 외부 API 장애
|
||||||
|
```bash
|
||||||
|
# VMIS-interface 서버 중지
|
||||||
|
# → External 모드는 에러 반환
|
||||||
|
# → 설정을 Internal 모드로 변경하여 복구
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 시나리오 2: Internal 모드에서 DB 장애
|
||||||
|
```bash
|
||||||
|
# DB 연결 차단
|
||||||
|
# → Internal 모드는 에러 반환
|
||||||
|
# → 설정을 External 모드로 변경하여 복구
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. 운영 시나리오
|
||||||
|
|
||||||
|
### 6.1 점진적 배포 (Blue-Green)
|
||||||
|
|
||||||
|
**1단계: 준비**
|
||||||
|
```bash
|
||||||
|
# 모든 서버: External 모드
|
||||||
|
vmis.integration.mode=external
|
||||||
|
```
|
||||||
|
|
||||||
|
**2단계: 일부 서버 전환**
|
||||||
|
```bash
|
||||||
|
# 서버 A, B: External 모드
|
||||||
|
vmis.integration.mode=external
|
||||||
|
|
||||||
|
# 서버 C, D: Internal 모드 (테스트)
|
||||||
|
vmis.integration.mode=internal
|
||||||
|
```
|
||||||
|
|
||||||
|
**3단계: 모니터링 후 전체 전환**
|
||||||
|
```bash
|
||||||
|
# 모든 서버: Internal 모드
|
||||||
|
vmis.integration.mode=internal
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6.2 롤백 절차
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. application-prd.yml 또는 환경변수 수정
|
||||||
|
vmis.integration.mode=external
|
||||||
|
|
||||||
|
# 2. 애플리케이션 재시작 (또는 설정 리로드)
|
||||||
|
# 3. 로그 확인
|
||||||
|
# [EXTERNAL MODE] ...
|
||||||
|
|
||||||
|
# 4. VMIS-interface 외부 서버가 실행 중인지 확인
|
||||||
|
curl http://vmis-interface-server:8081/actuator/health
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6.3 모니터링 지표
|
||||||
|
|
||||||
|
**Prometheus/Grafana 메트릭**:
|
||||||
|
```java
|
||||||
|
@Component
|
||||||
|
public class VehicleInfoServiceMetrics {
|
||||||
|
|
||||||
|
private final Counter internalCalls;
|
||||||
|
private final Counter externalCalls;
|
||||||
|
private final Timer internalTimer;
|
||||||
|
private final Timer externalTimer;
|
||||||
|
|
||||||
|
// 메트릭 수집...
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**로그 분석**:
|
||||||
|
```bash
|
||||||
|
# Internal 모드 호출 건수
|
||||||
|
grep "\[INTERNAL MODE\]" application.log | wc -l
|
||||||
|
|
||||||
|
# External 모드 호출 건수
|
||||||
|
grep "\[EXTERNAL MODE\]" application.log | wc -l
|
||||||
|
|
||||||
|
# 평균 응답 시간
|
||||||
|
grep "응답시간" application.log | awk '{sum+=$NF; count++} END {print sum/count}'
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. 주의사항
|
||||||
|
|
||||||
|
### 7.1 설정 검증
|
||||||
|
|
||||||
|
**애플리케이션 시작 시 체크**:
|
||||||
|
```java
|
||||||
|
@Component
|
||||||
|
@RequiredArgsConstructor
|
||||||
|
public class VmisIntegrationValidator implements ApplicationRunner {
|
||||||
|
|
||||||
|
@Value("${vmis.integration.mode}")
|
||||||
|
private String integrationMode;
|
||||||
|
|
||||||
|
@Autowired(required = false)
|
||||||
|
private VehicleInfoService vehicleInfoService;
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void run(ApplicationArguments args) {
|
||||||
|
if (vehicleInfoService == null) {
|
||||||
|
throw new IllegalStateException(
|
||||||
|
"VehicleInfoService 빈이 생성되지 않았습니다. " +
|
||||||
|
"vmis.integration.mode 설정을 확인하세요: " + integrationMode
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
log.info("VMIS 통합 모드 검증 완료: {} (구현체: {})",
|
||||||
|
integrationMode,
|
||||||
|
vehicleInfoService.getClass().getSimpleName());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7.2 External 모드 사용 시 주의점
|
||||||
|
|
||||||
|
1. **외부 서버 가용성 확인**
|
||||||
|
- VMIS-interface 서버가 실행 중이어야 함
|
||||||
|
- Health check 엔드포인트 모니터링
|
||||||
|
|
||||||
|
2. **네트워크 타임아웃 설정**
|
||||||
|
- connect-timeout, read-timeout 적절히 설정
|
||||||
|
- Circuit Breaker 패턴 고려
|
||||||
|
|
||||||
|
3. **API 버전 호환성**
|
||||||
|
- External 서버와 클라이언트의 API 계약 일치 확인
|
||||||
|
|
||||||
|
### 7.3 Internal 모드 사용 시 주의점
|
||||||
|
|
||||||
|
1. **트랜잭션 범위**
|
||||||
|
- @Transactional 설정 주의
|
||||||
|
- DB 연결 풀 크기 조정
|
||||||
|
|
||||||
|
2. **GPKI 설정**
|
||||||
|
- 운영 환경에서는 gpki.enabled=true
|
||||||
|
- 인증서 경로 및 비밀번호 확인
|
||||||
|
|
||||||
|
3. **API 키 보안**
|
||||||
|
- 정부 API 키는 환경변수로 관리
|
||||||
|
- 코드에 하드코딩 금지
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. FAQ
|
||||||
|
|
||||||
|
### Q1: 설정을 변경하면 재시작이 필요한가요?
|
||||||
|
**A**: 네, @ConditionalOnProperty는 애플리케이션 시작 시에만 평가됩니다. 설정 변경 후 재시작이 필요합니다.
|
||||||
|
|
||||||
|
### Q2: 두 모드를 동시에 사용할 수 있나요?
|
||||||
|
**A**: 아니오, 한 번에 하나의 모드만 활성화됩니다. 설정에 따라 하나의 구현체만 빈으로 등록됩니다.
|
||||||
|
|
||||||
|
### Q3: External 모드에서 VMIS-interface 서버가 다운되면?
|
||||||
|
**A**: RestTemplate 타임아웃이 발생하고 에러가 반환됩니다. Circuit Breaker 패턴을 추가로 구현하면 장애 전파를 방지할 수 있습니다.
|
||||||
|
|
||||||
|
### Q4: Internal 모드가 External 모드보다 얼마나 빠른가요?
|
||||||
|
**A**: 네트워크 오버헤드가 없으므로 평균 50-100ms 정도 빠를 것으로 예상됩니다. 실제 성능은 환경에 따라 다릅니다.
|
||||||
|
|
||||||
|
### Q5: 개발 중에는 어떤 모드를 사용하나요?
|
||||||
|
**A**: 개발 초기에는 External 모드를 사용하여 기존 방식으로 개발하고, 통합 테스트 단계에서 Internal 모드로 전환하여 검증합니다.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**문서 버전**: 1.0
|
||||||
|
**최종 수정**: 2025-11-06
|
||||||
Loading…
Reference in New Issue