Bölüm 12 — Konu 56: Extension Methods

#Sorun: Var Olan Bir Sınıfa Nasıl Metod Eklersin?

Diyelim ki String sınıfına, ilk harfini büyük yapan bir metod eklemek istiyorsun. Ama Bölüm 7'de öğrendiğimiz gibi, String Dart'ın kendi kütüphanesinde tanımlı — onun kaynak koduna doğrudan erişimin yok, extends String de yapamazsın (çünkü String'in kendi iç yapısı buna izin vermez).

void main() {
  String isim = "ahmet";
  print(isim.capitalize()); // ❌ Böyle bir metod yok!
}

Extension methods, tam olarak bu problemi çözmek için var: var olan herhangi bir sınıfa (kendi yazdığın veya Dart'ın kendi sınıfları), yeni metodlar "ekleyebilmeni" sağlar — sınıfın kendisini değiştirmeden.

#Extension Tanımlama

extension StringUzantilari on String {
  String capitalize() {
    if (isEmpty) return this;
    return this[0].toUpperCase() + substring(1);
  }
}

void main() {
  String isim = "ahmet";
  print(isim.capitalize()); // Ahmet
}

Sözdizimi: extension UzantiAdi on HedefTip { ... }

• StringUzantilari — extension'ın adı (isteğe bağlı, ama koyman önerilir — adsız extension'lar da yazılabilir, birazdan göreceğiz).
• on String — bu extension'ın hangi tipe uygulandığını belirtir.
• İçindeki metodlar, sanki String sınıfının kendi metodlarıymış gibi çağrılabilir hale gelir.

#Extension İçinde this Kullanımı

extension StringUzantilari on String {
  String tersCevir() {
    return String.fromCharCodes(this.runes.toList().reversed);
  }
}

void main() {
  print("merhaba".tersCevir()); // abahrem
}

Extension metodu içinde this, extension'ın uygulandığı nesnenin kendisini temsil eder (burada, çağrıldığı String'i) — Bölüm 6'da öğrendiğimiz this kullanımıyla aynı mantık, sadece burada "kendi sınıfın" değil, "genişlettiğin" sınıfın bir örneğine işaret ediyor.

#Kendi Sınıflarına Extension Ekleme

Extension'lar sadece Dart'ın kendi sınıfları için değil, senin yazdığın sınıflar için de kullanılabilir — bu, özellikle bir sınıfa her zaman erişimin olmadığı durumlarda (örneğin başka bir kütüphaneden gelen bir sınıf) veya sınıfın ana tanımını sade tutmak istediğinde kullanışlıdır:

class Urun {
  String ad;
  double fiyat;
  Urun(this.ad, this.fiyat);
}

extension UrunUzantilari on Urun {
  String get formatliFiyat => "${fiyat.toStringAsFixed(2)} TL";

  bool get indirimdeMi => fiyat < 50;
}

void main() {
  Urun urun = Urun("Kalem", 15.5);
  print(urun.formatliFiyat); // 15.50 TL
  print(urun.indirimdeMi);   // true
}

Bölüm 6'da öğrendiğimiz getter kavramını, extension içinde de kullanabildiğimizi görüyorsun — extension'lar, metodların yanında getter/setter da tanımlayabilir.

#Neden Urun Sınıfının İçine Yazmıyoruz? — Ayrım Nedeni

// Alternatif: doğrudan sınıfın içinde
class Urun {
  String ad;
  double fiyat;
  Urun(this.ad, this.fiyat);

  String get formatliFiyat => "${fiyat.toStringAsFixed(2)} TL"; // burada da tanımlanabilirdi
}

Bu, teknik olarak da geçerlidir — peki extension'ın avantajı ne? İki temel senaryo:

1. Sınıfın kaynak koduna erişimin yoksa (örneğin bir paketten gelen bir sınıf, String gibi Dart'ın kendi sınıfları) — extension, tek çözümdür.
2. Sınıfın "temel" tanımını, ona ait farklı "yeteneklerden" ayırmak istiyorsan — örneğin bir Urun sınıfının temel veri yapısı bir dosyada, "gösterim mantığı" (formatlama gibi) ayrı bir dosyada extension olarak tutulabilir. Bu, Bölüm 12 Konu 54'te öğrendiğimiz dosya organizasyonu mantığına benzer bir ayrım sağlar.

#Birden Fazla Extension — Çakışma Durumu

extension A on String {
  String selamla() => "A: Merhaba $this";
}

extension B on String {
  String selamla() => "B: Merhaba $this";
}

void main() {
  print("Ahmet".selamla()); // ❌ HATA! Birden fazla extension aynı metodu tanımlıyor, belirsiz
}

Eğer aynı tipte, aynı isimli metod tanımlayan iki extension aynı anda kullanılabilir durumdaysa (ikisi de import edilmişse), Dart hangisini çağıracağını bilemez ve hata verir. Bu durumda, hangi extension'ı kastettiğini açıkça belirtmen gerekir:

void main() {
  print(A("Ahmet").selamla()); // A extension'ını açıkça belirt
}

Bu senaryo nadir karşına çıkar (genelde farklı paketlerden gelen extension'lar çakıştığında), ama var olduğunu bilmen faydalı.

#Extension'lar Nesnenin Kendisini Değiştiremez

extension SayiUzantisi on int {
  void ikiyeKatla() {
    this = this * 2; // ❌ HATA! 'this' değiştirilemez
  }
}

Extension metodları, yeni bir değer döndürebilir ama çağrıldıkları nesneyi doğrudan değiştiremez (mutate edemez) — çünkü extension'lar, aslında arka planda statik fonksiyonlar gibi çalışır (Bölüm 6'da öğrendiğimiz static kavramına benzer bir mekanizma), gerçek bir kalıtım veya nesne değişikliği söz konusu değildir:

extension SayiUzantisi on int {
  int ikiyeKatla() => this * 2; // ✅ doğrusu — yeni bir değer DÖNDÜR
}

void main() {
  int sayi = 5;
  int sonuc = sayi.ikiyeKatla();
  print(sonuc); // 10
  print(sayi);  // 5 — orijinal değer değişmedi!
}

#Nullable Tipler Üzerinde Extension

extension NullableStringUzantisi on String? {
  bool get boşMuYaDaNull => this == null || this!.isEmpty;
}

void main() {
  String? isim1 = null;
  String? isim2 = "";
  String? isim3 = "Ahmet";

  print(isim1.boşMuYaDaNull); // true
  print(isim2.boşMuYaDaNull); // true
  print(isim3.boşMuYaDaNull); // false
}

Bölüm 2'de öğrendiğimiz null safety, extension'larla da uyumlu çalışır — on String? yazarak, extension'ı nullable bir tip üzerinde de tanımlayabilirsin. Bu, null kontrolü içeren yardımcı metodlar yazmak için kullanışlıdır (yukarıdaki örnek, ??/?.'ye ek bir kolaylık sağlıyor).

#Gerçek Dünya Kullanımı — Flutter Bağlantısı

Extension'lar, Flutter geliştirmede son derece yaygındır — örneğin BuildContext (Flutter'ın temel bir sınıfı) üzerine, ekran boyutunu almak, tema renklerine kolayca erişmek gibi extension'lar yazmak çok sık karşılaşacağın bir pratiktir. Bunu Flutter tutorial'ında somut örneklerle göreceğiz; burada öğrendiğin temel mekanizma, orada doğrudan işine yarayacak.

#🎯 Bu Dersten Çıkarılması Gerekenler

• Extension methods, var olan bir sınıfa (kendi sınıfların veya Dart'ın kendi sınıfları) yeni metod/getter/setter eklemeni sağlar, sınıfın kendisini değiştirmeden.
• extension Ad on Tip { ... } sözdizimiyle tanımlanır; içinde this, genişletilen nesnenin kendisini temsil eder.
• Extension'lar, nesneyi doğrudan değiştiremez — her zaman yeni bir değer döndürmelidir.
• Aynı tipte, aynı isimli birden fazla extension çakışırsa, hangisinin kullanılacağını açıkça belirtmen gerekir.
• Nullable tipler üzerinde de extension tanımlanabilir (on String? gibi).
• Flutter geliştirmede, özellikle BuildContext gibi çekirdek sınıflara ek kolaylıklar eklemek için çok sık kullanılır.

#📝 Ödevler

• [ ] String sınıfına, bir cümledeki her kelimenin ilk harfini büyük yapan bir extension metodu yaz (capitalizeWords() gibi).
• [ ] Kendi yazdığın bir sınıfa (örn. Urun), en az bir metod ve bir getter içeren bir extension ekle.
• [ ] int sınıfına, bir sayının asal olup olmadığını kontrol eden bir extension metodu yaz.
• [ ] Nullable bir tip üzerinde (on int? gibi) bir extension tanımla, null kontrolü içeren kullanışlı bir getter/metod ekle.
• [ ] Extension'ın nesneyi değiştiremediğini (sadece yeni değer döndürebildiğini) kanıtlayan bir örnek yaz — önce yanlış (mutate etmeye çalışan) bir versiyon dene, hatayı gözlemle, sonra doğru (yeni değer döndüren) versiyonu yaz.

Sıradaki konu: Bölüm 12 — Konu 57: Dart'ın Derleme Modelleri (JIT vs AOT) ve Bunun Flutter'a Etkisi