🖥️ Port & Adapter Architecture

⬡ Hexagonal Architecture Pattern ?

개요 & 등장 배경

헥사고널 아키텍처 패턴(Ports and Adapters)은 애플리케이션의 주요 로직을 외부 요소(예: 데이터베이스, 사용자 인터페이스)와 분리하여 개발의 유연성과 유지 보수성을 높이는 것을 목표.

2005년 Alistair Cockburn의해 제안된 아키텍처이며, 전통적인 계층형 아키텍처(Layered Architecture)의 문제점을 보완하고자 등장하였음. 레이어드 아키텍처는 데이터 엑세스 계층에 의존하는 구조인데, 이는 db같은 하위 계층이 강하게 결합되어 db의 변경이나 외부 시스템과의 상호작이 필요할 때 유연하게 대응하기 어려운 문제가 발생, 또한 특정 기술에 의존적는 코드로 작성되고 도메인 로직과 섞이면서 로직을 테스트 하는 것에도 쉽지 않다는 문제가 있음.

따라서 헥사고널 아키텍처는 비즈니스의 로직을 외부 기술 스택에 의존하지 않게 함으로써, 로직의 재사용성과 유지보수을 높이고, 의존성 역전 원칙 (Dependency Inversion Principle)을 통해, 외부 특정 구현에 의존하지 않고 인터페이스에 의존하도록 설계 (상위 모듈 (High-level modules) 은 하위 모듈 (Low-level modules) 에 의존해서는 안 되며, 둘 다 추상화 (abstractions) 에 의존해야 한다).

핵심 개념

Domain (도메인): 애플리케이션의 핵심 비즈니스 로직을 담당. 도메인 로직은 외부 시스템이나 프레임워크에 의존하지 않음.
Ports (포트): 도메인 로직과 외부 시스템 간의 인터페이스를 정의. 포트는 입력(입력 포트)과 출력(출력 포트)으로 나눌 수 있음.
Adapters (어댑터): 포트의 인터페이스를 구현하여 도메인 로직을 외부 시스템과 연결. 어댑터는 외부 시스템이 도메인 로직과 상호작용하는 방식을 정의.

아키텍처의 구조

도메인 중심: 비즈니스 로직은 도메인 계층에 위치하며, 이 계층은 외부 시스템과의 상호작용에서 독립적.
포트와 어댑터 계층: 포트는 도메인 로직이 외부 시스템과 상호작용할 수 있는 지점을 정의, 어댑터는 이러한 포트를 구현하여 실제 상호작용을 수행.

이점

유연성: 외부 시스템을 변경하더라도 도메인 로직에는 영향을 주지 않음.
테스트 용이성: 도메인 로직은 외부 시스템과 분리되어 있기 때문에 독립적으로 테스트할 수 있음.
유지보수성: 각 계층이 명확하게 분리되어 있어, 코드의 변경이 다른 부분에 미치는 영향을 최소화할 수 있음.

사용 예시

웹 애플리케이션: 웹 UI, API, 데이터베이스 등 다양한 어댑터를 통해 도메인 로직에 접근할 수 있음.
마이크로서비스 아키텍처: 각 서비스가 독립적인 도메인 로직을 가지고, 다른 서비스나 외부 시스템과의 통신을 어댑터를 통해 수행.

적용 방법

도메인 로직을 정의하고, 이를 중심으로 애플리케이션을 설계.
도메인 로직과 상호작용할 수 있는 포트를 정의.
포트를 구현하는 어댑터를 작성하여 외부 시스템과의 상호작용을 처리.
도메인 로직의 독립성을 유지하면서, 필요에 따라 어댑터를 교체하거나 확장.

결론

육각형 아키텍처는 복잡한 애플리케이션의 구조를 단순화하고, 유연성과 유지 보수성을 높이는 데 도움. 이를 통해 애플리케이션의 각 구성 요소를 독립적으로 개발하고 테스트할 수 있으며, 변화하는 요구 사항에 더 쉽게 대응할 수 있음.

📁 Directory Structure

Note

실제 적용 사례 및 개선 과정을 소개합니다