[TIL] 221123 - 클론 코딩 : 커피빈 주문 관리 서비스

[클론 코딩] 커피빈 주문 관리 서비스

 

0.  요구사항

• 매일 전날 오후 2시부터 오늘 오루 2시까지의 주문을 모아서 처리
• 현재 총 4개의 상품 존재
• 별도의 회원을 관리하지 않고, email로 구분
  • 하루에 같은 email로 여러번 주문이 들어올 경우 하나로 합쳐서 다음날 배송
• 고객에개 “당일 오후 2시 이후의 주문은 다음날 배송을 시작합니다.”라고 알려줍니다.

 

 

1.  프로젝트 생성

Spring initializr

 

2.  domain 모델 정의

→ 상품 도메인

→ 주문 도메인

 

ERD

 

• validation Object 만들기

public class Email {
    private final String address;

    public Email(String address) {
        Assert.notNull(address);
        Assert.isTrue(address.length() >= 4 && address.length() <= 50,"address length must be between 4 and 50 characters");
        Assert.isTrue(checkAddress(address), "Invalid email address");
        this.address = address;
    }

    private boolean checkAddress(String address) {
        return Pattern.matches("\\\\b[\\\\w\\\\.-]+@[\\\\w\\\\.-]+\\\\.\\\\w{2,4}\\\\b",address);
    }

    //validation 할때, equals나 hashcode를 직접 구현해 주는 것이 좋다.
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        Email email = (Email) o;
        return Objects.equals(address, email.address);
    }

    @Override
    public int hashCode() {
        return Objects.hash(address);
    }

    @Override
    public String toString() {
        return "Email{" +
                "address='" + address + '\\'' +
                '}';
    }

    public String getAddress() {
        return address;
    }
}

정규 분포식 구하기 → https://regexr.com/

RegExr: Learn, Build, & Test RegEx

Email 정규분포식

 

3.  repository 구현, test 코드 작성

 

@Repository
public class OrderJdbcRepository implements OrderRepository {

  private final NamedParameterJdbcTemplate jdbcTemplate;

  public OrderJdbcRepository(NamedParameterJdbcTemplate jdbcTemplate) {
    this.jdbcTemplate = jdbcTemplate;
  }

  @Override
  @Transactional
  public Order insert(Order order) {
    jdbcTemplate.update("INSERT INTO orders(order_id, email, address, postcode, order_status, create_at, update_at) " +
        "VALUES (UUID_TO_BIN(:orderId), :email, :address, :postcode, :orderStatus, :createAt, :updateAt)",
      toOrderParamMap(order));
    order.getOrderItems()
      .forEach(item ->
        jdbcTemplate.update("INSERT INTO order_item(order_id, product_id, category, price, quantity, create_at, update_at) " +
            "VALUES (UUID_TO_BIN(:orderId), UUID_TO_BIN(:productId), :category, :price, :quantity, :createAt, :updateAt)",
          toOrderItemParamMap(order.getOrderId(), order.getCreatedAt(), order.getUpdateAt(), item)));
    return order;
  }


  private Map<String, Object> toOrderParamMap(Order order) {
    var paramMap = new HashMap<String, Object>();
    paramMap.put("orderId", order.getOrderId().toString().getBytes());
    paramMap.put("email", order.getEmail().getAddress());
    paramMap.put("address", order.getAddress());
    paramMap.put("postcode", order.getPostcode());
    paramMap.put("orderStatus", order.getOrderStatus().toString());
    paramMap.put("createAt", order.getCreatedAt());
    paramMap.put("updateAt", order.getUpdateAt());
    return paramMap;
  }

  private Map<String, Object> toOrderItemParamMap(UUID orderId, LocalDateTime createdAt, LocalDateTime updatedAt, OrderItem item) {
    var paramMap = new HashMap<String, Object>();
    paramMap.put("orderId", orderId.toString().getBytes());
    paramMap.put("productId", item.productId().toString().getBytes());
    paramMap.put("category", item.category().toString());
    paramMap.put("price", item.price());
    paramMap.put("quantity", item.quantity());
    paramMap.put("createAt", createdAt);
    paramMap.put("updateAt", updatedAt);
    return paramMap;
  }

}

 

Map 초기화시 주의 사항

1. 이중 중괄화를 사용한 초기화 지양

https://www.baeldung.com/java-double-brace-initialization

2. 팩토리 메소드(map.of)를 사용한 초기화의 문제 -> nullable한 값이 들어올때 map이 null값에 대한 error를 발생시킨다. 

 

=> 무난하게 HashMap을 이용해 초기화를 하자

 

 

4.  service 구현

@Service
public class DefaultOrderService implements OrderService {

  private final OrderRepository orderRepository;

  public DefaultOrderService(OrderRepository orderRepository) {
    this.orderRepository = orderRepository;
  }

  @Override
  public Order createOrder(Email email, String address, String postcode, List<OrderItem> orderItems) {
    Order order = new Order(
      UUID.randomUUID(),
      email,
      address,
      postcode,
      orderItems,
      OrderStatus.ACCEPTED,
      LocalDateTime.now(),
      LocalDateTime.now());
    return orderRepository.insert(order);
  }

}

 

 

5.  controller 구현

REST API 를 만든는 controller가 아니라 웹페이지에 접속하기위한 view를 반환해주는 controller

controller는 외부로 부터 DTO로 받아서 Validation이나, http 핸들을 수행한다. 도메인 로직은 Service와 entity에서!

@Controller 
public class ProductController {

    private final ProductService productService;

    public ProductController(ProductService productService) {
        this.productService = productService;
    }

    @GetMapping("/products")
    public String productsPage(Model model){
        var products = productService.getAllProducts();
        model.addAttribute("products",products);
        return "product-list";
    }

    @GetMapping("new-product")
    public String newProductPage(Model model){
        return "new-product";
    }

    @PostMapping("/products")
    public String newProduct(CreateProductRequest createProductRequest){
        productService.createProduct(createProductRequest.productName(),createProductRequest.category(),
                createProductRequest.price(),createProductRequest.description());
        return "redirect:/products";
    }
}

 

6.  template 작성

•  new-product.html
•  product-list.html

 

7.  React 코드 작성

: axios 사용

 

8 . API

• CORS 설정

@Configuration
public class MvcConfiguration implements WebMvcConfigurer { // mvc 설정 확장
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/api/**").allowedOrigins("*");
    }
}

 

• 주문 처리 API 구현

@RestController
public class OrderRestController {

    private final OrderService orderService;

    public OrderRestController(OrderService orderService) {
        this.orderService = orderService;
    }

    @PostMapping("/api/v1/orders")
    public Order createOrder(@RequestBody CreateOrderRequest createOrderRequest){
        return orderService.createOrder(
               new Email(createOrderRequest.email()),
                createOrderRequest.address(),
                createOrderRequest.postcode(),
                createOrderRequest.orderItems()
        );
    }

}

 

•  CreateOrderRequest -> json을 표현하기 위한 타입을 정의할 수 있다. (DTO를 message포맷으로 변경시키기 위한 정의할 수 있다.)
• service에서 인지하는 것보다. service는 service 자체의 메세지 시그니쳐를 가져가고 controller가 service가 필요한 value Object나 parameter의 변수로 변환하도록 동일한 값을 넘겨 줄지라고 계층을 구분하는 것이 좋다.

 

---

소스코드 

https://github.com/youngjijang/prgrms-be-devcourse

GitHub - youngjijang/prgrms-be-devcourse: 프로그래머스 데브코스 백엔드 실습 repo