Asenkron Kurucular

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

Dart'taki kurucular (constructors) async olarak işaretlenemez - bir Future değil, sınıfın bir örneğini anında döndürmelidirler. Peki, bir veritabanından veri yüklemek veya yapılandırma getirmek gibi asenkron başlatma gerektiren nesneleri nasıl oluşturursunuz?

Çözüm, statik bir asenkron fabrika metodu kullanmaktır. Yapıcıyı (constructor) gizli (private) (veya basit) tutun ve asenkron işlemi gerçekleştiren ve sınıfınızın bir Future nesnesini döndüren statik bir metot sağlayın:

class UserProfile {
  final String name;
  final int age;
  
  UserProfile._(this.name, this.age);  // Özel kurucu metot
  
  static Future<UserProfile> create(String userId) async {
    // Veri getirmeyi simüle et
    await Future.delayed(Duration(seconds: 1));
    return UserProfile._('Alice', 25);
  }
}

Future<void> main() async {
  var user = await UserProfile.create('123');
  print(user.name);  // Alice
}

Özel yapıcı UserProfile._ asıl nesne oluşturma işlemini gerçekleştirirken, statik create() yöntemi tüm asenkron işleri halleder. Çağıranlar, tamamen başlatılmış nesneyi elde etmek için await kullanır.

Bu desen, nesnenizin elinize geçtiğinde tamamen kullanıma hazır olmasını sağlar; kısmen başlatılmış durumlar veya eksik veriler söz konusu olmaz. Kaynak yüklemesi gereken, servislere bağlanan veya zaman alan herhangi bir kurulum işlemi gerçekleştiren sınıflar için yaygın olarak kullanılır.

Görev

Kolay

Sınıflarda asenkron başlatmanın nasıl yönetileceğini gösteren bir yapılandırma yükleyici (configuration loader) oluşturalım! Yapıcılar (constructors) asenkron olamayacağı için, verilerini "yüklemek" için zamana ihtiyaç duyan nesneler oluşturmak üzere statik fabrika metodu (static factory method) desenini kullanacaksınız.

Kodunuzu iki dosya halinde düzenleyeceksiniz:

config_loader.dart: Yapılandırma ayarlarını asenkron olarak yüklemeyi simüle eden bir ConfigLoader sınıfı oluşturun. Sınıfınız şunlara sahip olmalıdır:
- Üç adet final alan: appName (String), version (String) ve maxUsers (int)
- Her üç alanı da başlatan özel (private) bir yapıcı
- String configId parametresi alan ve Future<ConfigLoader> döndüren load adında statik bir asenkron fabrika metodu. Bu metod şunları yapmalıdır:
  - Yükleme süresini simüle etmek için 100 milisaniyelik Future.delayed() kullanın
  - configId değerine göre yapılandırma değerlerini oluşturun:
    - appName: configId'nin sonuna " App" eklenmiş hali
    - version: "1.0." ve ardından configId'nin uzunluğu
    - maxUsers: configId'nin uzunluğunun 10 ile çarpımı
  - Bu değerlerle yeni bir ConfigLoader örneği döndürün
- Yapılandırmayı şu formatta yazdıran bir displayInfo() metodu: Config: [appName] v[version] (max [maxUsers] users)
main.dart: Yapılandırma yükleyicinizi içe aktarın ve asenkron başlatma desenini gösterin:
- Loading configurations... yazdırın
- "Production" configId'si ile bir yapılandırma yükleyin ve displayInfo() metodunu çağırın
- "Dev" configId'si ile bir yapılandırma yükleyin ve displayInfo() metodunu çağırın
- All configs loaded! yazdırın

Statik load metodunun tüm asenkron işleri nasıl hallettiğine, özel yapıcının ise sadece değerleri atadığına dikkat edin. Çağıranlar, tam olarak başlatılmış bir nesne elde etmek için await kullanır!

Beklenen çıktı:

Loading configurations...
Config: Production App v1.0.10 (max 100 users)
Config: Dev App v1.0.3 (max 30 users)
All configs loaded!

Kopya kağıdı

Dart'taki yapıcılar (constructors), bir Future değil, sınıfın bir örneğini hemen döndürmeleri gerektiği için async olarak işaretlenemezler.

Asenkron başlatma gerektiren nesneler oluşturmak için bir statik asenkron fabrika yöntemi (static async factory method) kullanın:

class UserProfile {
  final String name;
  final int age;
  
  UserProfile._(this.name, this.age);  // Özel yapıcı (Private constructor)
  
  static Future<UserProfile> create(String userId) async {
    // Burada asenkron işlemleri gerçekleştirin
    await Future.delayed(Duration(seconds: 1));
    return UserProfile._('Alice', 25);
  }
}

Kullanım:

Future<void> main() async {
  var user = await UserProfile.create('123');
  print(user.name);  // Alice
}

Özel yapıcı (_ ile işaretlenmiş), nesne oluşturma işlemini yönetirken, statik yöntem asenkron işleri halleder. Bu, nesnelerin kullanılmadan önce tamamen başlatılmasını sağlar.

Kendin dene

import 'config_loader.dart';

void main() async {
  // TODO: "Loading configurations..." yazdır
  
  // TODO: configId'si "Production" olan bir yapılandırma yükle
  // ve onun displayInfo() metodunu çağır
  
  // TODO: configId'si "Dev" olan bir yapılandırma yükle
  // ve onun displayInfo() metodunu çağır
  
  // TODO: "All configs loaded!" yazdır
}