Kompozit Kalıbı

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

Composite deseni, tekil nesneleri ve nesne gruplarını tek tipte ele almanızı sağlar. Nesneleri, hem tekil öğelerin hem de öğe koleksiyonlarının aynı arayüzü paylaştığı ağaç yapılarında birleştirir. Bu; dosya sistemleri, organizasyon şemaları veya kullanıcı arayüzü (UI) bileşenleri gibi hiyerarşileri temsil etmek için mükemmeldir.

Desen iki tür katılımcıya sahiptir: Leaf düğümleri (alt öğesi olmayan bireysel nesneler) ve Composite düğümleri (diğer bileşenleri tutan kapsayıcılar). Her ikisi de ortak bir Component arayüzünü uygular:

abstract class FileSystemItem {
  String get name;
  int getSize();
  void display([String indent = '']);
}

class File implements FileSystemItem {
  @override
  final String name;
  final int size;

  File(this.name, this.size);

  @override
  int getSize() => size;

  @override
  void display([String indent = '']) {
    print('$indent- $name ($size KB)');
  }
}

class Folder implements FileSystemItem {
  @override
  final String name;
  final List<FileSystemItem> _children = [];

  Folder(this.name);

  void add(FileSystemItem item) => _children.add(item);

  @override
  int getSize() => _children.fold(0, (sum, item) => sum + item.getSize());

  @override
  void display([String indent = '']) {
    print('$indent+ $name/');
    for (var child in _children) {
      child.display('$indent  ');
    }
  }
}

void main() {
  var docs = Folder('Documents');
  docs.add(File('resume.pdf', 150));
  docs.add(File('photo.jpg', 2400));

  var projects = Folder('Projects');
  projects.add(File('main.dart', 25));
  docs.add(projects);

  docs.display();
  print('Total: ${docs.getSize()} KB');
}

Folder sınıfı hem File nesnelerini hem de diğer Folder nesnelerini içerebilir. Bir klasör üzerinde getSize() metodunu çağırdığınızda, tüm içeriğinin toplam boyutunu özyinelemeli (recursively) olarak hesaplar. İstemci kodunun tek bir dosyayla mı yoksa tüm bir klasör hiyerarşisiyle mi çalıştığını bilmesine gerek yoktur; her ikisi de aynı metotlara yanıt verir.

Görev

Kolay

Composite desenini kullanarak bir organizasyon şeması sistemi oluşturalım! Hem bireysel çalışanların hem de departmanların (çalışanları ve diğer departmanları içeren) tek tip olarak ele alınabildiği bir yapı oluşturacaksınız - bu, şirket hiyerarşilerini temsil etmek için mükemmeldir.

Kodunuzu iki dosya halinde düzenleyeceksiniz:

organization.dart: Bu dosya, bileşen arayüzünüzü (interface) ve hem yaprak (leaf) hem de bileşik (composite) sınıflarınızı içerir. Bir name getter'ı, int döndüren bir getSalaryBudget() metodu ve hiyerarşiyi göstermek için bir display([String indent = '']) metodu olan OrganizationUnit adında soyut bir sınıf oluşturun. OrganizationUnit arayüzünü uygulayan bir Employee sınıfı (yaprak) oluşturun. Bir isme ve maaşa sahip olmalı, getSalaryBudget() metodu çalışanın maaşını döndürmelidir. display() metodu [indent]- [name] ($[salary]) formatında çıktı vermelidir. Ardından, yine OrganizationUnit arayüzünü uygulayan bir Department sınıfı (bileşik) oluşturun. Bir isme sahip olmalı ve OrganizationUnit türünde çocukların bir listesini tutmalıdır. Çalışanları veya alt departmanları dahil etmek için bir add() metodu ekleyin. getSalaryBudget() metodu, tüm çocukların bütçelerini özyinelemeli (recursive) olarak toplamalıdır. display() metodu [indent]+ [name]/ yazdırdıktan sonra her bir çocuğu artırılmış girintiyle (iki boşluk ekleyerek) görüntülemelidir.
main.dart: Organizasyon dosyanızı içe aktarın ve bir şirket yapısı oluşturun. İki çalışan içeren bir Engineering departmanı oluşturun: 80000 maaşlı Alice ve 75000 maaşlı Bob. Bir çalışanı olan bir QA departmanı oluşturun: 65000 maaşlı Carol. Şimdi bir Technology departmanı oluşturun ve hem Engineering hem de QA departmanlarını alt departman olarak ekleyin. Technology departmanı üzerinde display() metodunu çağırın, ardından Total Budget: $ ve sonrasında toplam maaş bütçesini yazdırın.

