응용 서비스는 어떻게 구현해야 하는가

📌 들어가며

이번 포스팅에서는 응용 서비스를 구현할때 항상 절대적일 순 없지만 따르면 좋은 구현 방식에 대해서 포스팅하고자 합니다.  API를 개발할 수록 이 기능에 대한 로직은 어디에 있어야 할까? 혹은 응용 서비스가 이렇게 길어지는게 맞나...? 자주 고민하게 됩니다. 물론 도메인의 상황, 팀별 규칙에 따라 달라질 순 있겠지만 통상적인 구현 방식에 대해 정리해 보고자 합니다. 

 

📌 응용 서비스란

 응용 서비스는 표현 영역과 함께 사용자와 도메인을 연결해주는 매개체 역할을 합니다. 표현 영역이 사용자로부터 URL, 요청 파라미터, 쿠키, 헤더 등을 이용해서 사용자가 어떤 기능을 실행하기를 원하는지 판별하고 근 기능을 제공하는 응용 서비스를 실행하게 됩니다.

 

 응용 서비스는 실행하는데 필요한 입력값을 메서드 파라미터로 전달받고 실행 결과를  표현 영역으로 리턴합니다. 응용 서비스의 메서드가 요구하는 파라미터와 표현 영역이 사용자로부터 전달받은 데이터는 형식이 일치하지 않기 때문에 표현 영역은 응용 서비스가 요청하는 형식으로 사용자 요청을 변환 합니다.

@GetMapping("/test")
public ModelAndView join(HttpServletRequest request){

    String email = request.getParameter("email");
    String password = request.getParameter("password")
    
    //사용자의 요청을 응용 서비스에 맞게 변환
    JoinRequest joinReq = new JoinRequest(email, password);
    
    //변환한 객체를 이용해서 응용 서비스를 실행
    joinService.join(joinReq);
    
    ...
}

 

 이와 같은 응용 서비스는 클라이언트가 요청한 기능을 실행합니다. 응용 서비스는 사용자가 요청한 기능을 수행하기 위해 레포지토리로부터 도메인 객체를 조회하고,  조회한 도메인 객체를 사용합니다. 응용 서비스의 주요한 역할은 도메인 객체를 사용해서 사용자의 요청을 처리하는 것으로 표현 영역에서 보았을 때 도메인 영역과 표현 영역을 연결해 주는 창구(facade) 역할을 하게 됩니다. 

 

따라서 응용  서비스는 주로 도메인 객체 간의 흐름을 제어하는 로직들이 있게 되며 다음과 같이 한눈에 흐름을 볼 수 있는 형태로 개발됩니다.

public Response doFunc(Request req){

    //1. 레포지터리로부터 애그리거트를 구한다.
    Aggregate agg = repository.findById(req.getId());
    checkNull(agg)
    
    //2. 애그리거트의 도메인 기능을 실행한다.
    agg.doSomething(req.getValue());
    
    //3. 결과를 리턴한다.
    return createSuccessfulResponse(agg);
}

 

📌 응용 서비스  구현 방식

도메인 로직 넣지 않기 

 응용 서비스는 너무 복잡하지 않고 한눈에 흐름을 읽을 수 있어야 합니다. 만일 한 눈에 들어오지 않게 복잡하다면 응용 서비스에서 도메인 로직의 일부를 구현하고 있지는 않은지 확인해야 합니다. 도메인 로직을 도메인 영역과 응용 서비스에 분산해서 구현하면 코드 품질에 문제가 발생하게 됩니다.

 

 첫 번째 문제는 코드의 응집성이 떨어지게 됩니다. 도메인 데이터와 그 데이터를 조작하는 도메인 로직이 한 영역에 위치하지 않고 서로 다른 영역에 위치한다는 것은 도메인 로직을 파악하기 위해 여러 영역을 분석해야 합니다. 두 번째 문제는 여러 응용 서비스에서 동일한 도메인 로직을 구현할 가능성이 높아지게 된다는 것입니다. 이렇듯 응집도가 떨어지고 코드 중복이 발생하는 문제는 결과적으로 코드의 변경을 어렵게 만들기 때문에 삼가해야 합니다.

 

적정한 응용 서비스의 크기

응용 서비스는 보통 다음의 두가지 중 하나의 방식으로 구현합니다.

- 한 응용 서비스 클래스에 도메인의 모든 기능 구현하기

- 구분되는 기능별로 응용 서비스 클래스를 따로 구현하기

 

 한 응용 서비스클래스에 도메인의 모든 기능을 구현한다면 한 도메인과 관련된 기능을 구현한 코드가 한  클래스에 위치하므로 각 기능에서 동일 로직에 대한 코드 중복을 제거할 수 있다는 장점이 존재합니다. 그러나 한 서비스 클래스의 코드 줄 수가 커진다는 단점이 존재합니다. 코드 크기가 커지게 된다면 연관성이 적은 코드가 한 클래스에 함께 위치하게 되어 결과적으로 관련 없는 코드가 뒤섞여 코드를 이해하기 어렵게 만듭니다. 

 

구분되는 기능별로 서비스 클래스를 구현하는 방식은 한 응용 서비스 클래스에서 한 개 혹은 2-3개의 기능을 구현합니다. 쿠폰 도메인이 있다고 친다면 CouponUseService(쿠폰 사용 기능), CouponIssueService(쿠폰 발급 기능), CouponHistoryService(쿠폰 이력 저장) 등으로 클래스를 여러개 만들어 기능을 구현하게 됩니다. 해당 방식을 사용하면 클래스는 많아지지만 한 클래스에 관련 기능을 모두 구현하는 것과 비교했을 때 코드 품질을 일정 수준으로 유지하는데 도움이 됩니다. 

 

각 기능마다 동일한 로직을 구현하여 코드가 중복되는 경우는 다음과 같이 별도 클래스에 로직을 구현해서 코드 중복을 방지할 수 있습니다.

// 각 응용 서비스에서 공통적으로 사용될 로직을 별도 클래스로 구현

public final class MemberServiceHelper {
  
  public static Member findExistMember(MemberRepository repository, String memberId){
  
    Member member = memberRepository.findById(memberId);
    if(member == null) throw new NoMemberException(memberId);
    return member;
  
  }

}

//응용 서비스에서 해당 클래스를 이용하여 구현
import static com.myshop.member.application.MemberServiceHelper.*;

public class ChangePasswordService{

  private MemberRepository memberRepository;
  
  public void changePassword(String memberId, String curPw, String newPw){
    
    Member member = findExistingMember(memberRepository, memberId);
    member.changePassword(currPw, mewPw);
  
  }

}

 

 

응용 서비스의 값 리턴

응용 서비스에서 애그리거트 자체를 리턴하면 도메인의 로직 실행을 응용 서비스와 표현 영역 두 곳에서 할 수 있게 됩니다. 이는 기능 실행 로직을 응용 서비스와 표현 영역에 분산시켜 코드의 응집도를 낮추는 원인이 됩니다. 따라서 응용 서비스는 표현 영역에 필요한 데이터만 리턴하는 것이 기능 실행 로직의 응집도를 높이는 방법입니다.

 

 

참고: DDD START! 도메인 주도 설계 구현과 핵심 개념 익히기