Kotlin Academy · 강의

봉인된 Result 계층

사용자 지정 결과 유형

레슨 3/413개 단계

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

내장 Result를 넘어서

코틀린의 Result는 실패할 때 예외만 담습니다. 더 풍부하고 유형이 지정된 오류 정보가 필요한 경우가 많습니다. 봉인 클래스 계층 구조를 사용하면 해당 도메인에서 가능한 결과를 정확하게 모델링할 수 있습니다.

봉인된 Outcome

success 하위 클래스와 오류 하위 클래스를 가진 봉인 타입을 정의하십시오. 컴파일러가 모든 경우를 알고 있으므로 빠짐없이 처리할 수 있습니다.

sealed class Outcome<out T> {
    data class Ok<T>(val value: T) : Outcome<T>()
    data class Err(val message: String) : Outcome<Nothing>()
}

fun main() {
    val r: Outcome<Int> = Outcome.Ok(5)
    println(r)
}

모든 경우를 처리하는 분기

타입이 봉인되어 있으므로 해당 타입을 대상으로 한 when에는 else가 필요하지 않습니다. 컴파일러가 모든 경우를 처리하도록 강제합니다.

sealed class Outcome<out T> {
    data class Ok<T>(val value: T) : Outcome<T>()
    data class Err(val message: String) : Outcome<Nothing>()
}

fun describe(o: Outcome<Int>) = when (o) {
    is Outcome.Ok -> "value " + o.value
    is Outcome.Err -> "error " + o.message
}

fun main() {
    println(describe(Outcome.Ok(9)))
    println(describe(Outcome.Err("boom")))
}

유형이 지정된 오류 변형

서로 다른 실패 종류를 각각 관련 데이터를 담는 별도의 하위 클래스로 모델링하십시오. 하나의 불투명한 예외를 사용하는 것보다 낫습니다.

sealed class Fetch<out T> {
    data class Success<T>(val data: T) : Fetch<T>()
    data class NotFound(val id: Int) : Fetch<Nothing>()
    data class Network(val code: Int) : Fetch<Nothing>()
}

fun main() {
    val r: Fetch<String> = Fetch.NotFound(42)
    println(r)
}

각 변형 처리하기

when을 사용하면 각 오류 타입에 구체적으로 대응할 수 있으며, 각 분기에서 모든 데이터를 사용할 수 있습니다.

sealed class Fetch<out T> {
    data class Success<T>(val data: T) : Fetch<T>()
    data class NotFound(val id: Int) : Fetch<Nothing>()
    data class Network(val code: Int) : Fetch<Nothing>()
}

fun handle(f: Fetch<String>) = when (f) {
    is Fetch.Success -> "data: " + f.data
    is Fetch.NotFound -> "missing id " + f.id
    is Fetch.Network -> "net error " + f.code
}

fun main() {
    println(handle(Fetch.Network(503)))
}

Nothing 활용법

성공 값을 담지 않는 오류 변형에는 Outcome<Nothing>을 사용합니다. Nothing은 모든 타입의 하위 타입이고 제네릭이 out이므로, 오류는 어떤 Outcome<T>에도 들어맞습니다.

sealed class Res<out T> {
    data class Ok<T>(val v: T) : Res<T>()
    object Empty : Res<Nothing>()
}

fun get(flag: Boolean): Res<String> =
    if (flag) Res.Ok("hi") else Res.Empty

fun main() {
    println(get(false))
}

상태가 없는 경우의 싱글턴

오류 변형이 데이터를 담지 않는다면 클래스를 사용하는 대신 object 싱글턴으로 선언하십시오.

sealed class Login {
    data class Success(val user: String) : Login()
    object WrongPassword : Login()
    object Locked : Login()
}

fun main() {
    val r: Login = Login.WrongPassword
    println(r === Login.WrongPassword)
}

계층 구조 반환하기

함수는 봉인 타입을 반환하므로 호출자는 모든 결과를 처리해야 하며, 누락된 오류 경로가 사라집니다.

sealed class Parsed {
    data class Num(val value: Int) : Parsed()
    data class Bad(val input: String) : Parsed()
}

fun parse(s: String): Parsed {
    val n = s.toIntOrNull()
    return if (n != null) Parsed.Num(n) else Parsed.Bad(s)
}

fun main() {
    when (val r = parse("x")) {
        is Parsed.Num -> println(r.value)
        is Parsed.Bad -> println("bad: " + r.input)
    }
}

봉인 타입과 내장 Result 비교

빠르게 예외를 기반으로 포착하려면 내장 Result를 사용하십시오. 도메인별 데이터가 포함된 여러 유형의 오류 경우와 빠짐없는 처리가 필요하다면 사용자 정의 봉인 계층 구조를 사용하십시오.

계층 구조 설계하기

좋은 봉인 결과 설계는 다음과 같습니다.

데이터를 담는 하나의 success 변형
의미 있는 각 실패 방식마다 하나의 하위 클래스
오류만 나타내는 경우에는 Nothing과 함께 out T 변성 사용

안전망 역할을 하는 컴파일러

가장 큰 장점은 나중에 새 변형을 추가할 때마다, 모든 경우를 처리하지 않는 when이 컴파일 오류가 된다는 점입니다. 컴파일러가 처리해야 하는 각 위치를 알려 주므로 오류가 조용히 누락될 수 없습니다.

빠른 확인

봉인된 결과 계층 구조에 대한 이해도를 확인해 보십시오.

인터랙티브 레슨에서 답해보세요

복습

봉인된 결과 계층 구조를 만들었습니다.

success와 유형이 지정된 오류 변형
else 없이 모든 경우를 처리하는 when
오류만 나타내는 경우를 위한 out T 및 Nothing
새 변형 처리를 강제하는 컴파일러

다음 주제: map과 recover를 활용한 함수형 오류 처리입니다.

무료로 시작

AI 튜터와 함께 Kotlin을(를) 배우세요 — 무료

브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.

코스: 51
레슨: 203

무료로 학습 시작 전체 코스 보기

자주 묻는 질문

“봉인된 Result 계층” 강의는 무료인가요?

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

“봉인된 Result 계층”에서 뭘 배우나요?

사용자 지정 결과 유형 브라우저에서 직접 실행하는 실습 코드로 Kotlin Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

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

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

“봉인된 Result 계층” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

← Kotlin Academy(으)로 돌아가기