Dsao_User Klassenreferenz

Repraesentiert einen einzelnen Benutzer. Mehr ...

Klassendiagramm für Dsao_User:

Aufstellung aller Elemente

Öffentliche Methoden
	exists ()
	Prüft, ob zum Objekt gehörende Datensätze in der Datenbank existieren, ohne diese (vollständig) zu laden.
	getReserialize ()
	Gibt self::$_reserialize zurueck, oder false, wenn Benutzer ungueltig.
	refresh ()
	Aktualisiert Daten des Objekts aus der Datenbank und überschreibt eventuelle Änderungen an den Daten.
	insert ()
	Fügt Daten des Objekts in Datenbank ein.
	setReserialize ($flag)
	Setzen von Flag um Benutzerobjekt neu zu serialisieren.
	update (array $properties=array())
	Aktualisiert (teilweise) Daten des Objekts in der Datenbank.
Geschützte Methoden
	_checkValidity ()
	Prüft Gültigkeit, indemie Identifizierer kontrolliert werden.
	_fetchAll ()
	Lädt alle Benutzerdaten aus Datenbank.
Geschützte Attribute
	$_identifiers = array('id', array('username', 'emailAddress'))
	Array mit Eigenschaften, die eine klare Identifizierung eines Datenbanksatzes zulassen.
	$_propertiesProtected = array('id')
	array, Geschützte Eigenschaften, können nicht über setData() gesetzt werden
	$_reserialize = false
	bool, Ist true, wenn Sessiondaten nicht mehr aktuell sind und neu serialisiert werden sollen
	$_table = 'user_data'
	string, zunächst Name und später Objekt der (Haupt-)-Tabelle

---

Ausführliche Beschreibung

Repraesentiert einen einzelnen Benutzer.

Die Klasse repraesentiert einen einzelnen Benutzer und sammelt und verwaltet alle damit zusammenhaengenden Informationen.

Autor:

DSAo-Md

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

Version:

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

Definiert in Zeile 12 der Datei User.php.

---

Dokumentation der Elementfunktionen

Dsao_User::_checkValidity

(

)

[protected]

Prüft Gültigkeit, indemie Identifizierer kontrolliert werden.

Rückgabe:

bool, Gültigkeit

Erneute Implementation von Dsao_Db_Table_DataHandler_Abstract.

Definiert in Zeile 25 der Datei User.php.

  {
    // Gültigkeit auf false setzen, dann aber true zurück geben. Grund:
    // Hier kann die Gültigkeit des Objekts nicht geprüft werden, also ist es
    // per Definition ungültig. Auf der anderen Seite spricht von hier aus
    // nichts dagegen, dass es gültig sein _könnte_. Also true zurück geben
    $this->_valid = false;

    return true;
  }

Dsao_User::_fetchAll

(

)

[protected]

Lädt alle Benutzerdaten aus Datenbank.

Rückgabe:

void

Definiert in Zeile 41 der Datei User.php.

Benutzt Dsao_Db_Table_DataHandler_Abstract::_addWhere(), Dsao_Db_Table_DataHandler_Abstract::_parseResult() und Dsao_Db_Table_DataHandler_Abstract::getTable().

Wird benutzt von refresh().

  {
    // Select-Statement aufbauen
    $select = $this->getTable()->getAdapter()->select()->from('user_data')
      // Profildaten
      ->joinUsing('user_profile', 'id')
      // Einstellungen
      ->joinUsing('user_settings', 'id')
      // ACL-Rollennamen laden
      ->join('acl_role', 'user_data.idRole = acl_role.id',
        array('role' => 'name'));

    // Where-Klausel bilden
    $this->_addWhere($select, array(), array('table' => 'user_data'));

    $result = $this->getTable()->getAdapter()->fetchAll($select);

    // Daten setzen
    $this->_parseResult(array_pop($result));
  }

Dsao_User::exists

(

)

Prüft, ob zum Objekt gehörende Datensätze in der Datenbank existieren, ohne diese (vollständig) zu laden.

Rückgabe:

bool, ob Datensätze vorhanden

Erneute Implementation von Dsao_Db_Table_DataHandler_Abstract.

