Gecko [ ifk.uw.edu.pl ]

Name	Size	Permission
Exceptions	[ DIR ]	drwxr-xr-x
Relations	[ DIR ]	drwxr-xr-x
Scaffold	[ DIR ]	drwxr-xr-x
TActiveRecord.php	34.57 KB	-rw-r--r--
TActiveRecordChangeEventParame...	1.17 KB	-rw-r--r--
TActiveRecordConfig.php	4.96 KB	-rw-r--r--
TActiveRecordCriteria.php	871 B	-rw-r--r--
TActiveRecordGateway.php	13.63 KB	-rw-r--r--
TActiveRecordInvalidFinderResu...	951 B	-rw-r--r--
TActiveRecordManager.php	3.85 KB	-rw-r--r--

Code Editor : TActiveRecordGateway.php

<?php
/**
 * TActiveRecordGateway class file.
 *
 * @author Wei Zhuo <weizhuo[at]gmail[dot]com>
 * @link https://github.com/pradosoft/prado
 * @license https://github.com/pradosoft/prado/blob/master/LICENSE
 */

namespace Prado\Data\ActiveRecord;

use Prado\Data\ActiveRecord\Exceptions\TActiveRecordException;
use Prado\Data\ActiveRecord\Relations\TActiveRecordRelationContext;
use Prado\Data\Common\TDbMetaData;
use Prado\Data\Common\TDbTableColumn;
use Prado\Data\Common\TDbTableInfo;
use Prado\Data\DataGateway\TDataGatewayCommand;
use Prado\Data\DataGateway\TSqlCriteria;
use Prado\Data\TDbConnection;
use Prado\Prado;
use ReflectionClass;

/**
 * TActiveRecordGateway excutes the SQL command queries and returns the data
 * record as arrays (for most finder methods).
 *
 * @author Wei Zhuo <weizho[at]gmail[dot]com>
 * @since 3.1
 */
