Type-safe builder

@DslMarker ile type-safe builder öğrenirsin.

@DslMarker ne işe yarar?

Bir DSL yazarken iç içe lambda bloklarında yanlışlıkla dış bloktaki alıcıyı (receiver) kullanabilirsin. @DslMarker bu sınırlamayı getirir.

@DslMarker annotation class MenuDsl ile bir işaret tanımlarsın. Aynı işareti taşıyan tüm alıcı sınıflar, iç içe bloklarda birbirine karışmaz. Böylece item { name = "Çorba" } içinde yanlışlıkla üst menu bloğuna erişemezsin. Bu, derleme zamanı korumasıdır; runtime yükü yoktur. Kotlin standart kütüphanesinde html { ... } gibi DSL'lerde karşına çıkar.

Bir builder DSL

Bir tip-güvenli builder (type-safe builder) yazmak için bir sınıfa @MenuDsl işareti eklersin ve ona bir extension işlevi verirsin.

Örnek: @MenuDsl class Menu { val items = mutableListOf<Item>(); fun item(block: Item.() -> Unit) { items.add(Item().apply(block)) } }. En dışta fun menu(block: Menu.() -> Unit): Menu = Menu().apply(block) bulunur. Bu sayede menu { item { name = "Çorba" } } yazabilirsin. @DslMarker sayesinde item bloğu içinde yanlışlıkla menu'nun items listesine dokunamazsın.

Uygulama menü DSL yaz

@DslMarker annotation class MenuDsl tanımla. Item sınıfı var name: String = "" ve var price: Int = 0 içersin. @MenuDsl class Menu içinde val items = mutableListOf<Item>() ve fun item(block: Item.() -> Unit) olsun. menu fonksiyonu ve main içinde iki öğe ekle, println(m.items.size) yaz.

Örnek çözümü göster

@DslMarker
annotation class MenuDsl
class Item { var name: String = ""; var price: Int = 0 }
@MenuDsl
class Menu {
    val items = mutableListOf<Item>()
    fun item(block: Item.() -> Unit) { items.add(Item().apply(block)) }
}
fun menu(block: Menu.() -> Unit): Menu = Menu().apply(block)
fun main() {
    val m = menu {
        item { name = "Çorba"; price = 30 }
        item { name = "Pilav"; price = 45 }
    }
    println(m.items.size)
}

Kendini test et

@DslMarker annotation tanımla

____
annotation class MenuDsl

Cevabı göster

@DslMarker
annotation class MenuDsl

@DslMarker neyi engeller?
- Lambda'nın çalışma zamanı hatasını
- Inline fonksiyonların derlenmesini
- Annotation sınıfı tanımlanmasını
- İç içe DSL bloklarında dış alıcının yanlış kullanımını
Cevabı göster

İç içe DSL bloklarında dış alıcının yanlış kullanımını — @DslMarker dış bloğun alıcısının iç bloktan yanlışça erişilmesini engeller.
Builder parçalarını eşle

@DslMarker

İşaret tanımı
annotation class

İşaret sınıfı
@MenuDsl

Alıcı işareti
block: Item.() -> Unit

Lambda alıcı tipi

Sıradaki ders: Özet - Compile-time safety

Deneyiminizi Geliştiriyoruz

Çerez Tercihleri

Kesinlikle Gerekli Çerezler

Analitik Çerezler