[Spring MVC] 서비스 계층

🍃 서비스 계층 

API 계층에서 전달받은 클라이언트의 요청 데이터를 기반으로 실질적인 비즈니스 요구사항을 처리하는 계층

 

 

 

목표

스프링의 DI(Dependency Injection)를 이용하여 API 계층과 비즈니스 계층을 연동하고,

API 계층에서 전달받은 DTO 객체를 비즈니스 계층의 도메인 엔티티(Entity) 객체로 변환해서 전달해보자.

 

 

 

"API 계층과 서비스 계층을 연동한다는 의미는 무엇일까?"

API 계층에서 구현한 Controller 클래스가 서비스 계층의 Service 클래스와 메서드 호출을 통해 상호작용한다는 것을 의미한다.

 

 

 

 

🍃 Service의 의미

- 애플리케이션의 관점으로 보면 도메인 업무 영역을 구현하는 비즈니스 로직과 관련이 있다.

- 애플리케이션의 비즈니스 로직을 처리하기 위한 서비스 계층은 대부분 도메인 모델을 포함하고 있다.

- 도메인 모델은 빈약한 도메인 모델/풍부한 도메인 모델로 구분, DDD(도메인 주도 설계, Domain Driven Design)와 관련이 있다.

 

 

 

비즈니스 로직을 처리하는 Service 클래스

 

✅ MemberController 클래스 살펴보기

@RestController
@RequestMapping("/v1/members")
@Validated
public class MemberController {
    @PostMapping
    public ResponseEntity postMember(@Valid @RequestBody MemberPostDto memberDto) {
        return new ResponseEntity<>(memberDto, HttpStatus.CREATED);
    }

    @PatchMapping("/{member-id}")
    public ResponseEntity patchMember(
            @PathVariable("member-id") @Positive long memberId,
            @Valid @RequestBody MemberPatchDto memberPatchDto) {
        memberPatchDto.setMemberId(memberId);

        // No need Business logic

        return new ResponseEntity<>(memberPatchDto, HttpStatus.OK);
    }

    @GetMapping("/{member-id}")
    public ResponseEntity getMember(
            @PathVariable("member-id") @Positive long memberId) {
        System.out.println("# memberId: " + memberId);

        // not implementation
        return new ResponseEntity<>(HttpStatus.OK);
    }

    @GetMapping
    public ResponseEntity getMembers() {
        System.out.println("# get Members");

        // not implementation

        return new ResponseEntity<>(HttpStatus.OK);
    }

    @DeleteMapping("/{member-id}")
    public ResponseEntity deleteMember(
            @PathVariable("member-id") @Positive long memberId) {
        System.out.println("# memberId: " + memberId);
        // No need business logic

        return new ResponseEntity(HttpStatus.NO_CONTENT);
    }
}

 

여기서 다섯 개의 핸들러 메서드를 뽑아볼 수 있다.

 

• postMember() : 1명의 회원 등록을 위한 요청을 전달받는다. <->  createMember()
• patchMember() : 1명의 회원 수정을 위한 요청을 전달받는다. <-> updateMember()
• getMember() : 1명의 회원 정보 조회를 위한 요청을 전달받는다. <-> findMember()
• getMembers() : N명의 회원 정보 조회를 위한 요청을 전달받는다. <-> findMembers()
• deleteMember() : 1명의 회원 정보 삭제를 위한 요청을 전달받는다. <-> deleteMember()

 

 

 

 

✅ MemberService 기본 구조

public class MemberService {
    public Member createMember(Member member) {
        // TODO should business logic

        // TODO member 객체는 나중에 DB에 저장 후, 되돌려 받는 것으로 변경 필요.
        Member createdMember = member;
        return createdMember;
    }

    public Member updateMember(Member member) {
        // TODO should business logic

        // member 객체는 나중에 DB에 업데이트 후, 되돌려 받는 것으로 변경 필요.
        Member updatedMember = member;
        return updatedMember;
    }

    public Member findMember(long memberId) {
        // TODO should business logic

        // TODO member 객체는 나중에 DB에서 조회 하는 것으로 변경 필요.
        Member member = 
                new Member(memberId, "hgd@gmail.com", "홍길동", "010-1234-5678");
        return member;
    }

