Hexagonal Architecture 또는 Ports and Adapters는 응용 프로그램의 핵심 도메인 논리와 상호 작용하는 외부 서비스, 데이터 소스 및 사용자 인터페이스를 명확하게 분리하는 것을 목표로 하는 소프트웨어 아키텍처 패턴입니다. Hexagonal Architecture의 주요 목표는 핵심 로직을 중심으로 처리하고 포트 및 어댑터라고 하는 잘 정의된 인터페이스를 통해 외부 세계에 연결하여 애플리케이션의 유지 관리 가능성, 적응성 및 테스트 가능성을 개선하는 것입니다.
"Hexagonal"이라는 이름은 핵심 비즈니스 논리를 다양한 외부 서비스에 연결하는 각 면에 서로 다른 어댑터가 있는 육각형을 보여주는 이 아키텍처 패턴의 시각적 표현에서 유래되었습니다. 이 레이아웃은 애플리케이션의 핵심에 영향을 주지 않고 새 어댑터를 쉽게 추가하거나 제거할 수 있으므로 이 아키텍처의 유연성과 모듈성을 보여줍니다.
육각형 구조를 사용하는 이유는 무엇입니까?
Hexagonal Architecture를 사용하면 Java 애플리케이션에 여러 가지 이점이 있습니다.
- 핵심 비즈니스 논리의 격리: 핵심 도메인 논리를 외부 종속성에서 분리하면 외부 통합의 세부 사항에 대해 걱정하지 않고 핵심 기능 구현에 집중할 수 있습니다. 이러한 격리는 또한 외부 서비스와 독립적으로 핵심 논리를 테스트할 수 있으므로 코드의 테스트 가능성을 개선하는 데 도움이 됩니다.
- 유지 관리 및 적응성 향상: 우려 사항을 명확하게 분리하면 외부 종속성 또는 해당 구현에 대한 변경 사항이 핵심 논리에 영향을 주지 않습니다. 이러한 분리를 통해 애플리케이션의 주요 기능에 영향을 주지 않고 외부 종속성을 쉽게 업데이트, 리팩터링 또는 교체할 수 있습니다.
- 향상된 모듈성: Hexagonal Architecture는 구성 가능한 모듈식 구성 요소의 개발을 촉진하여 새로운 기능 추가, 어댑터 교체 또는 애플리케이션 구조 재구성을 더 간단하게 만듭니다.
- 유연한 통합: 포트 및 어댑터를 사용하여 애플리케이션을 다양한 유형의 외부 서비스 및 데이터 소스에 쉽게 연결할 수 있으므로 다양한 환경 및 요구 사항에 대한 적응성이 향상됩니다.
- 향상된 테스트 가능성: 핵심 도메인 로직이 외부 서비스와 분리되어 있으므로 전체 외부 종속성 체인을 모의 또는 스텁 아웃하지 않고도 핵심 비즈니스 규칙에 대한 단위 테스트를 효과적으로 생성할 수 있습니다.
이미지 출처: GitHub
주요 개념 및 용어
Hexagonal Architecture를 더 잘 이해하기 위해 다음은 몇 가지 필수 용어와 개념입니다.
핵심 도메인 로직
이는 애플리케이션의 중앙 비즈니스 로직과 가장 중요한 부분을 나타냅니다. Hexagonal Architecture에서 핵심 도메인 논리는 데이터베이스, 메시징 시스템 또는 UI 구성 요소와 같은 외부 종속성 및 문제와 독립적이어야 합니다.
포트
포트는 핵심 도메인 논리와 외부 서비스 간의 상호 작용에 대한 계약을 정의하는 인터페이스입니다. 포트는 또한 애플리케이션과 해당 어댑터 간의 입력/출력 형식 및 통신 프로토콜을 정의하는 역할을 합니다. 두 가지 유형의 포트가 있습니다.
- 구동 포트: 구동 포트는 외부 액터(예: UI 구성 요소, 외부 시스템)가 애플리케이션과 상호 작용하는 데 사용됩니다. 외부 클라이언트가 핵심 도메인 논리에 명령과 쿼리를 보내는 방법을 정의합니다.
- 구동 포트: 구동 포트는 애플리케이션에서 데이터베이스, 메시징 시스템 또는 타사 API와 같은 외부 서비스와 상호 작용하는 데 사용됩니다. 애플리케이션에 데이터와 서비스를 제공하기 위해 외부 종속성에 대한 메서드를 정의합니다.
어댑터
어댑터는 포트를 구현하고 핵심 도메인 논리와 외부 서비스 간의 격차를 해소하는 역할을 합니다. 데이터 및 기능의 외부 표현을 응용 프로그램에서 이해할 수 있는 형식으로 변환하거나 그 반대로 변환합니다.
- 구동 어댑터: 구동 어댑터는 외부 입력(예: HTTP 요청 또는 사용자 입력)을 핵심 도메인 논리가 이해할 수 있는 명령 및 쿼리로 변환합니다.
- 구동 어댑터: 구동 어댑터는 핵심 도메인 논리의 출력 및 요구 사항을 외부 서비스와 상호 작용하는 데 필요한 호출 및 작업으로 변환합니다.
이러한 주요 개념을 이해하면 Java 애플리케이션에서 Hexagonal Architecture를 효과적으로 구현하고 활용하여 유지 관리, 적응성 및 테스트 가능성을 개선하는 데 도움이 됩니다.
Java의 6각형 아키텍처 구현
Java에서 Hexagonal Architecture를 구현하려면 애플리케이션의 핵심 비즈니스 로직과 인프라 계층을 명확하게 분리해야 합니다. 이는 Hexagonal Architecture의 주요 구성 요소인 Port와 Adapter를 정의함으로써 달성할 수 있습니다. 다음은 Java에서 Hexagonal Architecture를 구현하는 단계입니다.
- 포트 정의: 포트를 Java 인터페이스로 정의하여 시작하십시오. 포트는 특정 애플리케이션 상호 작용에 대한 계약을 나타내며 핵심 비즈니스 논리와 외부 시스템 또는 UI 구성 요소 간의 경계 역할을 합니다. 각 포트는 예상되는 입력 및 출력을 정의하는 일련의 메서드를 노출해야 합니다.
- 어댑터 구현: 포트 인터페이스를 구현하는 Java 클래스를 만듭니다. 이러한 어댑터는 외부 시스템의 통신 프로토콜을 포트에서 정의한 계약으로 변환합니다. 어댑터는 기본 및 보조의 두 가지 유형으로 분류할 수 있습니다. 기본 어댑터는 UI 또는 사용자 입력과 상호 작용하는 반면 보조 어댑터는 데이터베이스, API 또는 메시징 시스템과 같은 외부 시스템을 처리합니다.
- 핵심 비즈니스 로직 생성: 어댑터 및 포트와 분리하여 개발합니다. 비즈니스 로직은 스토리지 또는 메시징과 같은 인프라 문제에 대한 종속성 없이 순수하고 상태 비저장이어야 합니다. 이를 통해 코드베이스의 테스트 가능성과 유지 관리 가능성이 향상되고 핵심 도메인이 주변 아키텍처의 변경에 영향을 받지 않도록 합니다.
- 구성 요소 연결: DI(종속성 주입)를 사용하여 구성 요소 간의 종속성을 관리합니다. DI는 특정 구성 요소에 필요한 종속성이 구성 요소 내에서 직접 인스턴스화되지 않고 외부적으로 제공되도록 합니다. 이렇게 하면 종속성을 테스트 double 또는 모의로 대체할 수 있으므로 우려 사항을 보다 명확하게 분리하고 단위 테스트를 단순화할 수 있습니다.
6각형 아키텍처 구현을 위한 모범 사례
6각형 아키텍처를 최대한 활용하려면 다음 모범 사례를 고려하십시오.
- 모듈성 강조: 잘 정의된 인터페이스와 추상화를 사용하여 모듈성을 염두에 두고 애플리케이션을 설계합니다. 구성 요소를 모듈식으로 유지하면 핵심 비즈니스 로직을 변경하지 않고도 하나의 구현을 다른 구현으로 쉽게 교체할 수 있습니다.
- 핵심 도메인 논리 분리: 핵심 도메인 논리를 깨끗하게 유지하고 인프라 문제와 분리합니다. 이를 통해 응용 프로그램을 더 쉽게 테스트 및 유지 관리하고 기술 또는 요구 사항의 변화에 적응할 수 있습니다.
- 명확한 포트 계약 정의: 포트에 대해 정의된 인터페이스가 명확하고 간결한지 확인하여 애플리케이션 상호 작용에 대한 계약을 효과적으로 설정합니다. 이를 통해 핵심 도메인 로직과 외부 시스템을 명확하게 분리하여 구현을 적응하거나 변경할 수 있는 유연성을 제공합니다.
- 종속성 역전 적용: DI(종속성 주입)를 사용하여 구성 요소 간의 종속성을 관리합니다. 이렇게 하면 우려 사항을 깔끔하게 분리하고 결합을 줄이며 필요한 경우 테스트 더블 또는 모의를 주입할 수 있으므로 테스트가 간소화됩니다.
- 일관된 명명 규칙 적용: 일관된 명명 규칙을 사용하여 프로젝트 내에서 포트와 어댑터를 명확하게 식별합니다. 이렇게 하면 코드베이스의 가독성과 유지 관리성이 향상되어 개발자가 아키텍처를 쉽게 이해할 수 있습니다.
육각형 아키텍처의 실제 사례
수많은 웹 애플리케이션, 마이크로서비스 및 엔터프라이즈 소프트웨어 시스템은 더 나은 유지 관리, 적응성 및 유연성을 달성하기 위해 Hexagonal Architecture를 채택했습니다. 다음은 몇 가지 실제 사례입니다.
- 전자상거래 플랫폼: 전자상거래 시스템은 결제 게이트웨이, 배송업체, 재고 관리 시스템과 같은 다양한 외부 서비스와의 통합이 필요한 경우가 많습니다. Hexagonal Architecture를 통해 개발자는 각 통합을 별도의 어댑터로 구현할 수 있는 모듈식 시스템을 만들 수 있으므로 서로 다른 공급자 간에 쉽게 전환하거나 타사 서비스의 업데이트에 적응할 수 있습니다.
- 마이크로서비스: 마이크로서비스는 Hexagonal Architecture의 탁월한 사용 사례입니다. Hexagonal 원칙을 사용하여 마이크로서비스 아키텍처를 구현하면 데이터베이스, API 및 메시징 시스템과 같은 여러 외부 서비스 및 구성 요소에 연결할 때 문제를 명확하게 분리하고 유지 관리가 용이하며 유연성을 얻을 수 있습니다.
- 콘텐츠 관리 시스템(CMS): Drupal 또는 WordPress와 같은 인기 있는 CMS 플랫폼은 다양한 외부 플러그인, 테마 및 데이터베이스와 상호 작용해야 하므로 Hexagonal Architecture의 이점을 누릴 수 있습니다. Hexagonal 원칙을 구현함으로써 개발자는 코드 유지 관리를 단순화하고 외부 종속성 또는 요구 사항 변경에 쉽게 적응할 수 있습니다.
이러한 실제 사례를 통해 학습하고 학습함으로써 자신의 프로젝트에 Hexagonal Architecture 원칙을 적용하여 유지 관리 가능하고 유연하며 쉽게 적응할 수 있는 응용 프로그램을 만드는 방법을 더 잘 이해할 수 있습니다. Hexagonal Architecture를 AppMaster.io 와 같은 플랫폼과 통합하면 AppMaster 의 no-code 기능의 이점을 누리면서 Hexagonal Architecture의 모범 사례를 따르는 백엔드, 웹 및 모바일 앱을 구축할 수 있으므로 애플리케이션 개발 프로세스를 간소화할 수 있습니다. .
AppMaster.io와 육각형 아키텍처 통합
AppMaster.io 프로젝트에 Hexagonal Architecture를 통합하면 유지 관리, 적응성 및 유연성을 향상시킬 수 있습니다. Hexagonal Architecture의 원칙을 준수하면서 백엔드 및 웹 앱에서 핵심 도메인 로직을 설계할 수 있습니다. 이러한 구성 요소를 외부 서비스 및 UI 구성 요소와 연결하여 간소화된 애플리케이션 개발 프로세스를 설정할 수 있습니다. AppMaster.io는 개발자가 백엔드, 웹 및 모바일 애플리케이션을 시각적으로 생성할 수 있는 강력한 노코드 플랫폼입니다.
일련의 도구와 직관적인 인터페이스를 갖춘 AppMaster.io는 프로젝트에서 Hexagonal Architecture 구현을 단순화하는 데 도움이 될 수 있습니다. Hexagonal Architecture를 AppMaster.io와 통합하려면 다음 단계를 따르세요.
1단계: Visual BP Designer를 사용하여 핵심 도메인 로직 설계
AppMaster.io의 시각적 BP Designer를 사용하여 핵심 도메인 로직을 설계하는 것부터 시작하십시오. 핵심 논리적 구성 요소를 깨끗하게 유지하고 기본 책임에 집중해야 합니다. 이 접근 방식은 Hexagonal Architecture가 옹호하는 관심사의 분리를 유지하는 데 도움이 됩니다.
2단계: 외부 서비스용 포트 및 어댑터 정의
애플리케이션이 필요한 포트 및 어댑터와 상호 작용하고 정의하는 데 필요한 외부 서비스를 식별합니다. AppMaster.io를 사용하면 외부 서비스와 통신하기 위한 맞춤형 endpoints 생성할 수 있습니다. 이러한 사용자 지정 endpoints 사용하여 포트를 정의하고 각 외부 서비스와 상호 작용하는 데 필요한 논리를 캡슐화하는 어댑터를 구현합니다.
3단계: 사용자 인터페이스 및 상호 작용 설계
AppMaster.io의 드래그 앤 드롭 UI 빌더를 사용하여 웹 및 모바일 애플리케이션의 사용자 인터페이스를 디자인하십시오. UI 구성 요소가 Hexagonal Architecture 원칙을 준수하는지 확인하고 핵심 도메인 논리 및 외부 서비스와 통신하기 위해 적절한 포트에 연결합니다.
4단계: UI 구성 요소에 대한 비즈니스 로직 구현
AppMaster.io를 사용하면 웹 및 모바일 애플리케이션용 시각적 BP 디자이너를 사용하여 UI 구성 요소의 비즈니스 로직을 정의할 수 있습니다. Hexagonal Architecture 원칙을 따르면 핵심 도메인 논리 및 외부 서비스와 효과적으로 통합되는 조정 가능하고 유지 관리 가능한 UI를 만들 수 있습니다.
5단계: 애플리케이션 게시 및 배포
애플리케이션의 핵심 도메인 로직, 포트, 어댑터 및 UI가 설계되고 구현되면 AppMaster.io에서 "게시" 버튼을 눌러 애플리케이션의 소스 코드를 생성하고, 컴파일하고, 테스트를 실행하고, Docker 컨테이너 에 압축할 수 있습니다( 백엔드만 해당) 클라우드에 배포합니다.
추가 팁
- 종속성 주입을 사용하여 애플리케이션 구성 요소 간의 종속성을 관리하여 변경 및 확장성을 단순화합니다.
- 포트 및 어댑터를 설계할 때 모듈성을 목표로 하여 각 구성 요소가 독립적으로 작동하도록 합니다.
- 관심사 분리, 모듈성 및 클린 아키텍처에 중점을 둔 6각형 아키텍처 구현을 위한 모범 사례를 사용합니다.
소프트웨어 개발자인 채드 파울러(Chad Fowler )는 "나이가 들수록 기술 분야에서 해결해야 할 가장 큰 문제는 사람들이 더 이상 일을 더 어렵게 만들지 않도록 하는 것임을 깨닫게 됩니다."라고 말했습니다. AppMaster.io가 복잡성을 단순화하므로 이는 사실입니다. 시각적인 BP Designer, 직관적인 UI 빌더 및 강력한 프로젝트 관리 도구를 활용하여 Hexagonal Architecture의 원칙을 프로젝트에 원활하게 주입하여 간소화된 개발 시대를 열 수 있습니다.
