%PDF-
%PDF-
Mini Shell
Mini Shell
<?php
/**
* This file is part of the Nette Framework (http://nette.org)
*
* Copyright (c) 2004 David Grudl (http://davidgrudl.com)
*
* For the full copyright and license information, please view
* the file license.txt that was distributed with this source code.
*/
namespace Nette\Database\Table;
use Nette,
Nette\Database\Reflection\MissingReferenceException;
/**
* Single row representation.
* ActiveRow is based on the great library NotORM http://www.notorm.com written by Jakub Vrana.
*
* @author Jakub Vrana
*/
class ActiveRow extends Nette\Object implements \IteratorAggregate, \ArrayAccess
{
/** @var Selection */
private $table;
/** @var array of row data */
private $data;
/** @var bool */
private $dataRefreshed = FALSE;
/** @var array of new values {@see ActiveRow::update()} */
private $modified = array();
public function __construct(array $data, Selection $table)
{
$this->data = $data;
$this->table = $table;
}
/**
* @internal
* @ignore
*/
public function setTable(Selection $table)
{
$this->table = $table;
}
/**
* @internal
* @ignore
*/
public function getTable()
{
return $this->table;
}
public function __toString()
{
try {
return (string) $this->getPrimary();
} catch (\Exception $e) {
trigger_error("Exception in " . __METHOD__ . "(): {$e->getMessage()} in {$e->getFile()}:{$e->getLine()}", E_USER_ERROR);
}
}
/**
* @return array
*/
public function toArray()
{
$this->accessColumn(NULL);
return $this->data;
}
/**
* Returns primary key value.
* @param bool
* @return mixed
*/
public function getPrimary($need = TRUE)
{
$primary = $this->table->getPrimary();
if (!is_array($primary)) {
if (isset($this->data[$primary])) {
return $this->data[$primary];
} elseif ($need) {
throw new Nette\InvalidStateException("Row does not contain primary $primary column data.");
} else {
return NULL;
}
} else {
$primaryVal = array();
foreach ($primary as $key) {
if (!isset($this->data[$key])) {
if ($need) {
throw new Nette\InvalidStateException("Row does not contain primary $key column data.");
} else {
return NULL;
}
}
$primaryVal[$key] = $this->data[$key];
}
return $primaryVal;
}
}
/**
* Returns row signature (composition of primary keys)
* @param bool
* @return string
*/
public function getSignature($need = TRUE)
{
return implode('|', (array) $this->getPrimary($need));
}
/**
* Returns referenced row.
* @param string
* @param string
* @return ActiveRow or NULL if the row does not exist
*/
public function ref($key, $throughColumn = NULL)
{
if (!$throughColumn) {
list($key, $throughColumn) = $this->table->getConnection()->getDatabaseReflection()->getBelongsToReference($this->table->getName(), $key);
}
return $this->getReference($key, $throughColumn);
}
/**
* Returns referencing rows.
* @param string
* @param string
* @return GroupedSelection
*/
public function related($key, $throughColumn = NULL)
{
if (strpos($key, '.') !== FALSE) {
list($key, $throughColumn) = explode('.', $key);
} elseif (!$throughColumn) {
list($key, $throughColumn) = $this->table->getConnection()->getDatabaseReflection()->getHasManyReference($this->table->getName(), $key);
}
return $this->table->getReferencingTable($key, $throughColumn, $this[$this->table->getPrimary()]);
}
/**
* Updates row.
* @param array or NULL for all modified values
* @return int number of affected rows or FALSE in case of an error
*/
public function update($data = NULL)
{
if ($data === NULL) {
$data = $this->modified;
}
return $this->table->getConnection()
->table($this->table->getName())
->wherePrimary($this->getPrimary())
->update($data);
}
/**
* Deletes row.
* @return int number of affected rows or FALSE in case of an error
*/
public function delete()
{
$res = $this->table->getConnection()
->table($this->table->getName())
->wherePrimary($this->getPrimary())
->delete();
if ($res > 0 && ($signature = $this->getSignature(FALSE))) {
unset($this->table[$signature]);
}
return $res;
}
/********************* interface IteratorAggregate ****************d*g**/
public function getIterator()
{
$this->accessColumn(NULL);
return new \ArrayIterator($this->data);
}
/********************* interface ArrayAccess & magic accessors ****************d*g**/
/**
* Stores value in column.
* @param string column name
* @param string value
* @return void
*/
public function offsetSet($key, $value)
{
$this->__set($key, $value);
}
/**
* Returns value of column.
* @param string column name
* @return string
*/
public function offsetGet($key)
{
return $this->__get($key);
}
/**
* Tests if column exists.
* @param string column name
* @return bool
*/
public function offsetExists($key)
{
return $this->__isset($key);
}
/**
* Removes column from data.
* @param string column name
* @return void
*/
public function offsetUnset($key)
{
$this->__unset($key);
}
public function __set($key, $value)
{
$this->data[$key] = $value;
$this->modified[$key] = $value;
}
public function &__get($key)
{
$this->accessColumn($key);
if (array_key_exists($key, $this->data)) {
return $this->data[$key];
}
try {
list($table, $column) = $this->table->getConnection()->getDatabaseReflection()->getBelongsToReference($this->table->getName(), $key);
$referenced = $this->getReference($table, $column);
if ($referenced !== FALSE) {
$this->accessColumn($key, FALSE);
return $referenced;
}
} catch(MissingReferenceException $e) {}
$this->removeAccessColumn($key);
throw new Nette\MemberAccessException("Cannot read an undeclared column \"$key\".");
}
public function __isset($key)
{
$this->accessColumn($key);
if (array_key_exists($key, $this->data)) {
return isset($this->data[$key]);
}
$this->removeAccessColumn($key);
return FALSE;
}
public function __unset($key)
{
unset($this->data[$key]);
unset($this->modified[$key]);
}
protected function accessColumn($key, $selectColumn = TRUE)
{
if (isset($this->modified[$key])) {
return;
}
$this->table->accessColumn($key, $selectColumn);
if ($this->table->getDataRefreshed() && !$this->dataRefreshed) {
$this->data = $this->table[$this->getSignature()]->data;
$this->dataRefreshed = TRUE;
}
}
protected function removeAccessColumn($key)
{
$this->table->removeAccessColumn($key);
}
protected function getReference($table, $column)
{
$this->accessColumn($column);
if (array_key_exists($column, $this->data)) {
$value = $this->data[$column];
$value = $value instanceof ActiveRow ? $value->getPrimary() : $value;
$referenced = $this->table->getReferencedTable($table, $column, !empty($this->modified[$column]));
$referenced = isset($referenced[$value]) ? $referenced[$value] : NULL; // referenced row may not exist
if (!empty($this->modified[$column])) { // cause saving changed column and prevent regenerating referenced table for $column
$this->modified[$column] = 0; // 0 fails on empty, pass on isset
}
return $referenced;
}
return FALSE;
}
}
Zerion Mini Shell 1.0