Een gegevenstoegangspatroon kiezen

2.5.x ✅ 4.0.x ✅

Welk patroon moet ik gebruiken? Deze beslissingsboom helpt u bij het kiezen tussen directe handlers, Repository Pattern, Service Layer en CQRS.

---

Snelle beslissingsboom

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

---

Patroonvergelijking

Criteria	Directe afhandeling	Bewaarplaats	Servicelaag	CQRS
Complexiteit	⭐	⭐⭐	⭐⭐⭐	⭐⭐⭐⭐⭐
Testbaarheid	❌ Moeilijk	✅ Goed	✅ Geweldig	✅ Geweldig
Flexibiliteit	❌ Laag	✅ Middel	✅ Hoog	✅ Zeer hoog
XOOPS 2.5.x	✅ Native	✅ Werkt	✅ Werkt	⚠️Complex
XOOPS 4.0	⚠️Verouderd	✅ Aanbevolen	✅ Aanbevolen	✅ Voor schaal
Teamgrootte	1 ontwikkelaar	1-3 ontwikkelaars	2-5 ontwikkelaars	5+ ontwikkelaars
Onderhoud	❌ Hoger	✅ Matig	✅ Lager	⚠️ Vereist expertise

---

Wanneer elk patroon gebruiken?

✅ Directe afhandeling (XoopsPersistableObjectHandler)

Best voor: Eenvoudige modules, snelle prototypes, leren XOOPS

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

Kies dit wanneer:

• Het bouwen van een eenvoudige module met 1-3 databasetabellen
• Snel een prototype maken
• Je bent de enige ontwikkelaar en hebt geen tests nodig
• De module zal niet significant groeien

Beperkingen:

• Moeilijk te testen (mondiale afhankelijkheid)
• Nauwe koppeling met databaselaag XOOPS
• Bedrijfslogica heeft de neiging om in controllers te lekken

---

✅ Repositorypatroon

Beste voor: De meeste modules, teams die testbaarheid willen

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

Kies dit wanneer:

• Je wilt unit-tests schrijven
• Mogelijk wijzigt u de gegevensbronnen later (DB → API)
• Werken met 2+ ontwikkelaars
• Modules bouwen voor distributie

Upgradepad: Dit is het aanbevolen patroon voor de voorbereiding van XOOPS 4.0.

---

✅ Servicelaag

Beste voor: Modules met complexe bedrijfslogica

// 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}");
    }
}

Kies dit wanneer:

• Operaties omvatten meerdere gegevensbronnen
• Bedrijfsregels zijn complex
• Je hebt transactiebeheer nodig
• Meerdere delen van de app doen hetzelfde

Upgradepad: Combineer met Repository voor een robuuste architectuur.

---

⚠️ CQRS (segregatie van opdrachtqueryverantwoordelijkheden)

Beste voor: Grootschalige modules met lees-/schrijfasymmetrie

// 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
    ) {}
}

Kies dit wanneer:

• Leest veel meer dan schrijft (100:1 of meer)
• U hebt verschillende schaling nodig voor lees- en schrijfbewerkingen
• Complexe rapportage-/analysevereisten
• Eventsourcing zou uw domein ten goede komen

Waarschuwing: CQRS voegt aanzienlijke complexiteit toe. De meeste XOOPS-modules hebben dit niet nodig.

---

Aanbevolen upgradepad

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

Stap 1: Handlers in opslagplaatsen verpakken (2-4 uur)

1. Creëer een interface voor uw behoeften op het gebied van gegevenstoegang
2. Implementeer het met behulp van de bestaande handler
3. Injecteer de repository in plaats van xoops_getModuleHandler() rechtstreeks aan te roepen

Stap 2: Voeg servicelaag toe wanneer nodig (1-2 dagen)

1. Wanneer bedrijfslogica in controllers verschijnt, extraheren naar een service
2. De service maakt gebruik van repository’s en niet rechtstreeks van handlers
3. Controllers worden dun (route → service → respons)

Stap 3: Overweeg alleen CQRS als (zeldzaam)

1. Je leest miljoenen berichten per dag
2. Lees- en schrijfmodellen verschillen aanzienlijk
3. Je hebt eventsourcing nodig voor audittrails
4. Je hebt een team dat ervaring heeft met CQRS

---

Snelle referentiekaart

Vraag	Antwoord
”Ik moet alleen gegevens opslaan/laden”	Directe afhandeling
”Ik wil tests schrijven”	Repositorypatroon
”Ik heb complexe bedrijfsregels”	Servicelaag
”Ik moet leesbewerkingen afzonderlijk schalen”	CQRS
”Ik bereid me voor op XOOPS 4.0”	Repository + servicelaag

---

Gerelateerde documentatie

• Repositorypatroongids
• Servicelaagpatroongids
• CQRS-patroongids (geavanceerd)
• Hybride moduscontract

---

#patterns #data-access #decision-tree #best-practices #xoops