Kotlin Academy · 강의

사용 사례

도메인 모델링

사용 사례은(는) CoddyKit의 무료 Kotlin Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Kotlin Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

도메인 모델 구성

값 클래스는 도메인 모델 구성에 특히 유용합니다. 이름 없는 기본 타입을 실행 비용 없이 의미 있고 실수를 방지하는 타입으로 바꿔 줍니다.

현실적인 시나리오를 함께 살펴보겠습니다.

타입이 지정된 식별자

고유한 ID 타입을 사용하면 주문 ID가 필요한 곳에 사용자 ID를 전달하는 일을 방지할 수 있습니다. 이는 흔하고 큰 비용을 초래하는 버그입니다.

@JvmInline
value class UserId(val value: Long)
@JvmInline
value class OrderId(val value: Long)

fun fetchUser(id: UserId) = "user " + id.value

fun main() {
    println(fetchUser(UserId(7)))
}

측정 단위

숫자를 단위 타입으로 감싸면 실수로 미터에 초를 더하는 일을 막고 그 값의 의미도 문서화할 수 있습니다.

@JvmInline
value class Kilograms(val value: Double)

fun describe(weight: Kilograms) = weight.value.toString() + " kg"

fun main() {
    println(describe(Kilograms(72.5)))
}

검증된 문자열

값 클래스와 init 블록을 함께 사용하면 비어 있지 않은 이메일과 같은 불변 조건을 보장할 수 있습니다.

@JvmInline
value class Email(val value: String) {
    init {
        require(value.contains("@")) { "invalid email" }
    }
}

fun main() {
    println(Email("a@b.com").value)
}

동작을 갖는 화폐 금액

화폐 금액을 가장 작은 단위로 표현하고 연산을 추가하면 부동 소수점 화폐 계산 오류를 피할 수 있습니다.

@JvmInline
value class Cents(val value: Long) {
    operator fun plus(other: Cents) = Cents(value + other.value)
    fun format() = "$" + value / 100.0
}

fun main() {
    val total = Cents(1500) + Cents(250)
    println(total.format())
}

의미가 드러나는 인터페이스

값 클래스를 사용한 함수 선언은 의미 없는 정수 세 개만 사용하는 선언보다 훨씬 명확합니다.

@JvmInline
value class Width(val px: Int)
@JvmInline
value class Height(val px: Int)

fun area(w: Width, h: Height) = w.px * h.px

fun main() {
    println(area(Width(4), Height(5)))
}

민감한 데이터 감싸기

값 클래스에서 toString을 재정의하면 로그에 비밀 정보가 노출되지 않도록 가리면서 원래 값에는 계속 접근할 수 있습니다.

@JvmInline
value class Token(val value: String) {
    override fun toString() = "Token(***)"
}

fun main() {
    val t = Token("abc123")
    println(t)          // masked
    println(t.value)    // real value when needed
}

범위 적용

값 클래스를 사용하여 범위 규칙을 한곳에 모아 두면 어디에서도 유효하지 않은 상태를 만들 수 없습니다.

@JvmInline
value class Rating(val stars: Int) {
    init {
        require(stars in 1..5) { "stars must be 1..5" }
    }
}

fun main() {
    println(Rating(4).stars)
}

스마트 생성자

값 클래스와 동반 객체의 생성 함수를 함께 사용하면 잘못된 입력에서 예외를 발생시키는 대신 null을 반환할 수 있습니다.

@JvmInline
value class Age(val value: Int) {
    companion object {
        fun of(n: Int): Age? = if (n in 0..150) Age(n) else null
    }
}

fun main() {
    println(Age.of(30)?.value)
    println(Age.of(-5))
}

패턴 요약

일반적인 값 클래스 패턴은 다음과 같습니다.

혼동을 방지하는 타입이 지정된 ID
측정 단위
init을 사용한 검증된 기본 타입
연산자를 통한 도메인 연산
가려진 민감한 값

저렴한 안전성

값 클래스는 대체로 인라인화되므로 실행 비용이 사실상 0에 가까운 상태에서 이렇게 명확하고 안전한 도메인 모델을 얻을 수 있습니다. 잘못된 상태를 표현할 수 없게 만드는 부담이 적은 방법입니다.

빠른 확인

값 클래스의 사용 사례에 대한 이해도를 확인해 보세요.

복습

값 클래스의 실용적인 사용 사례를 살펴보았습니다.

타입이 지정된 ID, 단위, 검증된 문자열
화폐 금액과 도메인 연산
비밀 정보 가리기와 스마트 생성자

다음: 값 클래스의 제한 사항

자주 묻는 질문

“사용 사례” 강의는 무료인가요?

네 — “사용 사례” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Kotlin Academy 강의 전체를 잠금 해제할 수 있습니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“사용 사례”에서 뭘 배우나요?

도메인 모델링 브라우저에서 직접 실행하는 실습 코드로 Kotlin Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Kotlin Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Kotlin Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“사용 사례” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Kotlin Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Kotlin Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Kotlin Academy(으)로 돌아가기