Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
de:entwickler:tabellenzugriffsklassen [2010/03/07 12:43] – fassede:entwickler:tabellenzugriffsklassen [2012/05/12 00:43] (current) – [Wie lege ich einen neuen Datensatz an ?] thomas-rcv
Line 3: Line 3:
 Für den Zugriff auf einzelne Datensätze aus Datenbanktabellen stellt Admidio die **TableAccess**-Zugriffsklasse zur Verfügung. Damit wird der Zugriff und die Pflege einzelner Datensätze erheblich vereinfacht. Diese Dokumentation beschreibt Funktionen ab Version 2.2 . Für den Zugriff auf einzelne Datensätze aus Datenbanktabellen stellt Admidio die **TableAccess**-Zugriffsklasse zur Verfügung. Damit wird der Zugriff und die Pflege einzelner Datensätze erheblich vereinfacht. Diese Dokumentation beschreibt Funktionen ab Version 2.2 .
  
-Die Klasse kann auf jede Datenbanktabelle angewandt werden. Willst du z.B. mit einem Datensatz der Tabelle **MeineTabelle** arbeiten:<code sql>create table adm_MeineTabelle+Die Klasse kann auf jede Datenbanktabelle angewandt werden. Willst du zum Beispiel mit einem Datensatz der folgenden Tabelle **MeineTabelle** arbeiten:<code sql>create table adm_MeineTabelle
 ( (
    meine_id            int(11) unsigned not null AUTO_INCREMENT,    meine_id            int(11) unsigned not null AUTO_INCREMENT,
Line 9: Line 9:
    meine_geburtstag    datetime,    meine_geburtstag    datetime,
    meine_adresse       varchar(255)     not null    meine_adresse       varchar(255)     not null
-)</code>, so wird das Objekt wie folgt erstellt: <code php>$meinTabellenObjekt = new TableAccess($g_db, 'MeineTabelle', 'meine', 5);</code> **$g_db** ist dabei das [[de:entwickler:datenbankzugriffsklasse|Admidio-Objekt für den Zugriff auf die Datenbank]]\\ +)</code>, so wird das Objekt wie folgt erstellt: <code php>$meinTabellenObjekt = new TableAccess($gDb, 'MeineTabelle', 'meine', 5);</code> **$gDb** ist dabei das [[de:entwickler:datenbankzugriffsklasse|Admidio-Objekt für den Zugriff auf die Datenbank]]\\ 
 **MeineTabelle** ist der Tabellenname der Tabelle auf die Zugegriffen werden soll\\  **MeineTabelle** ist der Tabellenname der Tabelle auf die Zugegriffen werden soll\\ 
 **meine** ist das Spaltenpräfix der Tabelle\\  **meine** ist das Spaltenpräfix der Tabelle\\ 
Line 23: Line 23:
 echo $geburtstag // 1983/02/20</code> echo $geburtstag // 1983/02/20</code>
 Daten ändern und speichern geht dann so:<code php>$meinTabellenObjekt->setValue('meine_name', 'Mustermann'); Daten ändern und speichern geht dann so:<code php>$meinTabellenObjekt->setValue('meine_name', 'Mustermann');
-$meinTabellenObjekt->setValue('meine_adresse', 'Musterstraße');+$meinTabellenObjekt->setValue('meine_adresse', 'Musterstraße 129');
 $meinTabellenObjekt->save();</code> $meinTabellenObjekt->save();</code>
 Auch beim Speichern gibt es für Datum- und Zeitfelder eine Besonderheit. Hier **muss** das Datum nach [[http://de.wikipedia.org/wiki/ISO_8601|ISO 8601]] **Y-m-d** //1983-02-20// übergeben werden. Auch beim Speichern gibt es für Datum- und Zeitfelder eine Besonderheit. Hier **muss** das Datum nach [[http://de.wikipedia.org/wiki/ISO_8601|ISO 8601]] **Y-m-d** //1983-02-20// übergeben werden.
  
-==== Warum sind Tabellenklassen notwendig ? ====+==== Wie lege ich einen neuen Datensatz an ? ==== 
 +Einen neuen Datensatz anlegen funktioniert eigentlich genauso, wie einen Datensatz zu verändern. Es darf vorher nur nicht mit einer ID ein Datensatz eingelesen werden. <code php>$meinTabellenObjekt = new TableAccess($gDb, 'MeineTabelle', 'meine'); 
 +$meinTabellenObjekt->setValue('meine_name', 'Musterfrau'); 
 +$meinTabellenObjekt->setValue('meine_adresse', 'Musterweg 43'); 
 +$meinTabellenObjekt->save();</code>Schon ist ein neuer Datensatz angelegt worden. Falls man schon ein Objekt der Tabelle besitzt und kein neues Anlegen möchte/muss, so kann man auch einfach die Methode **clear** auf das vorhandene Objekt anwenden und danach die Daten belegen:<code php>$meinTabellenObjekt->clear(); 
 +$meinTabellenObjekt->setValue('meine_name', 'Musterfrau'); 
 +$meinTabellenObjekt->setValue('meine_adresse', 'Musterweg 43'); 
 +$meinTabellenObjekt->save();</code> 
 + 
 +==== Wie kann ich Änderungszeitstempel und Benutzer bequem speichern ? ==== 
 +Die **TableAccess**-Klasse kann den Zeitstempel und die Benutzer-ID desjenigen speichern, der den Datensatz angelegt, sowie desjenigen, der ihn als letztes geändert hat. Dazu müssen die entsprechenden Spalten in der Tabelle nur einem bestimmten Namenschema folgen. Die Aktualisierung der Felder wird dann komplett von der Klasse erledigt, sobald die Methode **save()** aufgerufen wird.  
 +Die Felder müssen wie folgt definiert sein:<code sql>meine_usr_id_create       int(11) unsigned, 
 +meine_timestamp_create    datetime, 
 +meine_usr_id_change       int(11) unsigned, 
 +meine_timestamp_change    datetime</code>Der Spaltenname fängt mit dem Tabellenpräfix an und besitzt dann einen der folgenden Namen **usr_id_create**, **timestamp_create**, **timestamp_change** und **timestamp_change**. 
 + 
 +Möchte man die Aktualisierung der Felder an einer bestimmten Stelle nicht vornehmen lassen, so kann man dies durch folgenden Aufruf erreichen: <code php>$meinTabellenObjekt->save(false);</code>
  
 +==== Welche Methoden stehen zur Verfügung ? ====
 Folgende Methoden stehen durch die TableAccess-Klasse zur Verfügung und können von abgeleiteten Klassen erweitert werden: Folgende Methoden stehen durch die TableAccess-Klasse zur Verfügung und können von abgeleiteten Klassen erweitert werden:
   * **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)   * **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)
  • de/entwickler/tabellenzugriffsklassen.1267962223.txt.gz
  • Last modified: 2010/03/07 12:43
  • by fasse