class TActiveRecordGateway extends \Prado\TComponent
{
	public const DEFAULT_DATA_GATEWAY_CLASS = '\Prado\Data\DataGateway\TDataGatewayCommand';

/**
	 * Defaults to {@link TActiveRecordGateway::DEFAULT_GATEWAY_CLASS DEFAULT_GATEWAY_CLASS}
	 * @var string
	 */
	private $_dataGatewayClass = self::DEFAULT_DATA_GATEWAY_CLASS;
	private $_manager;
	private $_tables = []; //table cache
	private $_meta = []; //meta data cache.
	private $_commandBuilders = [];
	private $_currentRecord;

/**
	 * Constant name for specifying optional table name in TActiveRecord.
	 */
	public const TABLE_CONST = 'TABLE';
	/**
	 * Method name for returning optional table name in in TActiveRecord
	 */
	public const TABLE_METHOD = 'table';

/**
	 * Record gateway constructor.
	 * @param TActiveRecordManager $manager
	 */
	public function __construct(TActiveRecordManager $manager)
	{
		$this->_manager = $manager;
		parent::__construct();
	}

/**
	 * @return TActiveRecordManager record manager.
	 */
	protected function getManager()
	{
		return $this->_manager;
	}

/**
	 * Gets the table name from the 'TABLE' constant of the active record
	 * class if defined, otherwise use the class name as table name.
	 * @param TActiveRecord $record active record instance
	 * @return string table name for the given record class.
	 */
	protected function getRecordTableName(TActiveRecord $record)
	{
		$class = new ReflectionClass($record);
		if ($class->hasConstant(self::TABLE_CONST)) {
			$value = $class->getConstant(self::TABLE_CONST);
			if (empty($value)) {
				throw new TActiveRecordException(
					'ar_invalid_tablename_property',
					get_class($record),
					self::TABLE_CONST
				);
			}
			return $value;
		} elseif ($class->hasMethod(self::TABLE_METHOD)) {
			$value = $record->{self::TABLE_METHOD}();
			if (empty($value)) {
				throw new TActiveRecordException(
					'ar_invalid_tablename_method',
					get_class($record),
					self::TABLE_METHOD
				);
			}
			return $value;
		} else {
			return strtolower(get_class($record));
		}
	}

/**
	 * Returns table information, trys the application cache first.
	 * @param TActiveRecord $record
	 * @return TDbTableInfo table information.
	 */
	public function getRecordTableInfo(TActiveRecord $record)
	{
		$tableName = $this->getRecordTableName($record);
		return $this->getTableInfo($record->getDbConnection(), $tableName);
	}

/**
	 * Returns table information for table in the database connection.
	 * @param \Prado\Data\TDbConnection $connection database connection
	 * @param string $tableName table name
	 * @return TDbTableInfo table details.
	 */
	public function getTableInfo(TDbConnection $connection, $tableName)
	{
		$connStr = $connection->getConnectionString();
		$key = $connStr . $tableName;
		if (!isset($this->_tables[$key])) {
			//call this first to ensure that unserializing the cache
			//will find the correct driver dependent classes.
			if (!isset($this->_meta[$connStr])) {
				$this->_meta[$connStr] = TDbMetaData::getInstance($connection);
			}

$tableInfo = null;
			if (($cache = $this->getManager()->getCache()) !== null) {
				$tableInfo = $cache->get($key);
			}
			if (empty($tableInfo)) {
				$tableInfo = $this->_meta[$connStr]->getTableInfo($tableName);
				if ($cache !== null) {
					$cache->set($key, $tableInfo);
				}
			}
			$this->_tables[$key] = $tableInfo;
		}
		return $this->_tables[$key];
	}

/**
	 * @param TActiveRecord $record
	 * @return TDataGatewayCommand
	 */
	public function getCommand(TActiveRecord $record)
	{
		$conn = $record->getDbConnection();
		$connStr = $conn->getConnectionString();
		$tableInfo = $this->getRecordTableInfo($record);
		if (!isset($this->_commandBuilders[$connStr])) {
			$builder = $tableInfo->createCommandBuilder($record->getDbConnection());
			$command = Prado::createComponent($this->getDataGatewayClass(), $builder);
			$command->attachEventHandler('OnCreateCommand', [$this, 'onCreateCommand']);
			$command->attachEventHandler('OnExecuteCommand', [$this, 'onExecuteCommand']);
			$this->_commandBuilders[$connStr] = $command;
		}
		$this->_commandBuilders[$connStr]->getBuilder()->setTableInfo($tableInfo);
		$this->_currentRecord = $record;
		return $this->_commandBuilders[$connStr];
	}

/**
	 * Set implementation class of DataGatewayCommand
	 * @param string $value
	 */
	public function setDataGatewayClass($value)
	{
		$this->_dataGatewayClass = (string) $value;
	}

/**
	 * @return string the implementation class of DataGatewayCommand. Defaults to {@link TActiveRecordGateway::DEFAULT_DATA_GATEWAY_CLASS DEFAULT_DATA_GATEWAY_CLASS}
	 */
	public function getDataGatewayClass()
	{
		return $this->_dataGatewayClass;
	}

/**
	 * Raised when a command is prepared and parameter binding is completed.
	 * The parameter object is TDataGatewayEventParameter of which the
	 * {@link TDataGatewayEventParameter::getCommand Command} property can be
	 * inspected to obtain the sql query to be executed.
	 * This method also raises the OnCreateCommand event on the ActiveRecord
	 * object calling this gateway.
	 * @param TDataGatewayCommand $sender originator
	 * @param \Prado\Data\DataGateway\TDataGatewayEventParameter $param
	 */
	public function onCreateCommand($sender, $param)
	{
		$this->raiseEvent('OnCreateCommand', $this, $param);
		if ($this->_currentRecord !== null) {
			$this->_currentRecord->onCreateCommand($param);
		}
	}

/**
	 * Raised when a command is executed and the result from the database was returned.
	 * The parameter object is TDataGatewayResultEventParameter of which the
	 * {@link TDataGatewayEventParameter::getResult Result} property contains
	 * the data return from the database. The data returned can be changed
	 * by setting the {@link TDataGatewayEventParameter::setResult Result} property.
	 * This method also raises the OnCreateCommand event on the ActiveRecord
	 * object calling this gateway.
	 * @param TDataGatewayCommand $sender originator
	 * @param \Prado\Data\DataGateway\TDataGatewayResultEventParameter $param
	 */
	public function onExecuteCommand($sender, $param)
	{
		$this->raiseEvent('OnExecuteCommand', $this, $param);
		if ($this->_currentRecord !== null) {
			$this->_currentRecord->onExecuteCommand($param);
		}
	}

/**
	 * Returns record data matching the given primary key(s). If the table uses
	 * composite key, specify the name value pairs as an array.
	 * @param TActiveRecord $record active record instance.
	 * @param array $keys primary name value pairs
	 * @return array record data
	 */
	public function findRecordByPK(TActiveRecord $record, $keys)
	{
		$command = $this->getCommand($record);
		return $command->findByPk($keys);
	}

/**
	 * Returns records matching the list of given primary keys.
	 * @param TActiveRecord $record active record instance.
	 * @param array $keys list of primary name value pairs
	 * @return array matching data.
	 */
	public function findRecordsByPks(TActiveRecord $record, $keys)
	{
		return $this->getCommand($record)->findAllByPk($keys);
	}

/**
	 * Returns record data matching the given critera. If $iterator is true, it will
	 * return multiple rows as TDbDataReader otherwise it returns the <b>first</b> row data.
	 * @param TActiveRecord $record active record finder instance.
	 * @param TActiveRecordCriteria $criteria search criteria.
	 * @param bool $iterator true to return multiple rows as iterator, false returns first row.
	 * @return mixed matching data.
	 */
	public function findRecordsByCriteria(TActiveRecord $record, $criteria, $iterator = false)
	{
		$command = $this->getCommand($record);
		return $iterator ? $command->findAll($criteria) : $command->find($criteria);
	}

/**
	 * Return record data from sql query.
	 * @param TActiveRecord $record active record finder instance.
	 * @param TActiveRecordCriteria $criteria sql query
	 * @return array result.
	 */
	public function findRecordBySql(TActiveRecord $record, $criteria)
	{
		return $this->getCommand($record)->findBySql($criteria);
	}

/**
	 * Return record data from sql query.
	 * @param TActiveRecord $record active record finder instance.
	 * @param TActiveRecordCriteria $criteria sql query
	 * @return \Prado\Data\TDbDataReader result iterator.
	 */
	public function findRecordsBySql(TActiveRecord $record, $criteria)
	{
		return $this->getCommand($record)->findAllBySql($criteria);
	}

public function findRecordsByIndex(TActiveRecord $record, $criteria, $fields, $values)
	{
		return $this->getCommand($record)->findAllByIndex($criteria, $fields, $values);
	}

/**
	 * Returns the number of records that match the given criteria.
	 * @param TActiveRecord $record active record finder instance.
	 * @param TActiveRecordCriteria $criteria search criteria
	 * @return int number of records.
	 */
	public function countRecords(TActiveRecord $record, $criteria)
	{
		return $this->getCommand($record)->count($criteria);
	}

/**
	 * Insert a new record.
	 * @param TActiveRecord $record new record.
	 * @return int number of rows affected.
	 */
	public function insert(TActiveRecord $record)
	{
		//$this->updateAssociatedRecords($record,true);
		$result = $this->getCommand($record)->insert($this->getInsertValues($record));
		if ($result) {
			$this->updatePostInsert($record);
		}
		//$this->updateAssociatedRecords($record);
		return $result;
	}

/**
	 * Sets the last insert ID to the corresponding property of the record if available.
	 * @param TActiveRecord $record record for insertion
	 */
	protected function updatePostInsert($record)
	{
		$command = $this->getCommand($record);
		$tableInfo = $command->getTableInfo();
		foreach ($tableInfo->getColumns() as $name => $column) {
			if ($column->hasSequence()) {
				$record->setColumnValue($name, $command->getLastInsertID());
			}
		}
	}

/**
	 * @param TActiveRecord $record
	 * @return array insert values.
	 */
	protected function getInsertValues(TActiveRecord $record)
	{
		$values = [];
		$tableInfo = $this->getCommand($record)->getTableInfo();
		foreach ($tableInfo->getColumns() as $name => $column) {
			if ($column->getIsExcluded()) {
				continue;
			}
			$value = $record->getColumnValue($name);
			if (!$column->getAllowNull() && $value === null && !$column->hasSequence() && ($column->getDefaultValue() === TDbTableColumn::UNDEFINED_VALUE)) {
				throw new TActiveRecordException(
					'ar_value_must_not_be_null',
					get_class($record),
					$tableInfo->getTableFullName(),
					$name
				);
			}
			if ($value !== null) {
				$values[$name] = $value;
			}
		}
		return $values;
	}

/**
	 * Update the record.
	 * @param TActiveRecord $record dirty record.
	 * @return int number of rows affected.
	 */
	public function update(TActiveRecord $record)
	{
		//$this->updateAssociatedRecords($record,true);
		[$data, $keys] = $this->getUpdateValues($record);
		$result = $this->getCommand($record)->updateByPk($data, $keys);
		//$this->updateAssociatedRecords($record);
		return $result;
	}

protected function getUpdateValues(TActiveRecord $record)
	{
		$values = [];
		$tableInfo = $this->getCommand($record)->getTableInfo();
		$primary = [];
		foreach ($tableInfo->getColumns() as $name => $column) {
			if ($column->getIsExcluded()) {
				continue;
			}
			$value = $record->getColumnValue($name);
			if (!$column->getAllowNull() && $value === null && ($column->getDefaultValue() === TDbTableColumn::UNDEFINED_VALUE)) {
				throw new TActiveRecordException(
					'ar_value_must_not_be_null',
					get_class($record),
					$tableInfo->getTableFullName(),
					$name
				);
			}
			if ($column->getIsPrimaryKey()) {
				$primary[$name] = $value;
			} else {
				$values[$name] = $value;
			}
		}
		return [$values, $primary];
	}

protected function updateAssociatedRecords(TActiveRecord $record, $updateBelongsTo = false)
	{
		$context = new TActiveRecordRelationContext($record);
		return $context->updateAssociatedRecords($updateBelongsTo);
	}

/**
	 * Delete the record.
	 * @param TActiveRecord $record record to be deleted.
	 * @return int number of rows affected.
	 */
	public function delete(TActiveRecord $record)
	{
		return $this->getCommand($record)->deleteByPk($this->getPrimaryKeyValues($record));
	}

protected function getPrimaryKeyValues(TActiveRecord $record)
	{
		$tableInfo = $this->getCommand($record)->getTableInfo();
		$primary = [];
		foreach ($tableInfo->getColumns() as $name => $column) {
			if ($column->getIsPrimaryKey()) {
				$primary[$name] = $record->getColumnValue($name);
			}
		}
		return $primary;
	}

/**
	 * Delete multiple records using primary keys.
	 * @param TActiveRecord $record finder instance.
	 * @param mixed $keys
	 * @return int number of rows deleted.
	 */
	public function deleteRecordsByPk(TActiveRecord $record, $keys)
	{
		return $this->getCommand($record)->deleteByPk($keys);
	}

/**
	 * Delete multiple records by criteria.
	 * @param TActiveRecord $record active record finder instance.
	 * @param TActiveRecordCriteria $criteria search criteria
	 * @return int number of records.
	 */
	public function deleteRecordsByCriteria(TActiveRecord $record, $criteria)
	{
		return $this->getCommand($record)->delete($criteria);
	}
}

${this.title}

Code Editor : TActiveRecordGateway.php