Composite deseninin güzelliği, Technology.getSalaryBudget() metodunun tüm iç içe geçmiş departmanlar ve çalışanlar genelindeki toplamı otomatik olarak hesaplamasıdır - istemci kodunun iç yapıyı bilmesine gerek yoktur!

Beklenen çıktı:

+ Technology/
  + Engineering/
    - Alice ($80000)
    - Bob ($75000)
  + QA/
    - Carol ($65000)
Total Budget: $220000

Kopya kağıdı

Composite deseni, tekil nesneleri ve nesne gruplarını, hem tek öğelerin hem de koleksiyonların aynı arayüzü paylaştığı ağaç yapıları şeklinde düzenleyerek onlara tek tip bir şekilde davranmanıza olanak tanır.

Desen şunlardan oluşur:

Component (Bileşen): Ortak işlemleri tanımlayan soyut bir arayüz
Leaf (Yaprak): Alt öğesi olmayan tekil nesneler
Composite (Bileşik): Diğer bileşenleri (yaprakları veya bileşikleri) tutan kapsayıcılar

Örnek: Dosya Sistemi

abstract class FileSystemItem {
  String get name;
  int getSize();
  void display([String indent = '']);
}

class File implements FileSystemItem {
  @override
  final String name;
  final int size;

  File(this.name, this.size);

  @override
  int getSize() => size;

  @override
  void display([String indent = '']) {
    print('$indent- $name ($size KB)');
  }
}

class Folder implements FileSystemItem {
  @override
  final String name;
  final List<FileSystemItem> _children = [];

  Folder(this.name);

  void add(FileSystemItem item) => _children.add(item);

  @override
  int getSize() => _children.fold(0, (sum, item) => sum + item.getSize());

  @override
  void display([String indent = '']) {
    print('$indent+ $name/');
    for (var child in _children) {
      child.display('$indent  ');
    }
  }
}

void main() {
  var docs = Folder('Documents');
  docs.add(File('resume.pdf', 150));
  docs.add(File('photo.jpg', 2400));

  var projects = Folder('Projects');
  projects.add(File('main.dart', 25));
  docs.add(projects);

  docs.display();
  print('Total: ${docs.getSize()} KB');
}

Folder sınıfı hem File nesnelerini hem de diğer Folder nesnelerini içerebilir. Bir klasör üzerinde getSize() metodunu çağırdığınızda, tüm içeriğinin toplam boyutunu özyinelemeli (recursive) olarak hesaplar. İstemci kodu, tekil dosyaları ve tüm klasör hiyerarşilerini tek tip bir şekilde ele alır.

Kendin dene

import 'organization.dart';

void main() {
  // YAPILACAK: Bir Mühendislik departmanı oluşturun
  // YAPILACAK: 80000 maaş ile Alice'i ekleyin
  // YAPILACAK: 75000 maaş ile Bob'u ekleyin
  
  // YAPILACAK: Bir QA departmanı oluşturun
  // YAPILACAK: 65000 maaş ile Carol'ı ekleyin
  
  // YAPILACAK: Bir Teknoloji departmanı oluşturun
  // YAPILACAK: Mühendislik ve QA departmanlarını alt departman olarak ekleyin
  
  // YAPILACAK: Teknoloji departmanı üzerinde display() metodunu çağırın
  
  // YAPILACAK: "Total Budget: $" ve ardından toplam maaş bütçesini yazdırın
}