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 hesapladığınızda, hem dosyalar hem de klasörler üzerinde aynı yöntemi çağırmak istersiniz ve klasörler 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 tekil çalışanlara 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
- Departman adını döndürmek için getName() yöntemini uygulamalı
- Ç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.

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);

// TODO: "Company" adında bir kök Department oluştur

// TODO: JSON verisindeki her bir departman üzerinde döngü kur
// Her bir departman için:
//   - Yeni bir Department nesnesi oluştur
//   - Her bir çalışanı o departmana ekle
//   - Departmanı Company'ye ekle

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

?>