Difference between revisions of "QueryBuilder"
| Line 41: | Line 41: | ||
<syntaxhighlight lang="php" line='line'> | <syntaxhighlight lang="php" line='line'> | ||
$persoon_objecten = BugQuery::table() | $persoon_objecten = BugQuery::table() | ||
| − | + | ->join('Persoon') | |
| − | + | ->verzamel('Persoon'); | |
</syntaxhighlight> | </syntaxhighlight> | ||
[[Category:WebCie]] | [[Category:WebCie]] | ||
Revision as of 16:05, 28 February 2017
Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.
De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.
Contents
QueryBuilder starten
Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Een voorbeeld:
$query = PersoonQuery::table();
Query uitvoeren
Een query kan je uitvoeren met de methode get. get heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:
$personen = PersoonQuery::table()->get();
first
De methode first voert de query uit zoals get dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:
$personen = PersoonQuery::table()->first();
aggregate (TODO: in de php-code moet deze functie nog worden aangepast)
De methode aggregate voert een aggregator uit op de query. De toegestane aggregators zijn: COUNT, SUM, MAX, MIN en YEAR. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. aggregate haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:
$aantal_personen = PersoonQuery::table()->aggregate('COUNT');
count
Om makkelijker entries te tellen is de speciale methode count. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.
$aantal_personen = PersoonQuery::table()->count();
verzamel
De methode die het vaakst gebruikt wordt is verzamel. Net zoals verzamel van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:
$persoon_objecten = PersoonQuery::table()->verzamel();
Haal alle bugmelders op (dit voorbeeld gebruikt ook join):
$persoon_objecten = BugQuery::table()
->join('Persoon')
->verzamel('Persoon');
