* Prado 3.3.0

1 files changed, 202 insertions, 0 deletions

diff --git a/lib/prado/framework/Web/UI/WebControls/TDataSourceView.php b/lib/prado/framework/Web/UI/WebControls/TDataSourceView.php
new file mode 100644
index 0000000..ed6d868
--- /dev/null
+++ b/lib/prado/framework/Web/UI/WebControls/TDataSourceView.php
@@ -0,0 +1,202 @@
+<?php
+/**
+ * TDataSourceSelectParameters, TDataSourceView, TReadOnlyDataSourceView class file
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link https://github.com/pradosoft/prado
+ * @copyright Copyright &copy; 2005-2015 The PRADO Group
+ * @license https://github.com/pradosoft/prado/blob/master/COPYRIGHT
+ * @package System.Web.UI.WebControls
+ */
+
+/**
+ * TDataSourceSelectParameters class
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @package System.Web.UI.WebControls
+ * @since 3.0
+ */
+class TDataSourceSelectParameters extends TComponent
+{
+	private $_retrieveTotalRowCount=false;
+	private $_startRowIndex=0;
+	private $_totalRowCount=0;
+	private $_maximumRows=0;
+
+	public function getStartRowIndex()
+	{
+		return $this->_startRowIndex;
+	}
+
+	public function setStartRowIndex($value)
+	{
+		if(($value=TPropertyValue::ensureInteger($value))<0)
+			$value=0;
+		$this->_startRowIndex=$value;
+	}
+
+	public function getMaximumRows()
+	{
+		return $this->_maximumRows;
+	}
+
+	public function setMaximumRows($value)
+	{
+		if(($value=TPropertyValue::ensureInteger($value))<0)
+			$value=0;
+		$this->_maximumRows=$value;
+	}
+
+	public function getRetrieveTotalRowCount()
+	{
+		return $this->_retrieveTotalRowCount;
+	}
+
+	public function setRetrieveTotalRowCount($value)
+	{
+		$this->_retrieveTotalRowCount=TPropertyValue::ensureBoolean($value);
+	}
+
+	public function getTotalRowCount()
+	{
+		return $this->_totalRowCount;
+	}
+
+	public function setTotalRowCount($value)
+	{
+		if(($value=TPropertyValue::ensureInteger($value))<0)
+			$value=0;
+		$this->_totalRowCount=$value;
+	}
+}
+
+/**
+ * TDataSourceView class
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @package System.Web.UI.WebControls
+ * @since 3.0
+ */
+abstract class TDataSourceView extends TComponent
+{
+	private $_owner;
+	private $_name;
+
+	public function __construct(IDataSource $owner,$viewName)
+	{
+		$this->_owner=$owner;
+		$this->_name=$viewName;
+	}
+
+	/**
+	 * Performs DB selection based on specified parameters.
+	 * @param ???
+	 * @return Traversable
+	 */
+	abstract public function select($parameters);
+
+	/**
+	 * Inserts a DB record.
+	 * @param array|TMap
+	 * @return integer affected rows
+	 */
+	public function insertAt($values)
+	{
+		throw new TNotSupportedException('datasourceview_insert_unsupported');
+	}
+
+	/**
+	 * Updates DB record(s) with the specified keys and new values
+	 * @param array|TMap keys for specifying the records to be updated
+	 * @param array|TMap new values
+	 * @return integer affected rows
+	 */
+	public function update($keys,$values)
+	{
+		throw new TNotSupportedException('datasourceview_update_unsupported');
+	}
+
+	/**
+	 * Deletes DB row(s) with the specified keys.
+	 * @param array|TMap keys for specifying the rows to be deleted
+	 * @return integer affected rows
+	 */
+	public function delete($keys)
+	{
+		throw new TNotSupportedException('datasourceview_delete_unsupported');
+	}
+
+	public function getCanDelete()
+	{
+		return false;
+	}
+
+	public function getCanInsert()
+	{
+		return false;
+	}
+
+	public function getCanPage()
+	{
+		return false;
+	}
+
+	public function getCanGetRowCount()
+	{
+		return false;
+	}
+
+	public function getCanSort()
+	{
+		return false;
+	}
+
+	public function getCanUpdate()
+	{
+		return false;
+	}
+
+	public function getName()
+	{
+		return $this->_name;
+	}
+
+	public function getDataSource()
+	{
+		return $this->_owner;
+	}
+
+	public function onDataSourceViewChanged($param)
+	{
+		$this->raiseEvent('OnDataSourceViewChanged',$this,$param);
+	}
+}
+
+/**
+ * TReadOnlyDataSourceView class
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @package System.Web.UI.WebControls
+ * @since 3.0
+ */
+class TReadOnlyDataSourceView extends TDataSourceView
+{
+	private $_dataSource=null;
+
+	public function __construct(IDataSource $owner,$viewName,$dataSource)
+	{
+		parent::__construct($owner,$viewName);
+		if($dataSource===null || is_array($dataSource))
+			$this->_dataSource=new TMap($dataSource);
+		else if($dataSource instanceof Traversable)
+			$this->_dataSource=$dataSource;
+		else
+			throw new TInvalidDataTypeException('readonlydatasourceview_datasource_invalid');
+	}
+
+	public function select($parameters)
+	{
+		return $this->_dataSource;
+	}
+}
+