Tabellenklassen

Die Tabellenklassen sollen den Zugriff auf die jeweilige Tabelle erleichtern und außerdem tabellenspezifische Methoden zur Verfügung stellen. Mit Hilfe der Tabellenklassen sollte es daher nicht mehr nötig sein, selber INSERT oder UPDATE Befehle erstellen zu müssen. (Ausnahmen sind hier Massenupdates/-inserts) Die Tabellenklasse ist so intelligent, dass sie nur Updates/Insert macht, wenn dies nötig ist. Außerdem werden noch allgemeine Wertprüfungen gemacht, welche in jeder Klasse noch verfeinert bzw. erweitert werden können um so auch inhaltliche Prüfungen zu ermöglichen.

Seit der Version 2.0 sind die vorhandenen Tabellenklassen überarbeitet und einige Neue hinzugefügt. Sinn der Überarbeitung war die wiederholenden Methoden, welche in jeder Klasse vorkamen in eine übergeordnete Klasse TableAccess auszugliedern und in den jeweiligen Tabellenklassen dann nur noch die spezifischen Dinge zu implementieren.

Mit Version 2.2 muss die Klasse TableAccess nicht mehr für jede Datenbanktabelle abgeleitet werden. Über den neu hinzugefügten Konstruktor in TableAccess kann nun bei entsprechender Übergabe des Tabellennamens und des Spaltenpräfix ein Objekt einer beliebigen Tabelle erzeugt werden. Sofern man keine speziellen Anforderungen beim Befüllen, Auslesen, Speichern oder Löschen braucht reicht dies vollkommen aus und man kann mit den unten beschriebenen Funktionen in der Tabelle arbeiten.
Sollen allerdings abhängige Daten mit gelöscht oder beim Speichern bestimmte Spalten automatisch mit einem aktuellen Zeitstempel befüllt werden, so muss die Klasse abgeleitet und die einzelnen Funktionen ggf. überschrieben werden. Im Konstruktor der abgeleiteten Klasse muss dann der Konstruktor von TableAccess mit den entsprechenden Übergaben aufgerufen werden. Danach kann jede beliebige Methode überschrieben werden.

public function __construct(&$db, $ann_id = 0)
{
    parent::__construct($db, TBL_ANNOUNCEMENTS, 'ann', $ann_id);
}

Mit diesen Informationen funktionieren dann auch schon alle Methoden der TableAccess-Klasse:

• readData liest den entsprechenden Datensatz aus der Datenbank aus. Mit speziellen Übergaben kann hier das SQL-Statement noch verändert werden (Bsp: roles_class.php)
• clear initialisiert alle eingelesenen Daten. Die Methode kann in der spezifischen Klasse abgeleitet werden um dort dann noch weitere Daten zu initialisieren (Bsp: organization_class.php)
• setArray hat man selber die Daten vorher in ein Array eingelesen, kann man dieses Array an die Klasse übergeben und diese arbeitet dann mit den Daten weiter. Macht Sinn, wenn man Daten im Script über eine Schleife einliest, aber auf Methoden der Klasse zugreifen will
• setValue will man einen Wert verändern, sollte dies über diese Methode laufen. Die Methode kann in der spezifischen Klasse abgeleitet werden um dort spezielle Prüfungen z.B. is_numeric auf übergebene Daten anzuwenden (Bsp: roles_class.php)
• getValue gibt einen Wert zurück. Die Methode kann in der spezifischen Klasse abgeleitet werden um dort ggf. noch andere Daten zu setzen (Bsp: users_class.php)
• save die Methode prüft, ob Daten verändert wurden und diese in die Datenbank zurückgeschrieben werden müssen. Die Methode kann in der spezifischen Klasse abgeleitet werden, falls vor einem Update/Insert noch Daten vorbelegt werden sollen/können. Macht z.B. Sinn, wenn der User mit Uhrzeit gespeichert wird, der die letzte Änderung gemacht hat. (Bsp: dates_class.php)
• delete löscht den aktuellen Satz aus der Datenbank. Die Methode kann in der spezifischen Klasse abgeleitet werden, falls vorher noch andere Daten (Referenzen) gelöscht oder verändert werden müssen (Bsp: roles_class.php)

Intern werden alle aus der Tabelle ausgelesenen Daten in einem Array $db_fields gespeichert. Wer also an bestimmten Stellen schnellern Zugriff auf alle Daten braucht, kann auch direkt auf das Array zugreifen.