<aside>

헥사고날 아키텍처는 포트 및 어댑터 아키텍처 (Ports and Adapters Architecture) 라고도 불리는 소프트웨어 아키텍처 패턴이다.

이 아키텍처의 핵심 목표는 애플리케이션의 핵심 비즈니스 로직(도메인 영역)을 외부 기술적 요소(데이터베이스, UI, 외부 API 등)로 부터 격리시켜 유연하고 테스트하기 쉬운 구조를 만드는 것이다.

전통적인 계층형 아키텍처와 달리, 헥사고날 아키텍처는 의존성이 항상 안쪽으로 향하도록 하여 핵심 로직이 외부 요소의 변경에 영향을 받지 않게 한다.

</aside>

<aside>

구조

핵사고날 아키텍처는 이름처럼 육각형(Hexagon) 다이어그램으로 표현되며, 중심에는 애플리케이션 코어가, 주 주변에는 포트와 어댑터가 위치한다.

애플리케이션 코어

• 순수한 비즈니스 로직을 캡슐화한 영역이다.
• 소프트웨어가 해결하고자 하는 핵심 문제와 규칙(도메인, 엔티티, 서비스 등)이 정의된다.
• 외부의 기술적 구현(프레임워크, DB 종류 등)에 전혀 의존하지 않아야한다. 이를 통해 비즈니스 로직을 독립적으로 테스트하고 유지보수 하기 쉽게 만든다.

포트 (Ports - 인터페이스)

• 애플리케이션 코어와 외부 세계 간의 상포작용을 위한 계약(interface)을 정의한다.
• 코어가 외부에 노출하는 기능 또는 코어가 외부에서 필요로 하는 기능을 명세한다.
  • 인바운드 포트 : 외부에서 애플리케이션 코어를 호출하기 위해 사용되는 인터페이스 (UserUseCase 인테페이스)
  • 아웃바운드 포트 : 애플리케이션 코어가 외부 시스템을 호출하기 위해 사용되는 인터페이스 (UserRepository 인터페이스)

어댑터(Adapters - 구현체)

• 포트에 정의된 인터페이스를 구체적인 외부 기술에 맞게 구현하는 ‘번역자’ 또는 ‘중개자’ 역할을 한다.
  • 인바운드 어댑터 : 인바운드 포트를 사용하여 외부 요청(사용자 입력)을 애플리케이션 코어의 메서드 호출로 변환한다. (REST API Controller, CLI 핸들러)
  • 아웃바운드 어댑터 : 아웃바운드 포트를 구현하여 코어가 요청한 외부 작업을 실제 기술로 처리한다. (RDB/NoSQL 데이터베이스 Repository 구현체, 외부 메시징 시스템 클라이언트)

헥사고날 아키텍서의 핵심은 의존성 역전 원칙(DIP)을 적용하는 것이다.

• 고수준 모듈(Core)은 저수준 모듈(Adapter)에 의존해서는 안된다.
• 대신 둘다 추상화(Port)에 의존해야한다. </aside>

Domain (Entity, UseCase, Domain Service)
          ↑                ↑
      Ports ←-----------→ Ports
          ↑                ↑
  Web Adapter           Persistence Adapter
(Controller)          (JPA/MyBatis)