Zend_Db_Table_Row.xml 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- EN-Revision: 15215 -->
  3. <!-- Reviewed: no -->
  4. <sect1 id="zend.db.table.row">
  5. <title>Zend_Db_Table_Row</title>
  6. <sect2 id="zend.db.table.row.introduction">
  7. <title>Einführung</title>
  8. <para>
  9. <classname>Zend_Db_Table_Row</classname> ist eine Klasse, die eine einzelne Zeile eines <classname>Zend_Db_Table</classname>-Objekts
  10. enthält. Wenn eine Abfrage über eine Table-Klasse gestartet wird, wird das Ergebnis als
  11. ein Satz von <classname>Zend_Db_Table_Row</classname>-Objekten zurückgegeben. Dieses Objekt kann auch benutzt
  12. werden, um neue Zeilen zu erstellen und sie in die Datenbank einzutragen.
  13. </para>
  14. <para>
  15. <classname>Zend_Db_Table_Row</classname> ist eine Implementierung des
  16. <ulink url="http://www.martinfowler.com/eaaCatalog/rowDataGateway.html">Row Data Gateway</ulink>
  17. -Entwurfsmusters.
  18. </para>
  19. </sect2>
  20. <sect2 id="zend.db.table.row.read">
  21. <title>Eine Zeile lesen</title>
  22. <para>
  23. <classname>Zend_Db_Table_Abstract</classname> enthält die Methoden <code>find()</code> und
  24. <code>fetchAll()</code>, die beide ein <classname>Zend_Db_Table_Rowset</classname> Objekt zurückgeben, und die
  25. Methode <code>fetchRow()</code>, die ein Objekt vom Typ <classname>Zend_Db_Table_Row</classname> zurückgibt.
  26. </para>
  27. <example id="zend.db.table.row.read.example">
  28. <title>Beispiel des Lesen einer Zeile</title>
  29. <programlisting role="php"><![CDATA[
  30. $bugs = new Bugs();
  31. $row = $bugs->fetchRow($bugs->select()->where('bug_id = ?', 1));
  32. ]]></programlisting>
  33. </example>
  34. <para>
  35. Ein <classname>Zend_Db_Table_Rowset</classname> Objekt enthält einen Satz von <classname>Zend_Db_Table_Row</classname> Objekten.
  36. Siehe <xref linkend="zend.db.table.rowset" />.
  37. </para>
  38. <example id="zend.db.table.row.read.example-rowset">
  39. <title>Beispiel des Lesens einer Zeile aus einem Rowset</title>
  40. <programlisting role="php"><![CDATA[
  41. $bugs = new Bugs();
  42. $rowset = $bugs->fetchAll($bugs->select()->where('bug_status = ?', 1));
  43. $row = $rowset->current();
  44. ]]></programlisting>
  45. </example>
  46. <sect3 id="zend.db.table.row.read.get">
  47. <title>Spaltenwerte aus einer Zeile lesen</title>
  48. <para>
  49. <classname>Zend_Db_Table_Row_Abstract</classname> bietet Zugriffsmethoden an, damit die Spalten einer
  50. Zeile als Objekteigenschaften angesprochen werden können.
  51. </para>
  52. <example id="zend.db.table.row.read.get.example">
  53. <title>Beispiel für das Lesens einer Spalte aus einer Zeile</title>
  54. <programlisting role="php"><![CDATA[
  55. $bugs = new Bugs();
  56. $row = $bugs->fetchRow($bugs->select()->where('bug_id = ?', 1));
  57. // Wert der Spalte bug_description ausgeben
  58. echo $row->bug_description;
  59. ]]></programlisting>
  60. </example>
  61. <note>
  62. <para>
  63. Frühere Versionen von <classname>Zend_Db_Table_Row</classname> haben diese Spalten-Zugriffsnamen
  64. mithilfe einer Zeichenketten-Transformation namens
  65. <emphasis>Inflection</emphasis> auf Spaltennamen umgeleitet.
  66. </para>
  67. <para>
  68. Die Aktuelle Version von <classname>Zend_Db_Table_Row</classname> implementiert diese Funktion jedoch
  69. nicht mehr. Der Spalten-Zugriffsname muss genau so geschrieben sein, wie die
  70. Spalte in der Datenbank heißt.
  71. </para>
  72. </note>
  73. </sect3>
  74. <sect3 id="zend.db.table.row.read.to-array">
  75. <title>Zeilendaten als ein Array lesen</title>
  76. <para>
  77. Die Tabellenzeile kann mithilfe der <code>toArray()</code> Methode des
  78. Zeilenobjekts auch als Array gelesen werden. Diese gibt ein assoziatives Array
  79. zurück, mit Spaltennamen als Index und ihren Inhalten als Werten.
  80. </para>
  81. <example id="zend.db.table.row.read.to-array.example">
  82. <title>Beispiel der Benutzung der toArray()-Methode</title>
  83. <programlisting role="php"><![CDATA[
  84. $bugs = new Bugs();
  85. $row = $bugs->fetchRow($bugs->select()->where('bug_id = ?', 1));
  86. // Das assoziative Array aus dem Zeilenobjekt holen
  87. $rowArray = $row->toArray();
  88. // Jetzt einfach wie ein normales Array verwenden
  89. foreach ($rowArray as $column => $value) {
  90. echo "Spalte: $column\n";
  91. echo "Wert: $value\n";
  92. }
  93. ]]></programlisting>
  94. </example>
  95. <para>
  96. Das Array, das von <code>toArray()</code>zurückgegeben wird, ist nicht update
  97. fähig. Die Werte des Arrays können wie in jedem Array modifiziert werden, aber
  98. Änderungen an diesem Array werden nicht direkt in der Datenbank gespeichert.
  99. </para>
  100. </sect3>
  101. <sect3 id="zend.db.table.row.read.relationships">
  102. <title>Daten aus verwandten Tabellen lesen</title>
  103. <para>
  104. Die Klasse <classname>Zend_Db_Table_Row_Abstract</classname> bietet Methoden, um Zeilen und Zeilensätze
  105. aus verwandten Tabellen auszulesen. Siehe
  106. <xref linkend="zend.db.table.relationships" /> für weitere Informationen über
  107. Tabellenbeziehungen.
  108. </para>
  109. </sect3>
  110. </sect2>
  111. <sect2 id="zend.db.table.row.write">
  112. <title>Zeilen in die Datenbank schreiben</title>
  113. <sect3 id="zend.db.table.row.write.set">
  114. <title>Spaltenwerte einer Zeile verändern</title>
  115. <para>
  116. Individuelle Werte von Spalten können mit Hilfe der Zugriffsvariablen gesetzt
  117. werden, so ähnlich wie Spalten in obiegen Beispiel als Objekteigenschaften gelesen
  118. werden.
  119. </para>
  120. <para>
  121. Das Ändern eines Werts über eine Zugriffsvariable ändert den Spaltenwert des
  122. Zeilenobjekts in der Anwendung, aber noch wird die Änderung nicht in die Datenbank
  123. übernommen. Das wird mit der Methode <code>save()</code> erledigt.
  124. </para>
  125. <example id="zend.db.table.row.write.set.example">
  126. <title>Beispiel der Änderung eines Spaltenwertes einer Zeile</title>
  127. <programlisting role="php"><![CDATA[
  128. $bugs = new Bugs();
  129. $row = $bugs->fetchRow($bugs->select()->where('bug_id = ?', 1));
  130. // Wert einer oder mehrerer Spalten ändern
  131. $row->bug_status = 'FIXED';
  132. // Die Datenbankzeile mit den neuen Werten aktualisieren
  133. $row->save();
  134. ]]></programlisting>
  135. </example>
  136. </sect3>
  137. <sect3 id="zend.db.table.row.write.insert">
  138. <title>Eine neue Zeile einfügen</title>
  139. <para>
  140. Eine neue Zeile kann in einer Tabelle mit der <code>createRow()</code> Methode der
  141. Tabellenklasse angelegt werden. Auf Felder dieser Zeile können mit dem
  142. Objektorientierten Interface zugegriffen werden, aber die Zeile wird nicht in der
  143. Datenbank geschrieben, bis die <code>save()</code> Methode aufgerufen wird.
  144. </para>
  145. <example id="zend.db.table.row.write.insert.example">
  146. <title>Beispiel der Erstellung einer neuen Zeile für eine Tabelle</title>
  147. <programlisting role="php"><![CDATA[
  148. $bugs = new Bugs();
  149. $newRow = $bugs->createRow();
  150. // Spaltenwerte setzen, wie es in der Anwendung üblich ist
  151. $newRow->bug_description = '...Beschreibung...';
  152. $newRow->bug_status = 'NEW';
  153. // Neue Zeile in die Datenbank einfügen
  154. $newRow->save();
  155. ]]></programlisting>
  156. </example>
  157. <para>
  158. Das optionale Argument der createRow() Methode ist ein assoziatives Array, mit dem
  159. Felder der neuen Zeile eingefügt werden können.
  160. </para>
  161. <example id="zend.db.table.row.write.insert.example2">
  162. <title>Beispiel der Bekanntgabe einer neuen Zeile für eine Tabelle</title>
  163. <programlisting role="php"><![CDATA[
  164. $data = array(
  165. 'bug_description' => '...Beschreibung...',
  166. 'bug_status' => 'NEW'
  167. );
  168. $bugs = new Bugs();
  169. $newRow = $bugs->createRow($data);
  170. // Neue Zeile in die Datenbank einfugen
  171. $newRow->save();
  172. ]]></programlisting>
  173. </example>
  174. <note>
  175. <para>
  176. Die Methode <code>createRow()</code> wurde in früheren Versionen von
  177. <classname>Zend_Db_Table</classname> <code>fetchNew()</code> genannt. Es wird empfohlen, den neuen
  178. Methodennamen zu benutzen, obwohl der alte Name weiterhin funktioniert, um
  179. Abwärtskompatibilität zu gewährleisten.
  180. </para>
  181. </note>
  182. </sect3>
  183. <sect3 id="zend.db.table.row.write.set-from-array">
  184. <title>Werte mehrerer Spalten ändern</title>
  185. <para>
  186. <classname>Zend_Db_Table_Row_Abstract</classname> beinhaltet eine Methode namens <code>setFromArray()</code>,
  187. die es ermöglicht, mehrere Spalten einer Zeile mithilfe eines assoziativen Arrays mit
  188. Spaltenname/Wert-Paaren gleichzeitig zu setzen. Diese Methode ist nützlich, um Werte für
  189. neue Zeilen oder Zeilen, die aktualisiert werden müssen, zu setzen.
  190. </para>
  191. <example id="zend.db.table.row.write.set-from-array.example">
  192. <title>Beispiel der Verwendung von setFromArray() um neue Werte in einer Tabelle zu setzen</title>
  193. <programlisting role="php"><![CDATA[
  194. $bugs = new Bugs();
  195. $newRow = $bugs->createRow();
  196. // Daten in ein assoziatives Array schreiben
  197. $data = array(
  198. 'bug_description' => '...Beschreibung...',
  199. 'bug_status' => 'NEW'
  200. );
  201. // Alle Spaltenwerte auf einmal setzen
  202. $newRow->setFromArray($data);
  203. // Neue Zeile in die Datenbank schreiben
  204. $newRow->save();
  205. ]]></programlisting>
  206. </example>
  207. </sect3>
  208. <sect3 id="zend.db.table.row.write.delete">
  209. <title>Eine Zeile löschen</title>
  210. <para>
  211. Das Zeilenobjekt hat eine Methode namens <code>delete()</code>. Diese löscht Zeilen
  212. in der Datenbank, deren Primärschlüssel dem im Zeilenobjekt entspricht.
  213. </para>
  214. <example id="zend.db.table.row.write.delete.example">
  215. <title>Beispiel für das Löschen einer Zeile</title>
  216. <programlisting role="php"><![CDATA[
  217. $bugs = new Bugs();
  218. $row = $bugs->fetchRow('bug_id = 1');
  219. // Zeile löschen
  220. $row->delete();
  221. ]]></programlisting>
  222. </example>
  223. <para>
  224. <code>save()</code> muss nicht aufgerufen werden, um den Löschvorgang
  225. abzuschließen; er wird sofort auf der Datenbank ausgeführt.
  226. </para>
  227. </sect3>
  228. </sect2>
  229. <sect2 id="zend.db.table.row.serialize">
  230. <title>Serialisieren und Deserialisieren von Zeilen</title>
  231. <para>
  232. Es ist oft nützlich, Inhalte einer Datenbankzeile für spätere Benutzung zu speichern.
  233. Die Operation, die ein Objekt in eine Form bringt, die einfach in einem Offline
  234. Speicher abgelegt werden kann (zum Beispiel eine Textdatei), nennt man
  235. <emphasis>Serialisierung</emphasis>. <classname>Zend_Db_Table_Row_Abstract</classname> Objekte sind
  236. serialisierbar.
  237. </para>
  238. <sect3 id="zend.db.table.row.serialize.serializing">
  239. <title>Eine Zeile Serialisieren</title>
  240. <para>
  241. Es kann einfach PHPs <code>serialize()</code> Funktion verwendet werden, um einen
  242. String zu erstellen, der einen Byte-Stream enthält welcher das Zeilen-Objekt
  243. repräsentiert.
  244. </para>
  245. <example id="zend.db.table.row.serialize.serializing.example">
  246. <title>Beispiel: Eine Zeile serialisieren.</title>
  247. <programlisting role="php"><![CDATA[
  248. $bugs = new Bugs();
  249. $row = $bugs->fetchRow('bug_id = 1');
  250. // Objekt serialisieren
  251. $serializedRow = serialize($row);
  252. // Jetzt kann $serializedRow z.B. in einer Datei gespeichert werden
  253. ]]></programlisting>
  254. </example>
  255. </sect3>
  256. <sect3 id="zend.db.table.row.serialize.unserializing">
  257. <title>Zeilen deserialisieren</title>
  258. <para>
  259. PHPs <code>unserialize()</code> Funktion stellt ein Objekt aus einem Byte-Stream wieder her.
  260. Die Funktion gibt das Original Objekt zurück.
  261. </para>
  262. <para>
  263. Bitte beachten: Das zurückgegebene Zeilen-Objekt ist
  264. <emphasis>nicht mit der Datenbank verbunden</emphasis>.
  265. Das Zeilenobjekt und seine Eigenschaften können gelesen werden, aber es können keine Zeilenwerte
  266. verändert oder andere Operationen ausgeführt werden, die eine Datenbankverbindung benötigen.
  267. </para>
  268. <example id="zend.db.table.row.serialize.unserializing.example">
  269. <title>Beispiel für das deserialisieren eines serialisiertes Zeilenobjektes</title>
  270. <programlisting role="php"><![CDATA[
  271. $rowClone = unserialize($serializedRow);
  272. // Jetzt können die Objekteigenschaften genutzt werden
  273. // allerdings nur lesend.
  274. echo $rowClone->bug_description;
  275. ]]></programlisting>
  276. </example>
  277. <note>
  278. <title>Warum werden Zeilenobjekte unverbunden deserialisiert?</title>
  279. <para>
  280. Ein serialisiertes Objekt ist eine Zeichenkette, die lesbar für jeden ist, dem
  281. sie vorliegt. Es könnte ein Sicherheitsrisiko sein, Parameter wie
  282. Datenbank-Loginname und -Passwort in simplem, unverschlüsseltem Text abzulegen.
  283. Es ist nicht wünschenswert, solche Daten in einer Textdatei abzulegen, die
  284. nicht geschützt ist, oder sie in einer E-Mail oder einem anderen Medium zu
  285. versenden, das leicht von potentiellen Angreifern lesbar ist.
  286. Der Leser des serialisierten Objekts sollte es nicht benutzen können, um
  287. Zugriff zur Datenbank zu erhalten, ohne richtige Logindaten zu kennen.
  288. </para>
  289. </note>
  290. </sect3>
  291. <sect3 id="zend.db.table.row.serialize.set-table">
  292. <title>Ein Zeilenobjekt als Live-Daten reaktivieren</title>
  293. <para>
  294. Ein nicht verbundenes Zeilenobjekt kann mithilfe der Methode
  295. <code>setTable()</code> reaktiviert werden. Das Argument dieser Methode ist ein
  296. gültiges <classname>Zend_Db_Table_Abstract</classname>-Objekt, das vom Benutzer erstellt
  297. wird. Für das Erstellen eines Tabellenobjekts wird eine aktive Datenbankverbindung
  298. benötigt, also wird, indem die Tabelle wieder mit dem Zeilenobjekt verknüpft wird,
  299. auch der Datenbankzugriff wiederhergestellt. Ab diesem Zeitpunkt können Werte im
  300. Zeilenobjekt wieder verändert und in der Datenbank gespeichert werden.
  301. </para>
  302. <example id="zend.db.table.row.serialize.set-table.example">
  303. <title>Ein Zeilenobjekt reaktivieren</title>
  304. <programlisting role="php"><![CDATA[
  305. $rowClone = unserialize($serializedRow);
  306. $bugs = new Bugs();
  307. // Das Zeilenobjekt wieder mit einer Tabelle
  308. // und damit mit einer aktiven Datenbankverbindung verknüpfen
  309. $rowClone->setTable($bugs);
  310. // Jetzt können wieder Werte geändert und danach gespeichert werden
  311. $rowClone->bug_status = 'FIXED';
  312. $rowClone->save();
  313. ]]></programlisting>
  314. </example>
  315. </sect3>
  316. </sect2>
  317. <sect2 id="zend.db.table.row.extending">
  318. <title>Die Zeilenklasse erweitern</title>
  319. <para>
  320. <classname>Zend_Db_Table_Row</classname> ist die standardmäßige Implementierung der abstrakten Klasse
  321. <classname>Zend_Db_Table_Row_Abstract</classname>. Selbstverständlich können auch eigene Klassen geschrieben
  322. werden, die <classname>Zend_Db_Table_Row_Abstract</classname> erweitern. Um die neue Zeilenklasse zum
  323. Speichern von Abfrageergebnissen zu benutzen, muss der Name dieser selbstgeschriebene
  324. Zeilenklasse entweder in der geschützten <code>$_rowClass</code>-Variable einer
  325. Tabellen-KLasse oder als Array-Argument des Konstruktors eines Tabellenobjekts
  326. angegeben werden.
  327. </para>
  328. <example id="zend.db.table.row.extending.example">
  329. <title>Eine eigene Zeilenklasse angeben</title>
  330. <programlisting role="php"><![CDATA[
  331. class MyRow extends Zend_Db_Table_Row_Abstract
  332. {
  333. // ...Anpassungen
  334. }
  335. // Eine eigene Zeilenklasse angeben, die
  336. // in allen Instanzen einer Tabellenklasse verwendet wird.
  337. class Products extends Zend_Db_Table_Abstract
  338. {
  339. protected $_name = 'products';
  340. protected $_rowClass = 'MyRow';
  341. }
  342. // Oder die eigene Zeilenklasse nur für eine bestimmte
  343. // Instanz der Tabellenklasse angeben.
  344. $bugs = new Bugs(array('rowClass' => 'MyRow'));
  345. ]]></programlisting>
  346. </example>
  347. <sect3 id="zend.db.table.row.extending.overriding">
  348. <title>Initialisierung einer Zeile</title>
  349. <para>
  350. Wenn Anwendungs-spezifische Logik benötigt wird die initialisiert werden soll wenn
  351. eine Zeile erstellt wird, kann entschieden werden die Aufgaben in die
  352. <code>init()</code> Methode zu verschieben, welche aufgerufen wird nachdem alle
  353. Metadaten der Zeile bearbeitet wurden. Das wird empfohlen statt der
  354. <code>__construct</code> Methode wenn die Metadaten nicht programtechnisch
  355. verändert werden müssen.
  356. <example id="zend.db.table.row.init.usage.example">
  357. <title>Beispiel der Verwendung der init() Methode</title>
  358. <programlisting role="php"><![CDATA[
  359. class MyApplicationRow extends Zend_Db_Table_Row_Abstract
  360. {
  361. protected $_role;
  362. public function init()
  363. {
  364. $this->_role = new MyRoleClass();
  365. }
  366. }
  367. ]]></programlisting>
  368. </example>
  369. </para>
  370. </sect3>
  371. <sect3 id="zend.db.table.row.extending.insert-update">
  372. <title>Eigene Logik für Einfügen, Aktualisieren und Löschen in Zend_Db_Table_Row definieren</title>
  373. <para>
  374. Die Zeilenklasse ruft geschützte Methoden namens <code>_insert()</code>,
  375. <code>_update()</code>, und <code>_delete()</code> auf, bevor die entsprechenden
  376. Operationen in der <code>INSERT</code>, <code>UPDATE</code>, und
  377. <code>DELETE</code> ausgeführt werden. In diesen Methoden kann in den eigenen
  378. Zeilenklassen auch eigene Logik implementiert werden.
  379. </para>
  380. <para>
  381. Wenn es nötig ist, eigene Logik in einer bestimmten Tabelle auszuführen, und diese
  382. Logik bei jeder Operation ausgeführt werden muss, die auf die Tabelle angewendet
  383. wird, hat es vielleicht mehr Sinn, diesen eigenen Code in den
  384. <code>insert()</code>, <code>update()</code> und <code>delete()</code>-Methoden der
  385. eigenen Tabellenklasse zu implementieren. Trotzdem kann es manchmal nötig sein,
  386. eigene Logik in der Zeilenklasse einzubauen.
  387. </para>
  388. <para>
  389. Unten sind beispielhaft Fälle aufgeführt, in denen es Sinn haben könnte,
  390. eigene Logik in der Zeilenklasse anstatt der Tabellenklasse einzubauen:
  391. </para>
  392. <example id="zend.db.table.row.extending.overriding-example1">
  393. <title>Beispiel einer eigenen Logik in einer Zeilenklasse</title>
  394. <para>
  395. Es ist möglich, dass es nicht in allen Fällen nötig ist, diese Logik
  396. anzuwenden. Eigene Logik kann auf Abruf angeboten werden, indem sie in einer
  397. Zeilenklasse eingebaut und je nach Bedarf ein Tabellenobjekt mit dieser
  398. Zeilenklasse erstellt wird. In anderen Fällen benutzt das Tabellenobjekt die
  399. Standard Zeilenklasse.
  400. </para>
  401. <para>
  402. Man benötigt Daten Operationen an der Tabelle um die Operationen an einem
  403. <classname>Zend_Log</classname> Objekt zu speichern, aber nur, wenn die Konfiguration der
  404. Anwendung dieses Verhalten eingeschaltet hat.
  405. </para>
  406. <programlisting role="php"><![CDATA[
  407. class MyLoggingRow extends Zend_Db_Table_Row_Abstract
  408. {
  409. protected function _insert()
  410. {
  411. $log = Zend_Registry::get('database_log');
  412. $log->info(Zend_Debug::dump($this->_data,
  413. "INSERT: $this->_tableClass",
  414. false)
  415. );
  416. }
  417. }
  418. // $loggingEnabled sei ein Beispiel
  419. // für eine Konfigurationseinstellung
  420. if ($loggingEnabled) {
  421. $bugs = new Bugs(array('rowClass' => 'MyLoggingRow'));
  422. } else {
  423. $bugs = new Bugs();
  424. }
  425. ]]></programlisting>
  426. </example>
  427. <example id="zend.db.table.row.extending.overriding-example2">
  428. <title>Zeilenklasse, die Insert Daten für verschiedene Tabellen loggt.</title>
  429. <para>
  430. Es könnte sein, dass eigene Anwendungslogik für mehrere Tabellen angewendet
  431. werden muss. Anstatt diese eigene Logik in jeder Tabellenklasse zu
  432. implementieren, kann der Code für solche Zwecke auch in einer Zeilenklasse
  433. eingebaut und diese Zeilenklasse für jede dieser Tabellenklassen benutzt
  434. werden.
  435. </para>
  436. <para>
  437. In diesem Beispiel ist der Logging-Code für alle Tabellenklassen identisch.
  438. </para>
  439. <programlisting role="php"><![CDATA[
  440. class MyLoggingRow extends Zend_Db_Table_Row_Abstract
  441. {
  442. protected function _insert()
  443. {
  444. $log = Zend_Registry::get('database_log');
  445. $log->info(Zend_Debug::dump($this->_data,
  446. "INSERT: $this->_tableClass",
  447. false)
  448. );
  449. }
  450. }
  451. class Bugs extends Zend_Db_Table_Abstract
  452. {
  453. protected $_name = 'bugs';
  454. protected $_rowClass = 'MyLoggingRow';
  455. }
  456. class Products extends Zend_Db_Table_Abstract
  457. {
  458. protected $_name = 'products';
  459. protected $_rowClass = 'MyLoggingRow';
  460. }
  461. ]]></programlisting>
  462. </example>
  463. </sect3>
  464. <sect3 id="zend.db.table.row.extending.inflection">
  465. <title>Inflection in Zend_Db_Table_Row einbauen</title>
  466. <para>
  467. Manche Personen ziehen es vor, dass der Klassenname der Tabelle dem Tabellennamen
  468. in der Datenbank direkt entspricht, indem eine String Transformation durchgeführt
  469. wird, die auch <emphasis>Inflection</emphasis> genannt wird.
  470. </para>
  471. <para>
  472. <classname>Zend_Db</classname> Klassen implementieren Inflection standardmäßig nicht.
  473. <xref linkend="zend.db.table.extending.inflection" /> gibt eine Erklärung für diese
  474. Richtlinie.
  475. </para>
  476. <para>
  477. Wenn Inflection genutzt werden soll, dann muss die Manipulation selbst
  478. implementiert werden, indem die Methode <code>_transformColumn()</code> in einer
  479. eigenen Zeilenklasse überschrieben wird und Objekte dieser Klasse für Abfragen an
  480. die Datenbank genutzt werden.
  481. </para>
  482. <example id="zend.db.table.row.extending.inflection.example">
  483. <title>Inflection-Methode definieren</title>
  484. <para>
  485. Das definieren einer Methode für Inflection erlaubt es, inflection-ierte
  486. Versionen der Spaltenname (beispielsweise vollständig in Großbuchstaben) als
  487. Zugriffsvariablen eines Zeilenobjekts zu benutzen. Die Zeilenklasse benutzt die
  488. Methode <code>_transformColumn()</code>, um den Namen, der als Zugriffsvariable
  489. genutzt wurde, wieder in den ursprünglichen Spaltennamen in der Tabelle
  490. umzuwandeln.
  491. </para>
  492. <programlisting role="php"><![CDATA[
  493. class MyInflectedRow extends Zend_Db_Table_Row_Abstract
  494. {
  495. protected function _transformColumn($columnName)
  496. {
  497. $nativeColumnName = meineEigeneInflectionFunktion($columnName);
  498. return $nativeColumnName;
  499. }
  500. }
  501. class Bugs extends Zend_Db_Table_Abstract
  502. {
  503. protected $_name = 'bugs';
  504. protected $_rowClass = 'MyInflectedRow';
  505. }
  506. $bugs = new Bugs();
  507. $row = $bugs->fetchNew();
  508. // Benutzung von Spaltennamen im camelCase.
  509. // _transformColumn() wandelt den Spaltennamen wieder um.
  510. $row->bugDescription = 'New description';
  511. ]]></programlisting>
  512. </example>
  513. <para>
  514. Es liegt in der Verantwortung des Entwicklers, Funktionen für Inflection zu schreiben.
  515. Zend Framework bietet solche Funktionen wie bereits erwähnt von Haus aus
  516. nicht an.
  517. </para>
  518. </sect3>
  519. </sect2>
  520. </sect1>
  521. <!--
  522. vim:se ts=4 sw=4 et:
  523. -->