/
카테고리

카테고리

Owned by Hannah
Last updated: Jan 14, 2025
2 min read

핵심적인 카테고리

  1. Enums

    • 비즈니스 로직과 관련된 상수값들을 정의.

    • 예: 도메인 내 상태 값, 코드 값 등.

  2. Domain

    • 핵심 비즈니스 로직 및 규칙을 포함.

    • Entity, Value Object, Aggregate, Domain Service 등이 포함될 수 있음.

  3. DTO

    • 외부와 데이터를 교환하기 위한 객체.

    • 요청 및 응답용 RequestDTO, ResponseDTO 등을 포함.

  4. Service

    • 응용 계층(Application Layer)의 비즈니스 로직을 처리.

    • Facade, Application Service, Domain Service를 분리하여 명확히 관리 가능.

  5. Repository

    • 도메인 객체의 영속성을 관리.

    • JpaRepository 또는 커스텀 Repository 인터페이스와 구현체.

  6. Controller

    • 사용자 요청을 받아서 응답하는 입출력 계층.

    • REST API 혹은 웹 소켓 컨트롤러를 포함.

  7. Configuration

    • 애플리케이션 전반의 설정과 구성.

    • Bean 등록, 외부 라이브러리 설정.

  8. Utils/Helper

    • 공통적으로 사용되는 유틸리티 함수와 헬퍼 클래스.

    • 비즈니스 로직과 직접적인 관련이 없는 범용 도구들.

추가적으로 고려할 수 있는 카테고리

  1. Adapter

    • 외부 시스템과의 통합을 담당.

    • 예: API 통신, 메시징 시스템(Kafka, RabbitMQ 등)과의 연계.

    • 헥사고날 아키텍처에서는 Port와의 인터페이스를 구현.

  2. Port

    • 애플리케이션이 외부와 통신하는 인터페이스.

    • Inbound Port: 사용자의 요청을 받아들임 (예: Service 인터페이스).

    • Outbound Port: 외부 시스템에 요청을 보냄 (예: Repository 인터페이스).

  3. Exception

    • 커스텀 예외를 정의하여 예외 처리를 중앙 집중화.

    • 예: 비즈니스 예외, 어플리케이션 예외.

  4. Mapper

    • 도메인 객체와 DTO 간 변환 로직을 포함.

    • MapStruct와 같은 라이브러리를 활용하거나 수동으로 매핑 로직 작성.

  5. Event

    • 도메인 이벤트를 처리하거나 발행.

    • 이벤트 퍼블리싱 또는 핸들링과 관련된 클래스.

  6. Validation

    • 입력 데이터의 검증 로직.

    • Validator 클래스 또는 애노테이션 기반의 검증.

  7. Scheduler/Batch

    • 정기적으로 실행되는 작업 처리.

    • 스케줄링 또는 배치 작업 관련 클래스.

  8. Interceptor/Filter

    • 요청/응답 처리 파이프라인에 추가되는 처리 로직.

    • 예: 인증, 로깅, 권한 확인.

  9. Integration

    • 외부 서비스와의 연동 테스트 및 모의 구현(Mock).

    • API, 데이터베이스, 메시지 브로커와의 통합 코드.

  10. Test

    • 단위 테스트(Unit Test), 통합 테스트(Integration Test), E2E 테스트.

    • 테스트 전용 설정 및 Mock 구현.

예시 구조

src ├── adapter ├── application (service, use case) ├── configuration ├── controller ├── domain │ ├── enums │ ├── entity │ ├── valueobject │ └── service ├── dto ├── event ├── exception ├── mapper ├── port │ ├── inbound │ └── outbound ├── repository ├── scheduler ├── utils └── test

 

특히 중요한 점

  • 헥사고날 아키텍처에서는 Adapter와 Port의 역할을 명확히 구분하고, 도메인 계층과 의존성을 최소화해야 합니다.

  • 공통 기능(Utils, Helper)은 특정 도메인이나 계층에 의존하지 않도록 설계해야 합니다.

  • 필요하다면 각 계층을 더 세분화하거나 프로젝트 특성에 맞게 조정할 수 있습니다.