Dsao_Db_Table_DataHandler_Row_Abstract Klassenreferenz

Daten-Handler, der Daten genau einer Tabellenzeile verwaltet. Mehr ...

Klassendiagramm für Dsao_Db_Table_DataHandler_Row_Abstract:

Aufstellung aller Elemente

Öffentliche Methoden
	delete ()
	Löscht Tabellenzeile.
	exists ()
	Prüft, ob Datensatz vorhanden, setzt allerdings nur die ID im Objekt.
	getRow ($throw=true)
	Gibt Tabellenzeile zurück.
	insert ()
	Fügt Daten in die Datenbank ein.
	refresh ($override=false)
	Lädt Tabellenzeile (neu).
	setRow (Zend_Db_Table_Row_Abstract $row)
	Setzt die Tabellenzeile des Objekts.
	update (array $properties=array())
	Tabellenzeile in Datenbank speichern.
Geschützte Methoden
	_fetchMinimal ($primaryKeyColumn= 'id')
	Lädt nur ID der Tabellenspalte aus Datenbank.
Geschützte Attribute
	$_row = null
	Tabellenzeile.

---

Ausführliche Beschreibung

Daten-Handler, der Daten genau einer Tabellenzeile verwaltet.

Lange Beschreibung.

Autor:

DSAo-Md

http://www.gnu.org/licenses/gpl-3.0.html GNU Public License

Version:

SVN: $Id: Abstract.php 518 2009-09-02 18:34:53Z saviola777 $

Definiert in Zeile 11 der Datei Abstract.php.

---

Dokumentation der Elementfunktionen

Dsao_Db_Table_DataHandler_Row_Abstract::_fetchMinimal

(

$

primaryKeyColumn = 'id'

)

[protected]

Lädt nur ID der Tabellenspalte aus Datenbank.

Parameter:

$primaryKeyColumn

string, Spalte mit Primärschlüssel

Rückgabe:

array, Ergebnisarray

Definiert in Zeile 25 der Datei Abstract.php.

Benutzt Dsao_Db_Table_DataHandler_Abstract::_getValidIdentifiers() und Dsao_Db_Table_DataHandler_Abstract::getTable().

Wird benutzt von exists().

  {
    $identifiers = $this->_getValidIdentifiers();

    // Select-Statement erstellen und nur primäre Spalte laden
    $select = $this->getTable()->select(true)
      ->reset(Zend_Db_Select::COLUMNS)->columns($primaryKeyColumn);

    // Where-Klausel aus Identifizierern bauen
    foreach ($identifiers as $identifier)
    {
      // Da die Identifizierer fest im Code verankert sind und keine vom
      // Benutzer übergebenene Werte, wird hier nicht gequotet
      $select->where($identifier.' = ?', $this->__get($identifier));
    }

    $row = $select->fetchRow();

    return ($row ? $row->toArray() : array());
  }

Dsao_Db_Table_DataHandler_Row_Abstract::delete

(

)

Löscht Tabellenzeile.

Rückgabe:

Dsao_Db_Table_DataHandler_Row_Abstract, fließendes Interface

Erneute Implementation von Dsao_Db_Table_DataHandler_Abstract.

Definiert in Zeile 51 der Datei Abstract.php.

Benutzt getRow() und Dsao_Db_Table_DataHandler_Abstract::isSynchronous().

  {
    parent::delete();

    // Falls Objekt noch nicht aus Datenbank geladen, erst laden und dann
    // löschen
    if (null === $this->isSynchronous())
    {
      $this->getSelect()->fetchRow()->delete();
    }
    // Ansonsten Zeile löschen
    else
    {
      $this->getRow(false)->delete();
    }

    return $this;
  }

Dsao_Db_Table_DataHandler_Row_Abstract::exists

(

)

Prüft, ob Datensatz vorhanden, setzt allerdings nur die ID im Objekt.

Rückgabe:

bool, ob Datensatz vorhanden

Erneute Implementation von Dsao_Db_Table_DataHandler_Abstract.

Definiert in Zeile 75 der Datei Abstract.php.

Benutzt Dsao_DataHandler_Abstract::__set(), _fetchMinimal() und Dsao_DataHandler_Abstract::isReadOnly().

  {
    // Falls schon übergeordnete Funktion Vorhandensein eindeutig klären konnte
    if (null !== ($exists = parent::exists()))
    {
      return $exists;
    }

    $rowData = $this->_fetchMinimal();

    // Falls ID vorhanden und Objekt nicht schreib geschützt
    if (isset($rowData['id']) && !$this->isReadOnly())
    {
      $this->__set('id', $rowData['id']);
    }

    return (bool) $rowData;
  }

