IDataProvider

Package system.web
Inheritance interface IDataProvider
Subclasses CActiveDataProvider, CArrayDataProvider, CDataProvider, CSqlDataProvider
Since 1.1
Source Code framework/base/interfaces.php
IDataProvider is the interface that must be implemented by data provider classes.

Data providers are components that can feed data for widgets such as data grid, data list. Besides providing data, they also support pagination and sorting.

Public Methods

Method Description Defined By
getData() Returns the data items currently available. IDataProvider
getId() Returns the unique ID that identifies the data provider from other data providers. IDataProvider
getItemCount() Returns the number of data items in the current page. IDataProvider
getKeys() Returns the key values associated with the data items. IDataProvider
getPagination() Returns the pagination object. If this is false, it means the pagination is disabled. IDataProvider
getSort() Returns the sorting object. If this is false, it means the sorting is disabled. IDataProvider
getTotalItemCount() Returns the total number of data items. IDataProvider

Method Details

getData() method

abstract public array getData(boolean $refresh=false)
$refresh boolean whether the data should be re-fetched from persistent storage.
{return} array the list of data items currently available in this data provider.
Source Code: framework/base/interfaces.php#587 (show)
public function getData($refresh=false);

Returns the data items currently available.

getId() method

abstract public string getId()
{return} string the unique ID that identifies the data provider from other data providers.
Source Code: framework/base/interfaces.php#566 (show)
public function getId();

getItemCount() method

abstract public integer getItemCount(boolean $refresh=false)
$refresh boolean whether the number of data items should be re-calculated.
{return} integer the number of data items in the current page.
Source Code: framework/base/interfaces.php#574 (show)
public function getItemCount($refresh=false);

Returns the number of data items in the current page. This is equivalent to count($provider->getData()). When pagination is set false, this returns the same value as totalItemCount.

getKeys() method

abstract public array getKeys(boolean $refresh=false)
$refresh boolean whether the keys should be re-calculated.
{return} array the list of key values corresponding to data. Each data item in data is uniquely identified by the corresponding key value in this array.
Source Code: framework/base/interfaces.php#594 (show)
public function getKeys($refresh=false);

Returns the key values associated with the data items.

getPagination() method

abstract public CPagination getPagination()
{return} CPagination the pagination object. If this is false, it means the pagination is disabled.
Source Code: framework/base/interfaces.php#602 (show)
public function getPagination();

getSort() method

abstract public CSort getSort()
{return} CSort the sorting object. If this is false, it means the sorting is disabled.
Source Code: framework/base/interfaces.php#598 (show)
public function getSort();

getTotalItemCount() method

abstract public integer getTotalItemCount(boolean $refresh=false)
$refresh boolean whether the total number of data items should be re-calculated.
{return} integer total number of possible data items.
Source Code: framework/base/interfaces.php#581 (show)
public function getTotalItemCount($refresh=false);

Returns the total number of data items. When pagination is set false, this returns the same value as itemCount.

© 2008–2017 by Yii Software LLC
Licensed under the three clause BSD license.
http://www.yiiframework.com/doc/api/1.1/IDataProvider