개발자가 반드시 정복해야 할 객체 지향과 디자인 패턴 ‐ 객체 지향 - thought-corner/backend-roadmap GitHub Wiki

/**
 * 멤버십 유효 기간 — 값 객체(불변, 자기 유효성 검증).
 * 식별자가 없고 값 자체로 동일성이 결정되므로 값 객체다.
 */
data class MembershipPeriod(
    val startedOn: LocalDate,
    val expiresOn: LocalDate,
) {
    init {
        require(!expiresOn.isBefore(startedOn)) {
            "만료일은 시작일보다 앞설 수 없습니다: $startedOn ~ $expiresOn"
        }
    }
 
    /** 주어진 날짜가 이 기간 안에 포함되는가. */
    fun includes(date: LocalDate): Boolean =
        !date.isBefore(startedOn) && !date.isAfter(expiresOn)
 
    /** 만료일을 늘린 '새' 기간을 반환한다(자신은 바꾸지 않음 — VO는 불변). */
    fun extendedBy(days: Long): MembershipPeriod =
        copy(expiresOn = expiresOn.plusDays(days))
}

/**
 * 회원 — 엔티티. 만료 판단이라는 도메인 규칙을 캡슐화한다.
 * period가 private이라 외부는 만료일 자체를 알 수 없고, 행동을 통해서만 상호작용한다.
 */
class Member(
    val id: MemberId,
    private var period: MembershipPeriod,
) {
 
    /** 만료됐는가? — 만료 판단 규칙이 이 안에 모여 있다(외부로 새지 않음). */
    fun isExpired(clock: Clock): Boolean =
        LocalDate.now(clock).isAfter(period.expiresOn)
 
    /** 유효한 회원인가? '묻지 말고 시켜라'에 맞춰 질문형 메서드로 제공. */
    fun isActive(clock: Clock): Boolean = !isExpired(clock)
 
    /** 만료까지 남은 일수(음수면 이미 만료된 지 지난 일수). */
    fun daysUntilExpiry(clock: Clock): Long =
        ChronoUnit.DAYS.between(LocalDate.now(clock), period.expiresOn)
 
    /**
     * 멤버십 연장 — 상태 변경도 규칙을 지키며 스스로 수행한다.
     * setter로 만료일을 통째로 열어주지 않는 이유: 규칙 없는 변경을 막기 위해.
     */
    fun renew(days: Long) {
        require(days > 0) { "연장 일수는 양수여야 합니다: $days" }
        period = period.extendedBy(days)
    }
}

// ❌ Bad(getter로 잔액을 꺼내 바깥에서 검사하고, setter로 되돌려 넣는다.)
class BadAccount(var balance: Long)
 
fun badWithdraw(account: BadAccount, amount: Long) {
    // 규칙(잔액 부족 검사)이 호출자 쪽에 있다. 출금하는 모든 곳에 이 if가 복제된다.
    if (account.balance >= amount) {
        account.balance = account.balance - amount   // 무방비 setter로 상태 변경
    } else {
        throw IllegalStateException("잔액 부족")
    }
}

// ⭕ Good(규칙은 계좌가 스스로 지킨다.)
class GoodAccount(private var balance: Long) {
 
    fun withdraw(amount: Long) {
        require(amount > 0) { "출금액은 양수여야 합니다: $amount" }
        check(balance >= amount) { "잔액 부족: 잔액=$balance, 요청=$amount" }
        balance -= amount
    }
 
    // 상태를 통째로 노출하는 대신 필요한 '질문'만 제공
    fun canWithdraw(amount: Long): Boolean = amount in 1..balance
    fun balance(): Long = balance   // 표시용 조회는 열되, 변경은 오직 withdraw로
}

// ⭕ Good(한 메서드 안에서는 아래 네 부류의 객체에게만 메시지를 보낸다.)
@JvmInline
value class Money(val amount: Long) {
    operator fun plus(other: Money) = Money(amount + other.amount)
    companion object { val ZERO = Money(0) }
}
 
class Address(private val city: String, private val zipCode: String) {
    // Address의 내부(city/zip)를 통째로 노출하지 않고, 완성된 결과만 돌려준다.
    fun formatted(): String = "[$zipCode] $city"
}
 
class Customer(private val name: String, private val address: Address) {
    // 호출자가 address를 꺼내가지 않도록, 필요한 결과를 Customer가 조립해 준다(위임).
    fun shippingLabel(): String = "$name / ${address.formatted()}"   // (4) 필드 객체의 메서드
}
 
class OrderLine(private val unitPrice: Money, private val quantity: Int) {
    fun subtotal(): Money = Money(unitPrice.amount * quantity)
}
 
/** 영수증 — checkout 안에서 생성해 쓰는 지역 객체 */
class Receipt(private val total: Money) {
    fun print(): String = "결제 완료: ${total.amount}원"
}
 
interface PaymentGateway {
    fun charge(amount: Money): Boolean
}
 
class Order(
    private val lines: List<OrderLine>,   // 필드로 참조
    private val customer: Customer,        // 필드로 참조
) {
 
    /** (4) 필드로 참조하는 객체(lines, line)의 메서드만 호출 — 낯선 객체로 넘어가지 않는다. */
    fun total(): Money =
        lines.fold(Money.ZERO) { acc, line -> acc + line.subtotal() }
 
    /** 배송지 정보가 필요하면 customer에게 시킨다. address까지 파고들지 않는다. */
    fun shippingLabel(): String = customer.shippingLabel()   // (4) 필드 객체의 메서드
 
    /**
     * checkout — 세 부류의 호출이 모두 등장하는 예.
     * @param gateway 파라미터로 받은 객체
     */
    fun checkout(gateway: PaymentGateway): String {
        val amount = total()                       // (1) 자기 자신의 메서드
        require(gateway.charge(amount)) {          // (3) 파라미터로 받은 객체의 메서드
            "결제 실패"
        }
        val receipt = Receipt(amount)              // (2) 메서드에서 생성한 객체 ...
        return receipt.print()                     //     ... 의 메서드만 호출
    }
}