Dsao_Db_Table_DataHandler_Row_Abstract::getRow

(

$

throw = true

)

Gibt Tabellenzeile zurück.

Parameter:

$throw

bool, ob ggf. Exception geworfen werden soll

Rückgabe:

Zend_Db_Table_Row_Abstract, Tabellenzeile

Definiert in Zeile 100 der Datei Abstract.php.

Benutzt Dsao_Db_Table_DataHandler_Abstract::isSynchronous().

Wird benutzt von delete(), refresh() und update().

  {
    // Falls Objekt nicht snychron oder noch nicht geladen wurde
    if ((!$this->isSynchronous() || null === $this->_row) && $throw)
    {
      throw new Dsao_Exception
        ('dsao_db_table_datahandler_row_abstract_row_asynchronous');
    }

    return $this->_row;
  }

Dsao_Db_Table_DataHandler_Row_Abstract::insert

(

)

Fügt Daten in die Datenbank ein.

Rückgabe:

Dsao_Db_Table_DataHandler_Row_Abstract, fließendes Interface

Erneute Implementation von Dsao_Db_Table_DataHandler_Abstract.

Definiert in Zeile 117 der Datei Abstract.php.

Benutzt Dsao_Db_Table_DataHandler_Abstract::getTable().

  {
    parent::insert($properties);

    // In Datenbank einfügen
    $this->getTable()->insert($this->_data->getArrayCopy());

    return $this;
  }

Dsao_Db_Table_DataHandler_Row_Abstract::refresh

(

$

override = false

)

Lädt Tabellenzeile (neu).

Parameter:

$override

bool, ob Änderungen ignoriert werden sollen

Rückgabe:

Dsao_Db_Table_DataHandler_Row_Abstract, fließendes Interface

Definiert in Zeile 133 der Datei Abstract.php.

Benutzt getRow(), Dsao_Db_Table_DataHandler_Abstract::isSynchronous(), Dsao_Db_Table_DataHandler_Abstract::refresh() und Dsao_DataHandler_Abstract::setData().

  {
    parent::refresh();

    // Falls Objekt mit Datenbank synchron oder Änderungen ignoriert werden
    // sollen, vorhandene Zeile aktualisieren
    if (true === $this->isSynchronous()
      || (false === $this->isSynchronous && $override))
    {
      $this->getRow(false)->refresh();
    }
    // Ansonsten Zeile laden
    else
    {
      $this->_fetchRow();

      $this->setData($this->_row->toArray());
    }

    return $this;
  }

Dsao_Db_Table_DataHandler_Row_Abstract::setRow

(

Zend_Db_Table_Row_Abstract $

row

)

Setzt die Tabellenzeile des Objekts.

Parameter:

$row

Zend_Db_Table_Row_Abstract, Tabellenzeile

Rückgabe:

Dsao_Db_Table_DataHandler_Row_Abstract, fließendes Interface

Definiert in Zeile 161 der Datei Abstract.php.

Benutzt Dsao_Db_Table_DataHandler_Abstract::getTable().

  {
    // Falls Zeile zu einer anderen Tabelle gehört
    if ($row->getTable()->info(Zend_Db_Table_Abstract::NAME)
      != $this->getTable()->info(Zend_Db_Table_Abstract::NAME))
    {
      throw new Dsao_Exception
        ('dsao_db_table_datahandler_row_abstract_table_invalid');
    }

    // Zeile speichern
    $this->_row = $row;

    // Daten setzen
    $this->_data = $row->toArray();

    // Als synchron und gültig markieren
    $this->_synchronous = true;
    $this->_valid = true;

    return $this;
  }

Dsao_Db_Table_DataHandler_Row_Abstract::update

(

array $

properties = array()

)

Tabellenzeile in Datenbank speichern.

Parameter:

$properties

array, zu ändernde Eigenschaften

Rückgabe:

Dsao_Db_Table_DataHandler_Row_Abstract, fließendes Interface

Erneute Implementation von Dsao_Db_Table_DataHandler_Abstract.

Definiert in Zeile 190 der Datei Abstract.php.

Benutzt Dsao_Db_Table_DataHandler_Abstract::getData() und getRow().

  {
    $this->getRow(false)->setFromArray($this->getData($properties))->save();
  }

---

Die Dokumentation für diese Klasse wurde erzeugt aufgrund der Datei:

• /var/www/devel.dsao.eu/library/Dsao/Db/Table/DataHandler/Row/Abstract.php