Zend_Db_Table_Row.xml 26 KB

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