Kotlin Academy · 강의

Arrow Raise DSL: 형식이 지정된 오류 조합하기

Arrow의 Raise 컨텍스트와 raise()를 사용해 여러 오류 흐름을 깔끔하게 조합합니다.

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

Either 연결의 한계

여러 순차 작업을 수행할 때 Either를 flatMap으로 연결하면 람다가 깊게 중첩됩니다. Arrow의 Raise DSL(Arrow 1.2에서 도입)은 Kotlin의 컨텍스트 수신자나 확장 함수를 사용하여 코루틴 스타일의 더 간결한 구문을 제공합니다.

Raise<E>란 무엇인가요

Raise는 E 타입의 오류를 발생시켜 조기 종료할 수 있는 컨텍스트입니다. 실패할 수 있는 함수는 raise(error)를 호출하여 실행을 중단하고 오류를 전파합니다. 예외를 던지는 것과 비슷하지만 예외를 사용하지 않습니다.

either { } 빌더

either { } 빌더는 Raise가 범위에 포함된 블록으로부터 Either를 생성합니다. 블록 내부에서는 실패할 때 raise(error)를 호출하고, 성공할 때는 값을 그대로 반환합니다:

import arrow.core.raise.either
import arrow.core.raise.Raise

fun validateAge(age: Int): Either<String, Int> = either {
    if (age < 0) raise("Age cannot be negative")
    if (age > 150) raise("Age too large")
    age
}

bind() — either{} 내부에서 Either 언래핑하기

either { } 블록 내부에서는 모든 Either 값에 .bind()를 호출하여 언래핑합니다. 값이 Left이면 bind()가 자동으로 오류를 발생시키고 블록을 즉시 종료합니다:

fun createUser(name: String, age: Int): Either<String, User> = either {
    val validName = validateName(name).bind()  // raises if Left
    val validAge  = validateAge(age).bind()    // raises if Left
    User(validName, validAge)                  // only reached if both succeed
}

ensure() — 인라인 조건 확인

ensure(condition) { error }는 if (!condition) raise(error)를 간단히 줄여 쓴 것입니다. 검증 로직을 간결하게 유지할 수 있습니다:

fun validateEmail(email: String): Either<String, String> = either {
    ensure(email.contains("@")) { "Email must contain @" }
    ensure(email.length <= 255) { "Email too long" }
    email
}

ensureNotNull() — Raise를 사용한 null 확인

ensureNotNull(value) { error }는 null을 허용하는 값의 포장을 풀고, 값이 null이면 오류를 발생시킵니다:

fun findUser(id: Long, repo: UserRepo): Either<UserError, User> = either {
    ensureNotNull(repo.findById(id)) { UserError.NotFound(id) }
}

컨텍스트 수신자를 사용한 Raise(Arrow 1.2 이상)

either { }로 감싸지 않고도 Raise 컨텍스트가 필요한 함수를 직접 선언할 수 있습니다:

context(Raise<String>)
fun requirePositive(n: Int): Int {
    ensure(n > 0) { "Must be positive" }
    return n
}

// Called inside either { }
val result = either { requirePositive(-1) }  // Left("Must be positive")

zipOrAccumulate으로 오류 누적하기

기본적으로 Raise는 첫 번째 오류에서 실행을 중단합니다. zipOrAccumulate()을 사용하면 여러 검증을 실행하고 모든 오류를 NonEmptyList에 수집할 수 있습니다:

val result: Either<NonEmptyList<String>, User> = either {
    zipOrAccumulate(
        { validateName(name).bind() },
        { validateAge(age).bind() }
    ) { validName, validAge -> User(validName, validAge) }
}

recover { } — 특정 오류 처리하기

either { } 내부에서 recover { error -> ... }를 사용하면 특정 오류를 처리하고 대체 값을 제공하여 계산을 계속할 수 있습니다:

val name: String = either {
    findUser(0L).bind().name
}.recover { error ->
    if (error == UserError.NotFound) "Guest" else raise(error)
}.getOrNull() ?: "Guest"

Raise와 Either 연결: 각각 언제 사용할까요

여러 순차 단계로 이루어진 선형 흐름에는 either { }.bind()를 사용합니다. 명령형 코드처럼 읽히면서도 순수성을 유지합니다. 짧은 2단계 조합이나 다른 함수형 라이브러리와 조합할 때는 flatMap 연결을 사용합니다.

Raise 기반 함수 테스트하기

either { } 내부에서 함수를 호출하고 결과를 단언하여 테스트합니다. Arrow의 shouldBeLeft()와 shouldBeRight() Kotest 매처를 사용하면 단언문을 간결하게 작성할 수 있습니다:

import arrow.core.shouldBeLeft
import arrow.core.shouldBeRight

@Test
fun `negative age returns Left`() {
    validateAge(-1).shouldBeLeft()
}

@Test
fun `valid age returns Right`() {
    validateAge(25).shouldBeRight(25)
}

빠른 확인

either { } 블록 내부에서 Either.Left 값에 .bind()를 호출하면 어떻게 되나요?

복습: Arrow Raise DSL

핵심 내용:

either { }는 Raise가 범위에 포함된 블록으로부터 Either를 생성합니다
.bind()는 Either를 언래핑하고, Left에서 실행을 중단합니다
ensure(condition) { error }와 ensureNotNull(value) { error }는 인라인 확인에 사용합니다
실행을 중단하는 대신 여러 오류를 수집하려면 zipOrAccumulate()을 사용합니다
순수 함수형 방식을 유지하면서 명령형 코드처럼 읽힙니다

자주 묻는 질문

“Arrow Raise DSL: 형식이 지정된 오류 조합하기” 강의는 무료인가요?

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

“Arrow Raise DSL: 형식이 지정된 오류 조합하기”에서 뭘 배우나요?

Arrow의 Raise 컨텍스트와 raise()를 사용해 여러 오류 흐름을 깔끔하게 조합합니다. 브라우저에서 직접 실행하는 실습 코드로 Kotlin Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

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

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

“Arrow Raise DSL: 형식이 지정된 오류 조합하기” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

← Kotlin Academy(으)로 돌아가기