Definiert in Zeile 62 der Datei User.php.

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

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

    // Select-Statement bauen
    $select = $this->getTable()->select(true)->reset(Zend_Db_Select::COLUMNS)
      ->columns('id');
    $this->_addWhere($select);

    return (bool) $select->fetchRow();
  }

Dsao_User::getReserialize

(

)

Gibt self::$_reserialize zurueck, oder false, wenn Benutzer ungueltig.

Rückgabe:

bool, Ob Benutzer neu serialisiert werden soll

Definiert in Zeile 83 der Datei User.php.

  {
    // Falls Benutzer ungueltig ist, immer false zurueckgeben
    return ($this->_valid ? (bool) $this->_reserialize : false);
  }

Dsao_User::insert

(

)

Fügt Daten des Objekts in Datenbank ein.

Rückgabe:

Dsao_Db_Table_DataHandler_Abstract, fließendes Interface

Erneute Implementation von Dsao_Db_Table_DataHandler_Abstract.

Definiert in Zeile 98 der Datei User.php.

  {
    // Benutzer kann nicht über Objekt eingefügt werden
    throw new Dsao_Exception('dsao_user_insert');
  }

Dsao_User::refresh

(

)

Aktualisiert Daten des Objekts aus der Datenbank und überschreibt eventuelle Änderungen an den Daten.

Rückgabe:

Dsao_Db_Table_DataHandler_Abstract, fließendes Interface

Erneute Implementation von Dsao_Db_Table_DataHandler_Abstract.

Definiert in Zeile 89 der Datei User.php.

Benutzt _fetchAll().

  {
    parent::refresh();

    $this->_fetchAll();

    return $this;
  }

Dsao_User::setReserialize

(

$

flag

)

Setzen von Flag um Benutzerobjekt neu zu serialisieren.

Setzt den Flag self::$_reserialize, damit Benutzerobjekt beim Verlassen der Applikation (Dsao_Plugin_Auth::postDispatch()) neu serialisiert wird

Parameter:

$flag

bool, Neuer Wert fuer self::$_rezerialize

Rückgabe:

void

Definiert in Zeile 113 der Datei User.php.

  {
      $this->_reserialize = (bool) $flag;
  }

Dsao_User::update

(

array $

properties = array()

)

Aktualisiert (teilweise) Daten des Objekts in der Datenbank.

Parameter:

$properties

array, Felder, die geändert werden sollen

Rückgabe:

Dsao_Db_Table_DataHandler_Abstract, fließendes Interface

Erneute Implementation von Dsao_Db_Table_DataHandler_Abstract.

Definiert in Zeile 118 der Datei User.php.

Benutzt Dsao_DataHandler_Abstract::__get(), Dsao_Db_Table_DataHandler_Abstract::getData(), Dsao_Db_Table_DataHandler_Abstract::getTable() und Dsao_Db_Table_DataHandler_Abstract::setSynchronous().

  {
    parent::update($properties);

    // Zeile aus Tabellen laden
    $rowUserData = Dsao_Registry::getTable('user_data')->find($this->__get('id'))->current();

    // Zeilen aus anderen Tabellen laden
    $rowUserProfile   = $rowUserData->findParentRow
      ('Dsao_Db_Table_UserProfile', 'userProfile');
    $rowUserSettings  = $rowUserData->findParentRow
      ('Dsao_Db_Table_UserSettings', 'userSettings');

    $data = $this->getData($properties);

    // Daten übergeben (es werden jeweils nur relevante übernommen)
    $rowUserData->setFromArray($data);
    $rowUserProfile->setFromArray($data);
    $rowUserSettings->setFromArray($data);

    // Speichern
    $rowUserData->save();
    $rowUserProfile->save();
    $rowUserSettings->save();

    $this->setSynchronous(true);

    return $this;
  }

---

Dokumentation der Datenelemente

Dsao_User::$_identifiers = array('id', array('username', 'emailAddress')) [protected]

Array mit Eigenschaften, die eine klare Identifizierung eines Datenbanksatzes zulassen.

Der Primary-Key muss hier nicht festgehalten werden, nur weitere Unique-Spalten oder Kombinationen. Über Unterarrays können Spaltenkombinationen festgehalten werden.

Erneute Implementation von Dsao_Db_Table_DataHandler_Abstract.

Definiert in Zeile 14 der Datei User.php.

---

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

• /var/www/devel.dsao.eu/library/Dsao/User.php