헥사고날 아키텍처(Hexagonal Architecture)

헥사고날 아키텍처란

헥사고날 아키텍처는 애플리케이션 코어가 육각형으로 표현되어 있는 아키텍처입니다.

육각형 안에는 도메인 엔티티와 이와 상호작용하는 유스케이스가 있습니다. 모든 의존성은 코어를 향합니다. 육각형 바깥에는 애플리케이션과 상호작용하는 다양한 어댑터들이 있습니다. (웹 프레임워크, 데이터베이스 등)

 

헥사고날 아키텍처는 포트 앤 어댑터(Ports and Adapters) 아키텍처라고도 불립니다.

 

구성 요소

포트(Port)

도메인과 어댑터 사이의 통신하고, 애플리케이션이 외부와 상호작용하는 인터페이스를 정의합니다.

• 입력 포트: 애플리케이션이 외부로부터 들어오는 요청을 처리합니다. 유스케이스를 실행하는 메서드를 포함합니다. (유스케이스 인터페이스, 서비스 인터페이스)
• 출력 포트: 애플리케이션이 외부 시스템(웹 프레임워크, 외부 API, 데이터베이스)과 상호작용하기 위한 인터페이스를 정의합니다. 이 포트를 통해 외부 시스템에 데이터를 요청하거나 전송합니다. (리포지토리 인터페이스, API 클라이언트 인터페이스)

 

어댑터(Adapter)

어댑터는 외부 시스템(웹 프레임워크, 데이터베이스 등)을 핵심 도메인 로직에 연결하는 역할을 합니다.

• 입력 어댑터: 외부의 요청을 받아 도메인 로직에 전달하는 역할을 합니다.
• 출력 어댑터: 도메인 로직의 요청을 받아 외부 시스템과 상호작용하는 역할을 합니다.

 

도메인(Domain)

도메인은 애플리케이션의 비즈니스 규칙, 정책, 데이터 및 동작을 표현하는 부분입니다. 외부 시스템이나 구현 세부 사항에 의존하지 않고 독립적으로 존재합니다.

도메인은 애플리케이션의 비즈니스 가치를 담고 있으며, 헥사고날 아키텍처의 목표는 이 도메인이 독립적이고 재사용 가능하게 만드는 것입니다.

 

아키텍처 흐름

아래와 같은 과정을 통해서 외부 라이브러리나 프레임워크의 변화로부터 도메인을 보호하고 집중할 수 있습니다.

• 컨트롤러에서는 포트만 접근할 수 있습니다.
• 유스케이스에서는 도메인 쪽에 구현되어 있는 레포지터리 포트를 통해서 결과를 저장합니다.

 

패키지 구조

아래는 buckpal이라는 애플리케이션의 account 모듈의 패키지 구조입니다.

헥사고날 아키텍처에서 구조적으로 핵심적인 요소는 엔티티, 유스케이스, 포트, 어댑터입니다. 구성 요소들은 패키지 하나씩에 직접 매핑됩니다.

buckpal
├── account
	├── adapter
		├── in
		├── out
	├── domain
	├── application
		├── service
		├── port
			├── in
			├── out

 

---

참고

ChatGPT

https://tgyun615.com/203

https://www.yes24.com/Product/Goods/105138479

https://youtu.be/Ql7CoQminoM?si=kSqc7FUmKDCbm3Oh