[스프링 핵심 원리 - 기본편] #2. 예제 만들기

[Pracrobo]

예제 만들기 : 순수 자바 코드로만

비즈니스 요구사항과 설계

회원

• 회원을 가입하고 조회할 수 있다.
• 회원은 일반과 VIP 두가지 등급이 있다.
• 회원 데이터는 자체 DB를 구축할 수 있고 외부 시스템과 연동할 수 있다.(미확정)

주문과 할인 정책

• 회원은 상품을 주문할 수 있다.
• 회원 등급에 따라 할인 정책을 적용할 수 있다.
• 할인 정책은 모든 VIP는 1000원을 할인해주는 고정 금액 할인을 적용(나중에 변경가능성 있다.)
• 할인 정책을 변경 가능성이 높다. 회사의 기본 할인 정책을 아직 정하지 못했고, 오픈 직전까지 고민을 미루고 싶다.
• 최악의 경우, 할인을 적용하지 않을 수도 있다.(미확정)

요구사항을 보면 회원 데이터, 할인 정책 부분이 지금 결정하기 어려운 부분이다. 그렇다고 이런 정책이 결정될 때까지 개발을 무기한 연기할 수도 없다. 우리는 앞에서 배운 객체 지향 설계 방법을 사용해본다.
인터페이스를 만들고 구현체를 언제든지 갈아끼울 수 있도록 설계하면 된다.

현재 강의부분은 스프링이 없는 순수한 자바로만 개발을 진행한다. 스프링은 나중에 등장한다.

회원 도메인 설계

회원 도메인 요구사항

• 회원을 가입하고 조회할 수 있다.
• 회원은 일반과 VIP 두가지 등급이 있다.
• 회원 데이터는 자체 DB를 구축할 수 있고 외부 시스템과 연동할 수 있다.(미확정)

회원 도메인 협력 관계

• 기획자도 볼 수 있음

회원 클래스 다이어그램

• 도메인 협력 관계를 바탕으로 개발자가 구체화해서 클래스 다이어그램 만들어낸다.
• 인터페이스, 구현체 다 보임
• 구현체는 동적으로 결정되는 것이기에 객체 다이어그램이 필요

회원 객체 다이어그램

• 실제 new 한 인스턴스끼리의 참조

개발코드

버전 확인

public enum Grade {
     BASIC,
     VIP
}

public class Member {
    private Long Id;
    private String name;
    private Grade grade;
    public Member(Long id, String name, Grade grade) {
        this.id = id;
        this.name = name;
        this.grade = grade;
    }

    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Grade getGrade() {
        return grade;
    }

    public void setGrade(Grade grade) {
        this.grade = grade;
    }


}

package hello.core.member;

public interface MemberRepository {
    void save(Member member);
    Member findById(Long memberId);
}

구현체의 위치는 인터페이스랑 다르게 두는 것이 좋지만 이번엔 그냥 같은 패키지에 둔다.

package hello.core.member;

import java.util.HashMap;
import java.util.Map;

public class MemoryMemberRepository implements MemberRepository{
    private static Map<Long, Member> store = new HashMap<>();

    @Override
    public void save(Member member) {
        store.put(member.getId(), member);
    }

    @Override
    public Member findById(Long memberId) {
        return store.get(memberId);
    }
}

실무에선 동시성 이슈로 concurrent map 사용
DB가 결정이 안되서 Memory member Repository

회원 서비스

• 회원 가입
• 회원 조회

package hello.core.member;

public interface MemberService {
   void join(Member member);
   Member findMember(Long memberId);
}

관례상 구현체가 1개라면 클래스Impl라고 많이 쓴다.

package hello.core.member;

public class MemberServiceImpl implements MemberService{
    private final MemberRepository memberRepository = new MemoryMemberRepository();
    

    @Override
    public void join(Member member) {
        memberRepository.save(member);
    }

    @Override
    public Member findMember(Long memberId) {
        return memberRepository.findById(memberId);
    }
}

회원 도메인 실행과 테스트

• 동적인 회원 객체 다이어그램

package hello.core;

import hello.core.AppConfig;
import hello.core.member.Grade;
import hello.core.member.Member;
import hello.core.member.MemberService;

