Memilih Pola Akses Data

2.5.x ✅ 4.0.x ✅

Pola mana yang harus saya gunakan? Pohon keputusan ini membantu Anda memilih antara handler langsung, Pola Repositori, Lapisan Layanan, dan CQRS.

---

Pohon Keputusan Cepat

flowchart TD
    START([Start Here]) --> Q1{How complex is<br/>your module?}

    Q1 -->|Simple CRUD<br/>1-3 entities| Q2{Need testing<br/>or mocking?}
    Q1 -->|Moderate<br/>4-10 entities| Q3{Multiple data<br/>sources?}
    Q1 -->|Complex<br/>10+ entities| Q4{High traffic or<br/>read/write asymmetry?}

    Q2 -->|No| HANDLER[✅ Direct Handler]
    Q2 -->|Yes| REPO[✅ Repository Pattern]

    Q3 -->|No, just DB| REPO
    Q3 -->|Yes, APIs/cache| SERVICE[✅ Service Layer]

    Q4 -->|No| SERVICE
    Q4 -->|Yes, need<br/>separate scaling| CQRS[✅ CQRS Pattern]

    HANDLER --> DONE([Choose Pattern])
    REPO --> DONE
    SERVICE --> DONE
    CQRS --> DONE

    style HANDLER fill:#c8e6c9,stroke:#2e7d32
    style REPO fill:#bbdefb,stroke:#1565c0
    style SERVICE fill:#fff9c4,stroke:#f9a825
    style CQRS fill:#ffcdd2,stroke:#c62828

---

Perbandingan Pola

Kriteria	handler Langsung	Repositori	Lapisan Layanan	CQRS
Kompleksitas	⭐	⭐⭐	⭐⭐⭐	⭐⭐⭐⭐⭐
Kemampuan untuk diuji	❌ Keras	✅ Bagus	✅ Hebat	✅ Hebat
Fleksibilitas	❌ Rendah	✅ Sedang	✅ Tinggi	✅ Sangat Tinggi
XOOPS 2.5.x	✅ Asli	✅ Bekerja	✅ Bekerja	⚠️ Kompleks
XOOPS 4.0	⚠️ Tidak berlaku lagi	✅ Direkomendasikan	✅ Direkomendasikan	✅ Untuk skala
Ukuran Tim	1 pengembang	1-3 pengembang	2-5 pengembang	5+ pengembang
Pemeliharaan	❌ Lebih Tinggi	✅ Sedang	✅ Lebih Rendah	⚠️ Memerlukan keahlian

---

Kapan Menggunakan Setiap Pola

✅ Pengendali Langsung (XoopsPersistableObjectHandler)

Terbaik untuk: module sederhana, prototipe cepat, pembelajaran XOOPS

// Simple and direct - good for small modules
$handler = xoops_getModuleHandler('article', 'news');
$articles = $handler->getObjects(new Criteria('status', 1));

Pilih ini ketika:

• Membangun module sederhana dengan 1-3 tabel database
• Membuat prototipe cepat
• Anda satu-satunya pengembang dan tidak memerlukan tes
• module tidak akan berkembang secara signifikan

Keterbatasan:

• Sulit untuk diuji unitnya (ketergantungan global)
• Kopling ketat ke lapisan database XOOPS
• Logika bisnis cenderung bocor ke pengontrol

---

✅ Pola Repositori

Terbaik untuk: Sebagian besar module, tim yang menginginkan kemampuan pengujian

// Abstraction allows mocking for tests
interface ArticleRepositoryInterface {
    public function findPublished(): array;
    public function save(Article $article): void;
}

class XoopsArticleRepository implements ArticleRepositoryInterface {
    private $handler;

    public function __construct() {
        $this->handler = xoops_getModuleHandler('article', 'news');
    }

    public function findPublished(): array {
        return $this->handler->getObjects(new Criteria('status', 1));
    }
}

Pilih ini ketika:

• Anda ingin menulis unit test
• Anda mungkin mengubah sumber data nanti (DB → API)
• Bekerja dengan 2+ pengembang
• Membangun module untuk distribusi

Jalur peningkatan: Ini adalah pola yang direkomendasikan untuk persiapan XOOPS 4.0.

