Kotlin Academy · 강의

@DslMarker: 수신 객체 누출 방지

@DslMarker 주석을 사용해 컴파일 시점에 DSL 중첩 규칙을 적용해 보세요.

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

수신 객체 누수 문제

중첩된 DSL에서는 내부 빌더 람다가 바깥 수신 객체의 멤버에 실수로 접근할 수 있습니다. 예를 들어 td { } 블록 내부에서 바깥 테이블 범위의 tr { }를 호출할 수 있는데, 이는 거의 항상 의도한 동작이 아닙니다.

누수가 발생하는 방식

@DslMarker가 없으면 컴파일러가 모든 내부 람다에서 바깥 범위의 함수를 호출하도록 허용하므로, 혼란스럽고 오류가 발생하기 쉬운 DSL 사용으로 이어집니다.

// Without @DslMarker — this compiles but is wrong:
html {
    body {
        table {
            tr {                // outer scope leaks in
                tr {  }         // calling tr inside tr — nonsensical
            }
        }
    }
}

@DslMarker 소개

@DslMarker는 직접 만든 애너테이션 클래스에 적용하는 메타 애너테이션입니다. DSL 애너테이션이 붙은 모든 빌더 클래스는 동일한 DSL 애너테이션을 사용하는 중첩 람다에서 암시적 수신 객체가 숨겨집니다.

@DslMarker
annotation class HtmlDsl

@HtmlDsl
class Table

@HtmlDsl
class Tr

암시적 수신 객체 숨김이 작동하는 방식

중첩된 두 람다가 동일한 @DslMarker 애너테이션으로 표시된 수신 객체를 모두 가지고 있으면, 내부 람다에서 바깥 수신 객체가 숨겨집니다. 바깥 수신 객체에 직접 접근하면 컴파일 오류가 발생합니다.

@DslMarker
annotation class HtmlDsl

@HtmlDsl class Html
@HtmlDsl class Body
@HtmlDsl class Div

@DslMarker를 사용한 전체 예시

애너테이션을 선언하고 빌더 클래스에 표시하면, 바깥 범위 메서드에 대한 중첩 호출을 컴파일 시 감지할 수 있습니다.

@DslMarker
annotation class MyCfgDsl

@MyCfgDsl
class ServerBuilder {
    var port: Int = 8080
    fun database(block: DbBuilder.() -> Unit) { /*...*/ }
}

@MyCfgDsl
class DbBuilder {
    var url: String = ""
    // Cannot call ServerBuilder.port here — compiler error
}

this@를 사용하여 제한에서 벗어나기

내부 람다에서 바깥 수신 객체에 실제로 접근해야 한다면 레이블이 지정된 this@OuterClass 참조를 사용하세요. 이는 실수로 발생하는 누수와 달리 명시적이고 의도적인 접근입니다.

fun ServerBuilder.database(block: DbBuilder.() -> Unit) {
    val db = DbBuilder()
    db.block()
    val serverPort = this@ServerBuilder.port  // explicit outer access
}

여러 DSL에서 @DslMarker 사용하기

서로 다른 DSL은 서로 다른 @DslMarker 애너테이션을 사용해야 합니다. 서로 관련 없는 두 DSL은 중첩되어도 서로 다른 마커를 사용하면 영향을 주지 않습니다.

@DslMarker annotation class HtmlDsl
@DslMarker annotation class GradleDsl
// HtmlDsl and GradleDsl receivers do not hide each other

빌더와 수신 객체에 적용하기

DSL 애너테이션을 빌더 클래스 자체에 적용하세요. 애너테이션은 수신 객체 타입이 해당 클래스인 모든 람다 매개변수에 전파됩니다. 개별 함수에 애너테이션을 추가로 적용할 필요는 없습니다.

IDE 지원

IntelliJ IDEA와 Android Studio는 @DslMarker를 사용하면 바깥 수신 객체에 대한 접근을 즉시 오류로 강조 표시합니다. 따라서 DSL을 작성하거나 사용하는 동안 실시간 피드백을 받을 수 있습니다.

안전성을 고려한 설계

좋은 DSL 설계에서는 각 빌더 클래스를 @DslMarker와 함께 사용합니다. 애너테이션을 추가하는 작은 부담만으로 DSL의 사용 편의성이 크게 향상되고 DSL 사용자에게 발생할 수 있는 여러 종류의 버그를 예방할 수 있습니다.

표준 라이브러리 사용 사례

Kotlin 자체의 @DslMarker는 kotlinx.html, Ktor 라우팅 DSL, Gradle Kotlin 스크립트 및 buildMap/buildList 빌더에서 사용됩니다. 이는 제대로 된 DSL 도구 모음에서 반드시 필요한 기본 도구입니다.

빠른 확인

@DslMarker는 무엇을 방지하나요?

요약: @DslMarker

핵심 요점:

@DslMarker가 없으면 바깥 수신 객체가 내부 DSL 람다로 누수됩니다
메타 애너테이션이 적용된 애너테이션 클래스를 정의하고 DSL의 모든 빌더 클래스에 적용합니다
동일한 마커를 사용하는 중첩 람다는 실수로 바깥 범위의 멤버를 호출할 수 없습니다
바깥 범위에 실제로 접근해야 할 때는 this@OuterClass를 사용합니다

자주 묻는 질문

“@DslMarker: 수신 객체 누출 방지” 강의는 무료인가요?

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

“@DslMarker: 수신 객체 누출 방지”에서 뭘 배우나요?

@DslMarker 주석을 사용해 컴파일 시점에 DSL 중첩 규칙을 적용해 보세요. 브라우저에서 직접 실행하는 실습 코드로 Kotlin Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

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

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

“@DslMarker: 수신 객체 누출 방지” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

← Kotlin Academy(으)로 돌아가기