    public List<Member> findMembers() {
        // TODO should business logic

        // TODO member 객체는 나중에 DB에서 조회하는 것으로 변경 필요.
        List<Member> members = List.of(
                new Member(1, "hgd@gmail.com", "홍길동", "010-1234-5678"),
                new Member(2, "lml@gmail.com", "이몽룡", "010-1111-2222")
        );
        return members;
    }

    public void deleteMember(long memberId) {
        // TODO should business logic
    }
}

 

• createMember(), updateMember():  단순히 파라미터로 전달받은 Member 객체를 그대로 리턴하고 있다.
• findMember(), findMembers(): Stub 데이터를 넘겨준다.

 

🤷‍♀️ Stub 데이터란?

- 프로그래밍에서 사용되는 가벼운 데이터로, 실제 데이터와 유사한 형태를 가지지만 실제 데이터의 크기와 복잡성을 가지지 않음

- 주로 개발 초기단계에서 데이터베이스나 외부 서비스에 연결되지 않은 상태에서 애플리케이션의 동작을 테스트하기 위해 사용

 

 

✅ Member 클래스

@Getter
@Setter
@NoArgsConstructor
@AllArgsConstructor
public class Member {
    private long memberId;
    private String email;
    private String name;
    private String phone;
}

 

• @AllArgsConstructor: 현재 Member 클래스에 추가된 모든 멤버 변수를 파라미터로 갖는 Member 생성자를 자동으로 생성해 줍니다.
• @NoArgsConstructor: 파라미터가 없는 기본 생성자를 자동으로 생성해준다.

 

 

DI(Dependency Injecion) 없이 비즈니스 계층과 API 계층 연동

@RestController
@RequestMapping("/v2/members")
@Validated
public class MemberController {
    private final MemberService memberService;

    public MemberController() {
        this.memberService = new MemberService(); // (1)
    }

    @PostMapping
    public ResponseEntity postMember(@Valid @RequestBody MemberPostDto memberDto) {
        // (2)
        Member member = new Member();
        member.setEmail(memberDto.getEmail());
        member.setName(memberDto.getName());
        member.setPhone(memberDto.getPhone());

        // (3)
        Member response = memberService.createMember(member);

        return new ResponseEntity<>(response, HttpStatus.CREATED);
    }

    @PatchMapping("/{member-id}")
    public ResponseEntity patchMember(
            @PathVariable("member-id") @Positive long memberId,
            @Valid @RequestBody MemberPatchDto memberPatchDto) {
        memberPatchDto.setMemberId(memberId);

        // (4)
        Member member = new Member();
        member.setMemberId(memberPatchDto.getMemberId());
        member.setName(memberPatchDto.getName());
        member.setPhone(memberPatchDto.getPhone());

        // (5)
        Member response = memberService.updateMember(member);

        return new ResponseEntity<>(response, HttpStatus.OK);
    }

    @GetMapping("/{member-id}")
    public ResponseEntity getMember(
            @PathVariable("member-id") @Positive long memberId) {
        // (6)
        Member response = memberService.findMember(memberId);
        return new ResponseEntity<>(response, HttpStatus.OK);
    }

    @GetMapping
    public ResponseEntity getMembers() {
        // (7)
        List<Member> response = memberService.findMembers();
        return new ResponseEntity<>(response, HttpStatus.OK);
    }

    @DeleteMapping("/{member-id}")
    public ResponseEntity deleteMember(
            @PathVariable("member-id") @Positive long memberId) {
        System.out.println("# delete member");

        // (8)
        memberService.deleteMember(memberId);

        return new ResponseEntity(HttpStatus.NO_CONTENT);
    }
}

 

(1) MemberService 클래스를 사용하기 위해 new 키워드를 이용하여 MemberService 클래스의 객체를 생성

(2) 클라이언트에서 전달받은 DTO 클래스의 정보 => MemberService의 createMember() 메서드의 파라미터로 전달

- MemberPostDto 클래스의 정보 => Member 클래스에 채워 넣음

 

⭐ 서비스 계층과의 연결 지점
(3) 회원 정보 등록을 위해 MemberService 클래스의 createMember() 메서드를 호출

(4) 클라이언트에서 전달받은 DTO 클래스의 정보 => MemberService의 updateMember() 메서드의 파라미터로 전달