---

✅ Lapisan Layanan

Terbaik untuk: module dengan logika bisnis yang kompleks

// Service coordinates multiple repositories and contains business rules
class ArticlePublicationService {
    public function __construct(
        private ArticleRepositoryInterface $articles,
        private NotificationServiceInterface $notifications,
        private CacheInterface $cache
    ) {}

    public function publish(int $articleId): void {
        $article = $this->articles->find($articleId);
        $article->setStatus('published');
        $article->setPublishedAt(new DateTime());

        $this->articles->save($article);
        $this->notifications->notifySubscribers($article);
        $this->cache->invalidate("article:{$articleId}");
    }
}

Pilih ini ketika:

• Operasi menjangkau berbagai sumber data
• Aturan bisnis itu rumit
• Anda memerlukan manajemen transaksi
• Beberapa bagian aplikasi melakukan hal yang sama

Jalur peningkatan: Gabungkan dengan Repositori untuk arsitektur yang tangguh.

---

⚠️ CQRS (Pemisahan Tanggung Jawab Permintaan Perintah)

Terbaik untuk: module skala tinggi dengan asimetri read/write

// Commands modify state
class PublishArticleCommand {
    public function __construct(
        public readonly int $articleId,
        public readonly int $publisherId
    ) {}
}

// Queries read state (can use denormalized read models)
class GetPublishedArticlesQuery {
    public function __construct(
        public readonly int $limit = 10
    ) {}
}

Pilih ini ketika:

• Jumlah membaca jauh melebihi jumlah menulis (100:1 atau lebih)
• Anda memerlukan penskalaan yang berbeda untuk membaca vs menulis
• Persyaratan reporting/analytics yang kompleks
• Sumber acara akan menguntungkan domain Anda

Peringatan: CQRS menambah kompleksitas yang signifikan. Kebanyakan module XOOPS tidak memerlukannya.

---

Jalur Peningkatan yang Direkomendasikan

flowchart LR
    H0["Direct Handler<br/>(XOOPS 2.5.x today)"]
    R["Repository Pattern<br/>(Recommended next step)"]
    S["+ Service Layer<br/>(When complexity grows)"]
    C["+ CQRS<br/>(Only if scaling requires)"]

    H0 -->|"Step 1"| R
    R -->|"Step 2"| S
    S -->|"Step 3<br/>(rare)"| C

    style H0 fill:#ffcdd2
    style R fill:#c8e6c9
    style S fill:#bbdefb
    style C fill:#fff9c4

Langkah 1: Bungkus handler dalam Repositori (2-4 jam)

1. Buat antarmuka untuk kebutuhan akses data Anda
2. Implementasikan menggunakan handler yang ada
3. Suntikkan repositori alih-alih memanggil xoops_getModuleHandler() secara langsung

Langkah 2: Tambahkan Lapisan Layanan Bila Diperlukan (1-2 hari)

1. Ketika logika bisnis muncul di pengontrol, ekstrak ke Layanan
2. Layanan menggunakan repositori, bukan handler secara langsung
3. Pengontrol menjadi tipis (rute → layanan → respons)

Langkah 3: Pertimbangkan CQRS Saja Jika (jarang)

1. Anda mendapatkan jutaan bacaan per hari
2. Model baca dan tulis berbeda nyata
3. Anda memerlukan sumber acara untuk jalur audit
4. Anda memiliki tim yang berpengalaman dengan CQRS

---

Kartu Referensi Cepat

Pertanyaan	Jawaban
”Saya hanya perlu data save/load”	handler Langsung
”Saya ingin menulis tes”	Pola Repositori
”Saya memiliki aturan bisnis yang rumit”	Lapisan Layanan
”Saya perlu menskalakan pembacaan secara terpisah”	CQRS
”Saya sedang mempersiapkan XOOPS 4.0”	Repositori + Lapisan Layanan

---

Dokumentasi Terkait

• Panduan Pola Repositori
• Panduan Pola Lapisan Layanan
• Panduan Pola CQRS (lanjutan)
• Kontrak Mode Hibrid

---

#pola #akses data #pohon keputusan #praktik terbaik #xoops