public class MemberApp {
    public static void main(String[] args) {
        MemberService memberService = new memberService();
        Member member = new Member(1L, "memberA", Grade.VIP);
        memberService.join(member);
 //회원 가입이 되어야 한다.

        Member findMember = memberService.findMember(1L);
        System.out.println("New Member = " + member.getName());
        System.out.println("Find Member = " + findMember.getName());
// 회원 조회
    }
}

JUnit으로 변경
테스트 코드는 빌드될때 빠진다.

package hello.core.member;

import hello.core.AppConfig;
import org.junit.jupiter.api.Assertions; //  편리한 API 다수존재
import org.junit.jupiter.api.Test;

import static org.assertj.core.api.Assertions.assertThat;


public class MemberServiceTest {

    MemberService memberService = new MemberServiceImpl(); //할당이 구현체를 둘다 의존(구체화와 추상화 둘다 의존) : DIP 위반
    
    @Test
    void join(){
        //given : 상황(~이 주어진 환경일 때)
        Member member = new Member(1L, "memberA" , Grade.VIP);

        //when : 인과(~했을때)
        memberService.join(member);
        Member findMember = memberService.findMember(1L);

        //then : 결과 (~가 된다)
        Assertions.asserThat(member).isEqualTo(findMember);
    }
}

회원 도메인 설계의 문제점

