Kompozit Kalıbı

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

Composite Deseni, nesneleri ağaç yapıları şeklinde düzenlemenize ve ardından bu yapılarla sanki tekil nesnelermiş gibi çalışmanıza olanak tanıyan yapısal bir tasarım desenidir. Tekil nesneleri ve nesne gruplarını tek tip bir şekilde ele almak istediğiniz parça-bütün hiyerarşilerini temsil etmek için mükemmeldir.

Bir dosya sistemini düşünün. Bir klasör, dosyalar ve diğer klasörleri içerebilir.

Toplam boyutu hesaplarken, hem dosyalar hem de klasörler üzerinde aynı metodu çağırmak istersiniz ve klasörler kendi içeriklerini özyinelemeli olarak toplamalıdır. Composite Deseni, hem yapraklara (dosyalar) hem de bileşiklere (klasörler) aynı arayüzü vererek bunu sorunsuz hale getirir.

<?php
interface FileSystemItem {
    public function getName(): string;
    public function getSize(): int;
}

class File implements FileSystemItem {
    public function __construct(
        private string $name,
        private int $size
    ) {}
    
    public function getName(): string {
        return $this->name;
    }
    
    public function getSize(): int {
        return $this->size;
    }
}

class Folder implements FileSystemItem {
    private array $items = [];
    
    public function __construct(private string $name) {}
    
    public function getName(): string {
        return $this->name;
    }
    
    public function add(FileSystemItem $item): void {
        $this->items[] = $item;
    }
    
    public function getSize(): int {
        $total = 0;
        foreach ($this->items as $item) {
            $total += $item->getSize();
        }
        return $total;
    }
}

Artık ağaç yapıları oluşturabilir ve onlara tek tip bir şekilde davranabilirsiniz:

<?php
$docs = new Folder("Documents");
$docs->add(new File("resume.pdf", 250));
$docs->add(new File("cover.docx", 50));

$images = new Folder("Images");
$images->add(new File("photo.jpg", 1500));

$root = new Folder("Root");
$root->add($docs);
$root->add($images);
$root->add(new File("readme.txt", 10));

echo $root->getSize();

Çıktı:

İstemci kodu, tek bir dosyayla mı yoksa derinlemesine iç içe geçmiş bir klasör yapısıyla mı uğraştığını önemsemeden getSize() metodunu çağırır. Desen, özyinelemeyi dahili olarak yöneterek karmaşık hiyerarşilerle çalışmayı kolaylaştırır.

Görev

Kolay

Composite Pattern kullanarak bir organizasyon şeması sistemi oluşturalım. Şirketler, departmanların çalışanları ve diğer alt departmanları içerebildiği hiyerarşik bir yapıya sahiptir — bu, tüm organizasyon genelinde toplamları tek tip bir şekilde hesaplamak istediğiniz mükemmel bir ağaç yapısıdır.

Kodunuzu dört dosya halinde düzenleyeceksiniz:

OrganizationUnit.php — Hem bireysel çalışanların hem de departmanların uygulayacağı bir OrganizationUnit arayüzü tanımlayın. İki yöntemi olmalıdır: getName(): string ve getSalary(): int. Bu ortak arayüz, maliyetleri hesaplarken tek bir çalışana ve tüm departmanlara aynı şekilde davranmanıza olanak tanır.
Employee.php — OrganizationUnit arayüzünü dahil edin ve onu uygulayan bir Employee sınıfı oluşturun. Bir çalışan, organizasyon ağacınızdaki bir yaprak düğümdür (leaf node) — bir isimleri ve maaşları vardır ancak başka birimleri içeremezler. İsim ve maaşı kabul etmek için constructor promotion kullanın ve her iki arayüz yöntemini de uygulayın.
Department.php — OrganizationUnit arayüzünü dahil edin ve onu uygulayan bir Department sınıfı oluşturun. Bir departman, hem çalışanları hem de diğer departmanları içerebilen bir bileşiktir (composite). Departmanınız şunları yapmalıdır:
- Yapıcısında (constructor) bir isim kabul etmeli
- Çalışanları veya alt departmanları eklemek için bir add(OrganizationUnit $unit): void yöntemine sahip olmalı
- İçerdiği tüm birimlerin toplam maaşını döndürmek için (içindeki her şeyi özyinelemeli olarak toplayarak) getSalary() yöntemini uygulamalı
main.php — Employee ve Department dosyalarını dahil edin. Bir girdi alacaksınız: organizasyon yapısını temsil eden bir JSON dizesi.
JSON şu formatta olacaktır:
```
{"Engineering": [{"name": "Alice", "salary": 80000}, {"name": "Bob", "salary": 75000}], "Sales": [{"name": "Carol", "salary": 65000}]}
```
Her anahtar bir departman adıdır ve değeri, isimleri ve maaşları olan bir çalışan dizisidir.

