Yii Framework 开发教程(28) Data Provider 简介

这开始介绍Zii组件之前，先简要介绍一下Yii支持的数据源接口 IDataProvider，IDataProvider主要功能是为UI组件如GridView，ListView等提供数据源，同时也支持数据的分页和排序。下图为Yii内置的三种数据源：

• CActiveDataProvider 基于Active Record的数据源
• CArraryDataProvider 基于数组的数据源
• CSqlDataProvider 基于SQL查询的数据源

三种Data Provider的使用大同小异：

CActiveDataProvider 基于ActiveRecord, 它通过AR的CActiveRecord::findAll方法读取数据库记录，并通过criteria属性设置查询条件。

如：

$dataProvider=new CActiveDataProvider('Post', array(
    'criteria'=>array(
        'condition'=>'status=1',
        'order'=>'create_time DESC',
        'with'=>array('author'),
    ),
    'pagination'=>array(
        'pageSize'=>20,
    ),
));
// $dataProvider->getData() will return a list of Post objects

CArrayDataProvider 基于数组，其中属性 rawData 设置原始数据，一般为数组或者DAO查询结果，如：

$rawData=Yii::app()->db->createCommand('SELECT * FROM tbl_user')->queryAll();
// or using: $rawData=User::model()->findAll();
$dataProvider=new CArrayDataProvider($rawData, array(
    'id'=>'user',
    'sort'=>array(
        'attributes'=>array(
             'id', 'username', 'email',
        ),
    ),
    'pagination'=>array(
        'pageSize'=>10,
    ),
));
// $dataProvider->getData() will return a list of arrays.

CSqlDataProvider 基于SQL查询，通过设置 sql 语句来配置，比如：

$count=Yii::app()->db->createCommand('SELECT COUNT(*) FROM tbl_user')->queryScalar();
$sql='SELECT * FROM tbl_user';
$dataProvider=new CSqlDataProvider($sql, array(
    'totalItemCount'=>$count,
    'sort'=>array(
        'attributes'=>array(
             'id', 'username', 'email',
        ),
    ),
    'pagination'=>array(
        'pageSize'=>10,
    ),
));
// $dataProvider->getData() will return a list of arrays.

关于DataProvider详细文档可以参见 Yii文档