repo_zf1/documentation/manual/de/module_specs/Zend_Db_Table_Definition.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 17054 -->
<!-- Reviewed: no -->
<sect1 id="zend.db.table.definition">

    <title>Zend_Db_Table_Definition</title>

    <sect2 id="zend.db.table.definition.introduction">

        <title>Einführung</title>

        <para>
            <classname>Zend_Db_Table_Definition</classname> ist eine Klasse die verwendet werden kann
            um Relationen und Optionen der Konfiguration zu beschreiben die verwendet werden sollten
            wenn <classname>Zend_Db_Table</classname> über eine konkrete Instanz verwendet wird.
        </para>

    </sect2>

    <sect2 id="zend.db.table.definition.usage">

        <title>Grundsätzliche Verwendung</title>

        <para>
            Für alle gleichen Optionen die vorhanden sind wenn eine erweiterte
            Zend_Db_Table_Abstract Klasse konfiguriert wird, sind diese Optionen auch vorhanden
            wenn eine Definitionsdatei beschrieben wird. Diese Definitionsdatei sollte der Klasse
            zum Zeitpunkt der Instanziierung übergeben werden damit diese die komplette Definition
            aller Tabellen in der besagten Definition kennt.
        </para>

        <para>
            Anbei ist eine Definition welche die Tabellennamen und Relationen zwischen den Tabellen
            Objekten beschreibt. Beachte: Wenn 'name' von der Definition ausgelassen wird, wird er
            als Schlüssel der definierten Tabelle genommen (ein Beispiel hierfür ist die 'genre'
            Sektion im Beispiel anbei.)
        </para>

        <example id="zend.db.table.definition.example1">

            <title>Die Definition eines Datenbank Data Modells beschreiben</title>

            <programlisting language="php"><![CDATA[
$definition = new Zend_Db_Table_Definition(array(
    'author' => array(
        'name' => 'author',
        'dependentTables' => array('book')
        ),
    'book' => array(
        'name' => 'book',
        'referenceMap' => array(
            'author' => array(
                'columns' => 'author_id',
                'refTableClass' => 'author',
                'refColumns' => 'id'
                )
            )
        ),
    'genre' => null,
    'book_to_genre' => array(
        'referenceMap' => array(
            'book' => array(
                'columns' => 'book_id',
                'refTableClass' => 'book',
                'refColumns' => 'id'
                ),
            'genre' => array(
                'columns' => 'genre_id',
                'refTableClass' => 'genre',
                'refColumns' => 'id'
                )
            )
        )
    ));
]]></programlisting>

        </example>

        <para>
            Wie man sieht sind die gleichen Optionen die man generell in einer erweiterten
            Zend_Db_Table_Abstract Klasse sieht auch in diesem Array dokumentiert. Wenn es
            in den Constructor von Zend_Db_Table übergeben wird, ist diese Definition
            <emphasis>persistent</emphasis> in jeder Tabelle die erstellt werden muß um die
            richtigen Zeilen zurückzugeben.
        </para>

        <para>
            Anbei ist ein Beispiel der Instanziierung einer primären Tabelle sowie Aufrufe von
            findDependentRowset() und findManyToManyRowset() die mit dem oben beschriebenen
            Datenmodell korrespondieren:
        </para>


        <example id="zend.db.table.definition.example2">

            <title>Mit der beschriebenen Definition interagieren</title>

            <programlisting language="php"><![CDATA[
$authorTable = new Zend_Db_Table('author', $definition);
$authors = $authorTable->fetchAll();

foreach ($authors as $author) {
    echo $author->id
       . ': '
       . $author->first_name
       . ' '
       . $author->last_name
       . PHP_EOL;
    $books = $author->findDependentRowset('book');
    foreach ($books as $book) {
        echo '    Buch: ' . $book->title . PHP_EOL;
        $genreOutputArray = array();
        $genres = $book->findManyToManyRowset('genre', 'book_to_genre');
        foreach ($genres as $genreRow) {
            $genreOutputArray[] = $genreRow->name;
        }
        echo '        Genre: ' . implode(', ', $genreOutputArray) . PHP_EOL;
    }
}
]]></programlisting>

        </example>


    </sect2>

    <sect2 id="zend.db.table.definition.advanced-usage">

        <title>Fortgeschrittene Verwendung</title>

        <para>
            Manchmal will man beide Paradigmen für die Definition und Verwendung des
            Tabellen Gateways verwenden: Beide durch Wrweiterung und konkrete Instanziierung.
            Um das zu tun muß man einfach alle Tabellen Konfigurationen aus der Definition
            lassen. Das erlaubt es Zend_Db_Table in der aktuell referierten Klasse statt im
            Definitionsschlüssel nachzusehen.
        </para>

        <para>
            Aufbauend auf dem Beispiel anbei, erlauben wir es einer der Tabellenkonfigurationen
            eine erweiterte Zend_Db_Table_Abstract Klasse zu sein, wärend der Rest der Tabellen
            Teil der Definition ist. Wir zeigen auch wie man mit dieser neuen Definition
            interagieren kann.
        </para>

        <example id="zend.db.table.definition.example3">

            <title>Mit einer gemischten Zend_Db_Table Definition interagieren</title>

            <programlisting language="php"><![CDATA[
class MyBook extends Zend_Db_Table_Abstract
{
    protected $_name = 'book';
    protected $_referenceMap = array(
        'author' => array(
            'columns' => 'author_id',
            'refTableClass' => 'author',
            'refColumns' => 'id'
            )
        );
}

$definition = new Zend_Db_Table_Definition(array(
    'author' => array(
        'name' => 'author',
        'dependentTables' => array('MyBook')
        ),
    'genre' => null,
    'book_to_genre' => array(
        'referenceMap' => array(
            'book' => array(
                'columns' => 'book_id',
                'refTableClass' => 'MyBook',
                'refColumns' => 'id'
                ),
            'genre' => array(
                'columns' => 'genre_id',
                'refTableClass' => 'genre',
                'refColumns' => 'id'
                )
            )
        )
    ));

$authorTable = new Zend_Db_Table('author', $definition);
$authors = $authorTable->fetchAll();

foreach ($authors as $author) {
    echo $author->id
       . ': '
       . $author->first_name
       . ' '
       . $author->last_name
       . PHP_EOL;
    $books = $author->findDependentRowset(new MyBook());
    foreach ($books as $book) {
        echo '    Buch: ' . $book->title . PHP_EOL;
        $genreOutputArray = array();
        $genres = $book->findManyToManyRowset('genre', 'book_to_genre');
        foreach ($genres as $genreRow) {
            $genreOutputArray[] = $genreRow->name;
        }
        echo '        Genre: ' . implode(', ', $genreOutputArray) . PHP_EOL;
    }
}

]]></programlisting>

        </example>

    </sect2>

</sect1>