"Company" adında bir kök Department oluşturun. JSON'daki her departman için bir Department oluşturun, çalışanlarını ekleyin ve ardından bu departmanı Company'ye ekleyin. Son olarak, toplam şirket maaşını şu formatta yazdırın:

Total Salary: [amount]

Composite Pattern'in güzelliği, Company departmanı üzerinde getSalary() çağrısı yapmanın, tüm iç içe geçmiş departmanlar ve çalışanlar genelindeki toplamı otomatik olarak hesaplamasıdır — istemci kodunun dahili yapıyı bilmesine gerek yoktur.

Kopya kağıdı

Composite Deseni (Composite Pattern), nesneleri ağaç yapıları şeklinde düzenleyen ve hem tekil nesnelerin hem de nesne gruplarının tek tip (uniform) olarak ele alınmasına olanak tanıyan yapısal bir tasarım desenidir.

Yaprak düğümler (leaf nodes) ve bileşik düğümler (composite nodes) için aynı arayüzü kullanmak istediğiniz parça-bütün hiyerarşileri için idealdir.

Temel Bileşenler

Bileşen Arayüzü (Component Interface) — Hem yapraklar hem de bileşikler için ortak işlemleri tanımlar
Yaprak (Leaf) — Başka nesneleri içeremeyen tekil nesneleri temsil eder
Bileşik (Composite) — Alt öğeleri (yapraklar veya diğer bileşikler) içerir ve işlemleri alt öğelere devrederek (delegating) gerçekleştirir

Örnek: Dosya Sistemi

<?php
interface FileSystemItem {
    public function getName(): string;
    public function getSize(): int;
}

class File implements FileSystemItem {
    public function __construct(
        private string $name,
        private int $size
    ) {}
    
    public function getName(): string {
        return $this->name;
    }
    
    public function getSize(): int {
        return $this->size;
    }
}

class Folder implements FileSystemItem {
    private array $items = [];
    
    public function __construct(private string $name) {}
    
    public function getName(): string {
        return $this->name;
    }
    
    public function add(FileSystemItem $item): void {
        $this->items[] = $item;
    }
    
    public function getSize(): int {
        $total = 0;
        foreach ($this->items as $item) {
            $total += $item->getSize();
        }
        return $total;
    }
}

Kullanım

<?php
$docs = new Folder("Documents");
$docs->add(new File("resume.pdf", 250));
$docs->add(new File("cover.docx", 50));

$images = new Folder("Images");
$images->add(new File("photo.jpg", 1500));

$root = new Folder("Root");
$root->add($docs);
$root->add($images);
$root->add(new File("readme.txt", 10));

echo $root->getSize(); // 1810

İstemci (client), hem dosyalar hem de klasörler üzerinde getSize() metodunu tek tip olarak çağırır. Bileşik yapı, özyinelemeyi (recursion) dahili olarak yöneterek karmaşık hiyerarşilerle çalışmayı basitleştirir.

Kendin dene

<?php
require_once 'Employee.php';
require_once 'Department.php';

// JSON girişini oku
$input = trim(fgets(STDIN));
$data = (array)json_decode($input, true);

// YAPILACAK: "Company" adında bir kök Departman (Department) oluşturun

// YAPILACAK: JSON verisindeki her bir departman üzerinde döngü kurun
// Her bir departman için:
//   - Yeni bir Departman (Department) nesnesi oluşturun
//   - Her bir çalışanı (employee) o departmana ekleyin
//   - Departmanı Şirkete (Company) ekleyin

// YAPILACAK: Toplam maaşı şu formatta yazdırın: Total Salary: [amount]

?>