- MemberPatchDto 클래스의 정보 => Member 클래스에 채워 넣음

 

⭐ 서비스 계층과의 연결 지점
(5) 회원 정보 수정을 위해 MemberService 클래스의 updateMember() 메서드를 호출

 

⭐ 서비스 계층과의 연결 지점
(6) 한 명의 회원 정보 조회를 위해 MemberService 클래스의 findMember() 메서드를 호출

- 특정 회원의 정보를 조회하는 기준인 memberId를 파라미터로 넘겨줌

(7) 모든 회원의 정보를 조회하기 위해 MemberService 클래스의 findMembers() 메서드를 호출

 

(8) 한 명의 회원 정보를 삭제하기 위해 MemberService 클래스의 deleteMember() 메서드를 호출

- 특정 회원의 정보를 삭제하는 기준인 memberId를 파라미터로 넘겨줌

 

 

 

클래스 간의  느슨한 결합(Loose Couping)을 위해 Spring의 DI를 사용해보자.

 

 

 

 

✅ DI 적용한 MemberController 클래스

@RestController
@RequestMapping("/v3/members")
@Validated
public class MemberController {
    private final MemberService memberService;

		// (1) MemberController의 변경 포인트
    public MemberController(MemberService memberService) {
        this.memberService = memberService;
    }
		
		...
		...
}

 

🤷‍♀️ MemberService 객체를 어떻게, 누가 주입했나? 

 

어떻게 ?   MemberController의 생성자 파라미터로 MemberService의 객체를 주입 받았다.

누가?    Spring 애플리케이션 로드 시, ApplicationContext의 MemberService 객체를 주입하였다.

 

 

 

 

 

✅ Spring Bean이 되기 위해 @Service 애너테이션을 추가한 MemberService 

@Service
public class MemberService {
		// 내부 코드는 [코드 3-45]와 동일.
    ...
		...
}

 

 

 

💬 위의 코드에서 해결되지 않은 문제점

1. MemberController의 핸들러 메서드가 DTO 클래스를 엔티티(Entity) 클래스로 변환하는 작업까지 도맡아 하고 있음

2. 엔티티(Entity) 클래스의 객체를 클라이언트의 응답으로 전송함으로써 계층 간의 역할 분리가 이루어지지 않음

 

 

 

📣 해결책은?

1. DTO 클래스를 엔티티 클래스로 변환하는 작업을 핸들러 메서드가 하지 않고 => 다른 클래스에세 변환해달라고 요청한다.

2. 엔티티 클래스의 객체를 DTO 클래스의 객체로 다시 바꿔준다.

 

 

 

 매퍼(Mapper)를 이용한 DTO 클래스 <-> 엔티티(Entity) 클래스 매핑

@Component  // (1)
public class MemberMapper {
		// (2) MemberPostDto를 Member로 변환
    public Member memberPostDtoToMember(MemberPostDto memberPostDto) {
        return new Member(0L,
                memberPostDto.getEmail(), 
                memberPostDto.getName(), 
                memberPostDto.getPhone());
    }

		// (3) MemberPatchDto를 Member로 변환
    public Member memberPatchDtoToMember(MemberPatchDto memberPatchDto) {
        return new Member(memberPatchDto.getMemberId(),
                null, 
                memberPatchDto.getName(), 
                memberPatchDto.getPhone());
    }

    // (4) Member를 MemberResponseDto로 변환
    public MemberResponseDto memberToMemberResponseDto(Member member) {
        return new MemberResponseDto(member.getMemberId(),
                member.getEmail(), 
                member.getName(), 
                member.getPhone());
    }
}

 

✅ 매퍼(Mapper) 클래스가 하는 일

- DTO 클래스와 엔티티(Entity) 클래스를 서로 변환해주는 클래스

 

✅ MemberMapper 코드 설명

(1) MemberMapper를 Spring의 Bean으로 등록하기 위해  @Component 애너테이션 추가

=> 등록된 Bean은 MemberController에서 사용

(2) MemberPostDto 클래스 => Member 클래스로 변환

(3) MemberPatchDto 클래스 => Member 클래스로 변환

(4) Member 클래스 => MemberResponseDto 클래스로 변환