헥사고날 아키텍처란 무엇인가요? 어떻게 구성되고 작동하나요?

Question

IT Interview Practice · Accepted Answer

## 헥사고날 아키텍처란 무엇인가요?

**헥사고날 아키텍처(Hexagonal Architecture)**는 비즈니스 코어를 중심으로 애플리케이션을 구성하고, 사용자 인터페이스, 데이터베이스, 외부 서비스 같은 세부 기술 요소로부터 코어를 분리합니다. 코어는 **포트와 어댑터**를 통해 이 요소들과 연결되므로 포트와 어댑터(Ports & Adapters) 아키텍처라고도 합니다.

목표는 외부 기술이 바뀌어도 비즈니스 규칙을 안정적으로 유지하는 것입니다. 육각형은 애플리케이션의 경계를 나타내며, 구성 요소가 여섯 개여야 한다는 뜻은 아닙니다.

## 코어, 포트, 어댑터는 어떤 역할을 하나요?

- **비즈니스 코어:** 주문 생성, 합계 계산, 할인 자격 확인 같은 주요 작업과 규칙을 포함합니다.
- **포트:** 코어가 제공하거나 필요로 하는 작업을 정의합니다. 예를 들어 코어는 주문 생성 작업을 제공하고, 주문 저장 작업을 필요로 합니다. 포트는 보통 코드의 함수나 인터페이스로 표현합니다.
- **어댑터:** 특정 기술을 포트에 연결합니다. HTTP 어댑터는 웹사이트 요청을 받고, 데이터베이스 어댑터는 SQL을 사용하여 주문을 저장합니다.

코어는 무엇을 해야 하는지 알고, 어댑터는 통신에 쓰이는 기술을 처리합니다. 애플리케이션 시작 코드는 적절한 어댑터를 코어에 연결합니다.

## 예시: 주문 생성하기

고객이 주문하면 HTTP 어댑터는 들어온 데이터를 주문 생성 작업에 대한 호출로 변환합니다. 코어는 주문의 유효성을 검사하고 합계를 계산한 뒤 영속성 포트를 통해 저장을 요청합니다. 설정된 데이터베이스 어댑터가 쿼리를 실행하고 결과를 반환합니다.

계산 규칙은 코어에 있으며 HTTP 처리 코드나 SQL을 포함하지 않습니다. 개발자는 이 규칙을 테스트할 때 데이터를 메모리에 저장하는 어댑터를 제공하여 실제 데이터베이스 연결 없이 테스트를 실행할 수 있습니다.

명령줄 주문 도구를 추가하면 다른 입력 어댑터를 통해 동일한 주문 생성 작업을 호출할 수 있습니다. 개발자는 새 도구를 위해 계산 규칙을 다시 작성할 필요가 없습니다.

## 장점

- **쉬운 비즈니스 규칙 테스트:** 대체 어댑터가 테스트 데이터를 제공하므로 외부 시스템과 독립적으로 규칙을 확인할 수 있습니다.
- **여러 진입점에서 작업 공유:** 웹사이트, 예약 작업, 명령줄 도구가 같은 비즈니스 코어를 사용할 수 있습니다.
- **연동 변경 범위 축소:** 코어와의 계약이 그대로라면 데이터베이스 라이브러리를 교체할 때 주로 해당 어댑터만 영향을 받습니다.

## 한계

- **연결 코드 증가:** 포트, 어댑터, 설정으로 구성 요소가 늘어나며, 아주 작은 애플리케이션에서는 불필요할 수 있습니다.
- **어댑터 교체만으로 모든 변경을 해결할 수 없음:** 계산 방식이나 기능이 다른 데이터 소스는 계약과 비즈니스 로직의 변경을 요구할 수 있습니다. 실제 어댑터 역시 연결 대상 시스템을 상대로 테스트해야 합니다.

## 언제 사용하면 좋을까요?

헥사고날 아키텍처는 비즈니스 규칙을 철저히 테스트해야 하거나, 진입점이 여러 개이거나, 외부 연동이 자주 바뀌는 애플리케이션에 적합합니다. 모놀리스 내부 또는 개별 마이크로서비스 내부의 코드를 구성하는 데 사용할 수 있으며, 애플리케이션을 서비스로 나누어야 하는 것은 아닙니다.

헥사고날 아키텍처란 무엇인가요?

코어, 포트, 어댑터는 어떤 역할을 하나요?

예시: 주문 생성하기

장점

한계

언제 사용하면 좋을까요?

관련 질문