인프런 커뮤니티 질문&답변

선생님, 추가로 mapper 관련해서 궁금한 점이 있습니다.

1. 위치
   보통 mapper 패키지는 domain.model 쪽에 두는지, framework.jpaadapter 쪽에 두는지, 아니면 별도의 계층(interfaces나 application)으로 분리해서 관리하는지요? 실무에서는 어떤 기준으로 위치를 정하는지 궁금합니다.

2. 구현 방식
   예를 들어 이런 방식들이 있는데요 (참고로 ai로 방법을 가져왔습니다):

• 정적 유틸/Converter 클래스

  public class UserMapper {
      public static User toDomain(UserEntity e) {
          return new User(e.getId(), e.getName());
      }
      public static UserEntity toEntity(User d) {
          return new UserEntity(d.getId(), d.getName());
      }
  }
  

• MapStruct 같은 코드 생성 기반 매퍼

  @Mapper(componentModel = "spring")
  public interface UserMapper {
      User toDomain(UserEntity entity);
      UserEntity toEntity(User domain);
  }
  

• Repository 계층에서 매핑 처리

  @Repository
  public class UserRepository {
      private final JpaUserRepository repo;
      
      public User findById(Long id) {
          return UserMapper.toDomain(repo.findById(id).orElseThrow());
      }
      
      public void save(User user) {
          repo.save(UserMapper.toEntity(user));
      }
  }
  

이런 방식 중에서 실제 프로젝트에서는 어떤 방법을 더 많이 사용하셨는지, 그리고 규모나 복잡도에 따라 어떤 방식을 추천하시는지 궁금합니다.

3. 선생님 경험
   개인적으로 최근 프로젝트에서는 어떤 위치/방식을 주로 쓰셨는지, 가능하다면 간단한 예제 코드도 함께 공유해 주시면 도움이 될 것 같습니다.

움 제가 항상하는 방법보다는 서비스 규모나 관점에 따라 매번 다를 것 같은데요. 구분해 보면,

1. domain.model 쪽에 두는 경우

• 장점: 도메인이 주도적으로 외부와 변환 책임을 가진다고 보는 관점.

• 적용 상황:

  • 작은 규모 프로젝트

  • 도메인 모델이 단순하고 변환 로직이 크지 않을 때

• 예시: UserMapper 가 UserEntity ↔ User 변환 담당, domain.model 하위에 둠.

2. framework.jpaadapter 쪽에 두는 경우

• 장점: JPA Entity는 Infra 영역이므로, Infra와 Domain 사이 연결 책임도 Infra에서 맡긴다고 보는 관점.

• 적용 상황:

  • DDD 원칙을 엄격히 적용하는 경우

  • 여러 Persistence Adapter(JPA, Mongo, Redis 등)가 공존할 수 있는 구조

• 예시: UserJpaMapper 가 framework.jpaadapter 하위에 존재, JPA Entity 변환만 담당.

3. application 계층에 두는 경우

• 장점: Domain과 Infra 양쪽에 중립적 위치. 변환을 오케스트레이션 계층에서 담당.

• 적용 상황:

  • 대규모 시스템

  • 다중 어댑터(DB, 외부 API 등)가 붙고, 매핑 책임이 복잡해질 때

• 예시: UserDataMapper 가 application 계층에 위치해 Domain ↔ Entity, Domain ↔ DTO 등을 모두 다룸.

이런 케이스 들이 있겠네요.

음 그리고 저같은 경우에는 프로젝트 상황에 따라, 비지니스 및 팀원들 성향에 따라 매번 다르다고 보시면 될 것 같습니다.