• 다른 저장소로 변경할 때 OCP(개방폐쇄)원칙을 잘 준수할까?
  • OCP : 다형성과 확장을 가능케 하는 객체지향의 장점을 극대화하는 설계 원칙(
    출처: https://inpa.tistory.com/entry/OOP-💠-아주-쉽게-이해하는-OCP-개방-폐쇄-원칙 [Inpa Dev 👨‍💻:티스토리])
• DIP(의존성 역전의 원칙)를 잘 지키고 있을까?
• 의존관계가 인터페이스 뿐만 아니라 구현까지 모두 의존하는 문제점이 있다.

주문과 할인 도메인 설계

• 회원은 상품을 주문할 수 있다.
• 회원 등급에 따라 할인 정책을 적용할 수 있다.
• 할인 정책은 모든 VIP는 1000원을 할인해주는 고정 금액 할인을 적용(나중에 변경가능성 있다.)
• 할인 정책을 변경 가능성이 높다. 회사의 기본 할인 정책을 아직 정하지 못했고, 오픈 직전까지 고민을 미루고 싶다.
• 최악의 경우, 할인을 적용하지 않을 수도 있다.(미확정)

• 클라이언트는 컨트롤러
• 단순화를 위해 상품명, 가격을 데이터를 넘긴다.

주문 도메인 전체

• 역할과 구현까지 그린 것
• 역할을 먼저 만들고 구현을 만들어서 분리 설계

주문 도메인 클래스 다이어그램

• FixDiscountPolicy : 고정할인(정액)
• RateDiscountPolicy : 정률할인(비율)

• 역할들의 협력 관계를 그대로 재사용할 수 있다. > 메모리에서 db, 정액에서 정률할인으로 바뀐다하더라도 주문서비스 구현체를 변경할 필요가 없다는 뜻 !
• "협력관계를 그대로 재사용할 수 있다" : 조용호님의 객체지향의 사실과 오해에서 자세히 풀어씀
  

주문과 할인 도메인

// hello.core.discountPolicy 패키지 만들기
package hello.core.discount;

import hello.core.member.Member;

public interface DiscountPolicy {

    /**
     *
     * @return 할인 대상 금액
     */
    int discount(Member member, int price);

}

구현체 만들기

package hello.core.discount;

import hello.core.member.Grade;
import hello.core.member.Member;

public class FixDiscountPolicy implements DiscountPolicy {

    private int discountFixAmount = 1000;

    @Override
    public int discount(Member member, int price) {
        if(member.getGrade() == Grade.VIP) { //enum은 == 사용가능
            return discountFixAmount;
        }else{
            return 0;
        }
    }
}

//hello.core.Order 패키지 만들기
package hello.core.order;

public class Order {
    private Long memberId;
    private String itemName;
    private int itemPrice;
    private int discountPrice;

    public Order(Long memberId, String itemName, int itemPrice, int discountPrice) {
        this.memberId = memberId;
        this.itemName = itemName;
        this.itemPrice = itemPrice;
        this.discountPrice = discountPrice;
    }

    public int calculatePrice() { 
        return itemPrice-discountPrice;
    }
    public Long getMemberId() {
        return memberId;
    }

    public void setMemberId(Long memberId) {
        this.memberId = memberId;
    }

    public String getItemName() {
        return itemName;
    }

    public void setItemName(String itemName) {
        this.itemName = itemName;
    }

    public int getItemPrice() {
        return itemPrice;
    }

    public void setItemPrice(int itemPrice) {
        this.itemPrice = itemPrice;
    }

    public int getDiscountPrice() {
        return discountPrice;
    }

    public void setDiscountPrice(int discountPrice) {
        this.discountPrice = discountPrice;
    }

    @Override
    public String toString() {
        return "Order{" +
                "memberId=" + memberId +
                ", itemName='" + itemName + '\'' +
                ", itemPrice=" + itemPrice +
                ", discountPrice=" + discountPrice +
                '}';
    }
}

package hello.core.order;

public interface OrderService {
    Order createOrder(Long memberId, String itemName , int itemPrice);

}

• 주문 서비스는 할인 결과를 포함한 주문 결과를 반환한다.

• 구현체 만들기 (OrderServiceImpl)

package hello.core.order;

import hello.core.discount.DiscountPolicy;
import hello.core.member.Member;
import hello.core.member.MemberRepository;
import hello.core.member.MemoryMemberRepository;

public class OrderServiceImpl implements OrderService {

    private final MemberRepository memberRepository = new MemoryMemeberRepoistory;
    private final DiscountPolicy discountPolicy = new FixDiscountPolicy();
// 단일 책임 원칙을 잘 지킨 것! 

    @Override
    public Order createOrder(Long memberId, String itemName, int itemPrice) {
        Member member = memberRepository.findById(memberId);
        int discountPrice = discountPolicy.discount(member, itemPrice);

        return new Order(memberId, itemName, itemPrice, discountPrice);
    }
}

주문과 할인 도메인 실행과 테스트

//OrderApp
package hello.core;

import hello.core.member.Grade;
import hello.core.member.Member;
import hello.core.member.MemberService;
import hello.core.member.MemberServiceImpl;
import hello.core.order.Order;
import hello.core.order.OrderService;
import hello.core.order.OrderServiceImpl;

public class OrderApp {
    public static void main(String[] args) {

        MemberService memberService = new MemberServiceImpl();
        OrderService orderService = new OrderServiceImpl();

        Long memberId = 1L;
        Member member = new Member(memberId, "memberA", Grade.VIP);
        memberService.join(member);

        Order order = orderService.createOrder(memberId, "itemA", 10000);

        System.out.println("order = " + order);
    }
}

• JUnit으로 옮기기

//test.hello.core.order
package hello.core.order;

import hello.core.AppConfig;
import hello.core.member.Grade;
import hello.core.member.Member;
import hello.core.member.MemberService;
import hello.core.member.MemberServiceImpl;
import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;

import static org.assertj.core.api.Assertions.assertThat;

public class OrderServiceTest {
    MemberService memberService = new MemberServiceImpl();
    OrderService orderService = new OrderServiceImpl();

    @Test
    void createOrder() {
        Long memberId = 1L;
        Member member = new Member(memberId, "memberA", Grade.VIP);
        memberService.join(member);

        Order order = orderService.createOrder(memberId, "itemA", 10000);
        assertThat(order.getDiscountPrice()).isEqualTo(1000); //VIP 1000원 할인
    }
}

• 두개 (Member, Order) 잘되는지 확인
• 주문서비스 역할(회원 저장소, 할인 정책 역할들을)을 클라이언트에 잘 전달하는지 보는 것.

프로젝트 전체 구조

단축키

• Ctrl + Alt + V : Extract/Introduce
• F2 : Navigate
• Alt + enter : Show Context Actions

[YuDeokRin]

오 벌써 다 올려주셨네요 수고하셨습니다. 내일 뵙겠습니다 !

꿀팁 마지막 단축키 -> 정말 많이 쓰죠 ㅎㅎ

[6om1n]

윈도우에서 생성자, getter setter 만들 때 사용하는 단축키 alt+insert 도 추가하시면 더 좋을 것 같아용 !!
저도 최근 강의에서 알아서 너무 편했던 기억이 ...
수고하셨습니다 ~!!!

[YuDeokRin]

"객체지향의 오해의 사실과 오해" 라는 서적으로도 나중에 스터디 하면 좋을듯합니다 ㅎㅎ