값 객체(Value Object)로 변경 용이성 개선하기

/**
 * 금액을 표현한 값 객체.
 */
@EqualsAndHashCode // 등가성 비교: 속성 전체가 같으면 같은것으로 취급한다.
public class Money {
  private final BigDecimal amount; // 불변(immutable)

  public Money(final BigDecimal amount) {
    if (Objects.isNull(amount)) { // 무결성 유지 Validation
      throw new IllegalArgumentException("금액이 Null일 수 없습니다.")
    }
    this.amount = amount;
  }

  // ...도메인 객체의 행동을 표현한 메서드...
  // ex) 덧셈, 뺄셈, 곱하기, 나누기, 비교(동등,이상,초과,...), 통화(원화,달러,...)관련, ...
}

/**
 * 환불 금액 정보.
 */
public class ReturnRefundAmountInfo {
  private final Money payAmount; // 결제금액 (상품금액 - 쿠폰할인 + 배송비)
  private final Money itemPrice; // 상품금액
  private final Money couponSaleAmount; // 쿠폰할인
  private final Money orderDeliveryFee; // 배송비
  // ...필드 생략... 
}

// ...금액을 연산하는 비즈니스 컴포넌트 생략...

/**
 * 주문 시, 상품 판매가.
 */
@EqualsAndHashCode
public class ItemPrice {
  private final Money price;

  public ItemPrice(final Money price) {
    this.price = price;
  }
}

/**
 * 주문 시, 쿠폰 할인 금액.
 */
@EqualsAndHashCode
public class CouponSaleAmount {
  private final Money amount;

  public CouponSaleAmount(final Money amount) {
    this.amount = amount;
  }
}

/**
 * 주문 시, 고객이 결제한 배송비.
 */
@EqualsAndHashCode
public class OrderDeliveyFee {
  private final Money fee;

  public OrderDeliveyFee(final Money fee) {
    this.fee = fee;
  }
}

/**
 * 총 결제금액.
 */
@EqualsAndHashCode
public class TotalPayAmount {
  private final Money amount; 

  // 총 결제금액을 생성하기 위해서는 구체적인 값 객체를 매개변수로 전달해야 한다.
  public TotalPayAmount(
    final ItemPrice itemPrice, 
    final CouponSaleAmount couponSaleAmount, 
    final OrderDeliveyFee orderDeliveyFee
  ) {
    var totalPayAmount = itemPrice.getPrice()
            .subtract(couponSaleAmount.getAmount())
            .add(orderDeliveyFee.getFee());  
    if (totalPayAmount.isNegative()) { // 무결성 유지 Validation
      throw new IllegalStateException("결제금액이 0원 이하일 수 없습니다");
    }
    this.amount = totalPayAmount;
  }
}

/**
 * 상품이 불량일때, 고객에게 되돌려주는 배송비.
 */
@EqualsAndHashCode
public class RefundOrderDeliveryFee implements RefundDeliveryFee {
  private final Money fee;
  // ...생략...
}

/**
 * 고객변심 반품일때, 고객이 지불해야하는 반품상품 회수배송비.
 */
@EqualsAndHashCode
public class SubtractReturnDeliveryFee implements SubtractDeliveryFee {
  private final Money fee;
  // ...생략...
}

/**
 * 고객변심 반품이면서 무료배송 혜택받았을때, 고객이 지불해야하는 추가배송비.
 */
@EqualsAndHashCode
public class SubtractAdditionalDeliveryFee implements RefundDeliveryFee {
  private final Money fee;
  // ...생략...
}

/**
 * 환불금액.
 * Service는 인터페이스에 의존하여 코드를 작성한다.
 */
interface RefundAmount {
  add(RefundDeliveryFee deliveryFee); // 차감해야 하는금액이 add의 매개변수가 될 수 없다.

  subtract(SubtractDeliveryFee deliveryFee); // 환불해야하는 금액이 subtract의 매개변수가 될 수 없다.

  RefundPayAmount getRefundPayAmount();

  RefundMileage getRefundMileage();

  TotalRefundAmount getTotalRefundAmount();
}

/**
 * 환불금액 구현체.
 * 계산 정책이 변경되면, 구현체만 새로 구현하면 된다.
 */
@EqualsAndHashCode
public class RefundAmountImpl implements RefundAmount {
  private final RefundPayAmount refundPayAmount; // 환불금액
  private final RefundMileage refundMileage; // 환불마일리지
 
  public RefundAmountImpl(
    // ...매개변수(구체적인 값 객체) 생략...
  ) {
    // ...환불금액과 환불마일리지 계산로직 생략...
    this.refundPayAmount = ...
    this.refundMileage = ...
  }
 
  public RefundPayAmount getRefundPayAmount() {
    return refundPayAmount;
  }
 
  public RefundMileage getRefundMileage() {
    return refundMileage;
  }
 
  public TotalRefundAmount getTotalRefundAmount() {
    return new TotalRefundAmount(refundPayAmount, refundMileage);
  }

  // ...생략...
}

/**
 * 총 환불 예정 금액
 */
@EqualsAndHashCode
public class TotalRefundAmount {
  private final Money amount;

  // 총 환불 예정 금액을 생성하기 위해서는 구체적인 값 객체를 매개변수로 전달해야 한다.
  public TotalRefundAmount(
    final RefundPayAmount refundPayAmount,
    final RefundMileage refundMileage
  ) {
    this.amount = refundPayAmount.getAmount()
                  .add(refundMileage.getMileage());
  }
}