Singleton Kalıbı

Coddy'nin Dart Journey'sinin Nesne Yönelimli Programlama bölümünün bir parçası — ders 90 / 110.

Singleton deseni, bir sınıfın tüm uygulamanız boyunca yalnızca bir örneğe sahip olmasını sağlar ve ona küresel bir erişim noktası sunar. Bu, sistem genelindeki eylemleri koordine etmek için tam olarak bir nesneye ihtiyaç duyulduğunda (bir yapılandırma yöneticisi, bir veritabanı bağlantısı veya bir günlük kaydı servisi gibi) yararlıdır.

Dart'ta, özel bir statik örnekle (private static instance) birleştirilmiş bir fabrika kurucusu (factory constructor) kullanarak bir Singleton uygulayabilirsiniz:

class AppConfig {
  static final AppConfig _instance = AppConfig._internal();
  
  String appName = 'MyApp';
  String version = '1.0.0';
  
  // Özel isimlendirilmiş kurucu
  AppConfig._internal();
  
  // Factory kurucusu aynı örneği döndürür
  factory AppConfig() {
    return _instance;
  }
}

void main() {
  var config1 = AppConfig();
  var config2 = AppConfig();
  
  config1.appName = 'UpdatedApp';
  
  print(config2.appName);  // UpdatedApp
  print(identical(config1, config2));  // true
}

Özel yapıcı metot _internal() dışarıdan örnek oluşturulmasını engeller. Statik _instance alanı, sınıf yüklendiğinde bir kez oluşturulan tekil örneği tutar. Her AppConfig() çağrısı bu aynı örneği döndürür, bu nedenle bir referans üzerinden yapılan değişiklikler her yerde görünür.

Singleton'ları idareli kullanın - küresel durum (global state) getirirler, bu da testi zorlaştırabilir. Uygulamanız genelinde tutarlı bir duruma ihtiyaç duyan, gerçekten paylaşılan kaynaklar için en uygunudurlar.

Görev

Kolay

Singleton desenini kullanarak bir oyun ayarları yöneticisi oluşturalım! Uygulama boyunca yalnızca bir oyun ayarları örneğinin var olmasını sağlayan bir sistem oluşturacaksınız, böylece oyununuzun tüm bölümleri aynı yapılandırmayı paylaşacak.

Kodunuzu iki dosyada düzenleyeceksiniz:

game_settings.dart: Singleton desenini uygulayan bir GameSettings sınıfı oluşturun. Ayarlar yöneticiniz şunlara sahip olmalıdır:
- Tek GameSettings nesnesini tutan özel bir statik final örneği (instance)
- Dışarıdan örnek oluşturulmasını önlemek için özel bir isimlendirilmiş yapıcı (private named constructor)
- Her zaman aynı örneği döndüren bir fabrika yapıcısı (factory constructor)
- Üç ayar alanı: difficulty (String, varsayılan: "Normal"), soundEnabled (bool, varsayılan: true) ve playerName (String, varsayılan: "Player1")
- Mevcut ayarları şu formatta yazdıran bir displaySettings() metodu: Settings: [playerName] | Difficulty: [difficulty] | Sound: [on/off] (soundEnabled true ise "on", false ise "off" yazdırın)
main.dart: Oyun ayarlarınızı içe aktarın ve Singleton'ın doğru çalıştığını gösterin:
- Ayarlar örneğini alın ve ona settings1 adını verin
- Varsayılan değerleri göstermek için displaySettings() metodunu çağırın
- Ayarları değiştirin: playerName değerini "Hero", difficulty değerini "Hard" ve soundEnabled değerini false yapın
- Ayarlara başka bir referans alın ve ona settings2 adını verin
- settings1 üzerinden yapılan değişiklikleri yansıttığını kanıtlamak için settings2 üzerinde displaySettings() metodunu çağırın
- settings1 ve settings2'nin aynı olup olmadığını şu şekilde yazdırın: Same instance: [true/false]

Bu, Singleton'ların temel faydasını gösterir - uygulamanızın herhangi bir yerinde yapılan değişiklikler, yalnızca bir örnek olduğu için her yerde anında görünür!

Beklenen çıktı:

Settings: Player1 | Difficulty: Normal | Sound: on
Settings: Hero | Difficulty: Hard | Sound: off
Same instance: true

Kopya kağıdı

Singleton deseni, bir sınıfın tüm uygulamanız boyunca yalnızca bir örneğe sahip olmasını sağlar ve bu örneğe küresel bir erişim noktası sunar.

Dart'ta, bir Singleton'ı özel bir statik örnekle birleştirilmiş bir fabrika kurucusu (factory constructor) kullanarak uygulayın:

class AppConfig {
  static final AppConfig _instance = AppConfig._internal();
  
  String appName = 'MyApp';
  String version = '1.0.0';
  
  // Özel adlandırılmış kurucu
  AppConfig._internal();
  
  // Fabrika kurucusu aynı örneği döndürür
  factory AppConfig() {
    return _instance;
  }
}

Temel bileşenler:

static final _instance: Sınıf yüklendiğinde bir kez oluşturulan tek örneği tutar
_internal(): Özel kurucu, harici başlatmayı önler
factory AppConfig(): Her seferinde aynı örneği döndürür

Kullanım örneği:

var config1 = AppConfig();
var config2 = AppConfig();

config1.appName = 'UpdatedApp';

print(config2.appName);  // UpdatedApp
print(identical(config1, config2));  // true

Bir referans üzerinden yapılan değişiklikler her yerde görünür çünkü tüm referanslar aynı örneği işaret eder.

Kendin dene

import 'game_settings.dart';

void main() {
  // TODO: Ayarlar örneğini alın ve ona settings1 adını verin
  
  // TODO: Varsayılan değerleri göstermek için displaySettings() fonksiyonunu çağırın
  
  // TODO: Ayarları değiştirin:
  // - playerName değerini "Hero" olarak değiştirin
  // - difficulty değerini "Hard" olarak değiştirin
  // - soundEnabled değerini false olarak değiştirin
  
  // TODO: Ayarlara başka bir referans alın ve ona settings2 adını verin
  
  // TODO: Değişiklikleri yansıttığını kanıtlamak için settings2 üzerinde displaySettings() fonksiyonunu çağırın
  
  // TODO: settings1 ve settings2 nesnelerinin aynı olup olmadığını yazdırın
  // Format: Same instance: [true/false]
}