Kotlin'de Extension property — nedir, sözdizimi ve kullanım

Kotlin'de extension property nedir?

Extension property, bildirimini değiştirmeden mevcut bir türe özellik ekleyen Kotlin'de sözdizimsel bir yapıdır. Özellik bir receiver type ile bildirilir ve bir getter içermelidir. Normal özelliklerden temel fark, backing field'ın olmamasıdır: extension property veri depolayamaz, yalnızca receiver nesnesine dayanarak hesaplama yapabilir.

Kotlin Foundation Anketi (2024)'e göre, extension properties extension functions'tan daha az popülerdir — geliştiricilerin yaklaşık %45'i bunları düzenli olarak kullanır. Bunun nedeni, durum olmaması sınırlamasıdır ve uygulama kapsamını daraltır. Yine de, bir türe mantıksal olarak bağlı hesaplanmış özellikler için extension properties en kısa seçenektir.

Extension properties bir çift statik getter ve setter metoduna derlenir. Bayt kodu seviyesinde, bir extension property çağırmak ile bir extension function çağırmak arasında fark yoktur — her ikisi de receiver parametresi olan statik metotlar haline gelir. JetBrains'e (Kotlin Docs, 2025) göre, hiçbir ek yük yoktur.

Metot çağrılarından ziyade özellik gibi görünmesi gereken kısa hesaplanmış değerler için extension properties kullanın — bu kod okunabilirliğini artırır ve Tekdüzen Erişim İlkesi'ne uyar.

Extension property sözdizimi: val ve var

Bir extension property bildirmek için, normal bir özelliğe benzer sözdizimi kullanın, ancak receiver type ön ekiyle. val zorunlu getter ile salt okunur bir extension property bildirir, var getter ve isteğe bağlı setter ile değiştirilebilir bir tane bildirir.

// Salt okunur extension property
val String.isEmail: Boolean
    get() = this.contains("@") && this.contains(".")

// Çağrı
val valid = "test@test.com".isEmail

Not: bir extension property parantez olmadan çağrılır — str.isEmail, str.isEmail() değil. Bu, extension property ve extension function arasındaki temel farktır: bir özellik, aslında bir getter aracılığıyla hesaplanmasına rağmen, bir alan gibi görünür.

Generic extension property

Extension properties generic olabilir — receiver generic tip parametreleri kullanabilir. Bu, herhangi bir koleksiyon türüyle çalışan evrensel özellikler oluşturmaya izin verir.

val List<T>.secondOrNull: T?
    get() = if (size >= 2) this[1] else null

val items = listOf("a", "b", "c")
val second = items.secondOrNull // "b"

secondOrNull özelliği herhangi bir T türü için çalışır, listenin ikinci öğesini veya ikiden az öğe varsa null döndürür. Bu, extension property'nin bir fonksiyondan daha uygun olduğu tipik bir örnektir — erişimi bir alan okumak gibi görünür.

Extension property neden durum depolayamaz

Bir extension property, sınıf metaverisine eklenmediği için backing field'a sahip olamaz — yalnızca bir çift statik getter/setter fonksiyonu olarak var olur. Backing field (Kotlin'de field anahtar kelimesi), özellik değerini depolayan sınıfın iç alanıdır. Extension property'nin sınıfın iç yapısına erişimi yoktur.

// ❌ HATA: extension property bir backing field'a sahip olamaz
var String.cachedValue: String
    get() = "computed"
    set(value) {
        field = value // alana erişilemiyor!
    }

// ✅ DOĞRU: harici depolama kullanın
val cache = MutableMap<String, String>()

var String.cachedValue: String
    get() = cache[this] ?: ""
    set(value) { cache[this] = value }

Örnekteki harici bir Map depolama sorununu çözer ancak başka bir sorun yaratır — bellek sızıntısı. Extension property aracılığıyla elde edilen değerler, temizlenmezse Map'te sonsuza kadar yaşar. Bu sınırlama, extension properties'i önbelleğe alma veya geçici veri depolama için uygunsuz hale getirir.

Önbelleğe alma için, WeakHashMap veya otomatik temizleme mekanizmalarının kullanılması önerilir. JetBrains, dikkatli bir yaşam döngüsü yönetimi olmadan üretim kodunda harici depolama ile var extension properties kullanmaktan kaçınılmasını önerir.

Extension property vs extension function: ne zaman ne seçilir

Extension property ve extension function arasındaki seçim anlambilime bağlıdır: bir özellik bir nesnenin karakteristiğini tanımlarken, bir fonksiyon bir eylemi tanımlar. Tekdüzen Erişim İlkesi şunu belirtir: istemci, bir değerin hesaplanıp hesaplanmadığını veya depolanıp depolanmadığını bilmemelidir. Değer bir karakteristik (uzunluk, boyut, durum) olarak temsil edilebiliyorsa — bir özellik kullanın.

Kural basittir: işlem parametre alıyorsa — extension function kullanın. Parametresiz basit bir hesaplanmış değerse — extension property kullanın. Android Architecture Guide'a (Google, 2025) göre, veri erişimi için extension properties ve yan etkileri olan işlemler için extension functions tercih edilmelidir.

var ve setter ile değiştirilebilir extension property

var anahtar kelimesiyle extension property bir setter'ı destekler, ancak bir değer depolama yeteneği olmadan — setter genellikle bir yan etki gerçekleştirir veya harici bir depolamaya veri kaydeder. Sözdizimi değiştirilebilir sınıf özelliklerine benzer.

// Setter ile değiştirilebilir extension property
var StringBuilder.lastChar: Char
    get() = this[length - 1]
    set(value) {
        this.setCharAt(length - 1, value)
    }

val sb = StringBuilder("Kotlin")
println(sb.lastChar) // n
sb.lastChar = '!'
println(sb) // Kotli!

lastChar özelliği Kotlin dokümantasyonundan klasik bir örnektir. Getter, StringBuilder'ın son karakterini döndürür, setter onu yeni bir değerle değiştirir. Not: durum ayrı bir alanda değil, StringBuilder'ın kendisinde (setCharAt aracılığıyla) depolanır — bu bir extension property'nin doğru kullanımıdır.

Extension properties için pratik örnekler

Gerçek projelerde, extension properties en çok koleksiyon verilerine erişimi basitleştirmek, UI öğelerinin boyutlarını veya durumlarını hesaplamak ve mevcut sınıflar üzerinde kullanışlı bir API oluşturmak için kullanılır. Kotlin standart kütüphanesi bu mekanizmayı aktif olarak kullanır: koleksiyonlar için size, indices, lastIndex — bunlar extension properties'dir.

// Koleksiyonlar için extension properties
val List<Int>.sumFast: Int
    get() = fold(0) { acc, i -> acc + i }

val String.half: String
    get() = this.substring(0, length / 2)

// Android View için extension property
val View.isVisible: Boolean
    get() = visibility == View.VISIBLE

// Güvenli receiver ile null kontrolü
val String?.isNullOrBlank: Boolean
    get() = this == null || this.isBlank()

View için extension property isVisible — her Android geliştiricisinin bilmesi gereken bir örnektir. view.visibility == View.VISIBLE yerine view.isVisible yazabilirsiniz. Bu sadece daha kısa değil, aynı zamanda doğal dil gibi okunur: “görünüm görünürse”. Basitliğine rağmen, bu tür özellikler kod okunabilirliğini önemli ölçüde artırır.