Абстрактный класс yii\data\BaseDataProvider
| Наследование | yii\data\BaseDataProvider » yii\base\Component » yii\base\Object |
|---|---|
| Реализует | yii\base\Configurable, yii\data\DataProviderInterface |
| Подклассы | yii\data\ActiveDataProvider, yii\data\ArrayDataProvider, yii\data\SqlDataProvider, yii\debug\models\timeline\DataProvider, yii\elasticsearch\ActiveDataProvider, yii\sphinx\ActiveDataProvider |
| Доступен начиная с версии | 2.0 |
| Исходный код | https://github.com/yiisoft/yii2/blob/master/framework/data/BaseDataProvider.php |
BaseDataProvider предоставляет базовый класс, реализующий интерфейс yii\data\DataProviderInterface.
Для получения более подробной информации и руководства по использованию BaseDataProvider, обратитесь к статье руководства о поставщиках данных.
Общедоступные свойства
| Свойство | Тип | Описание | Определено в |
|---|---|---|---|
| $behaviors | yii\base\Behavior[] | Список присоединённых к данному компоненту поведений | yii\base\Component |
| $count | целое число | Количество моделей данных на текущей странице. | yii\data\BaseDataProvider |
| $id | строка | Идентификатор, уникально определяющий поставщика данных среди всех поставщиков данных. | yii\data\BaseDataProvider |
| $keys | массив | Список значений ключей, соответствующих $models. | yii\data\BaseDataProvider |
| $models | массив | Список моделей данных на текущей странице. | yii\data\BaseDataProvider |
| $pagination | yii\data\Pagination|логическое значение | Объект постраничной навигации. | yii\data\BaseDataProvider |
| $sort | yii\data\Sort|логическое значение | Объект сортировки. | yii\data\BaseDataProvider |
| $totalCount | целое число | Общее количество возможных моделей данных. | yii\data\BaseDataProvider |
Общедоступные методы
| Метод | Описание | Определено в |
|---|---|---|
| __call() | Вызывает метод с указанным именем, который не является методом класса. | yii\base\Object |
| __clone() | Этот метод вызывается после создания объекта путем клонирования существующего. | yii\base\Component |
| __construct() | Конструктор. | yii\base\Object |
| __get() | Возвращает значение свойства объекта. | yii\base\Object |
| __isset() | Проверяет, установлено ли свойство, т.е. определено и не равно null. | yii\base\Object |
| __set() | Устанавливает значение свойства объекта. | yii\base\Object |
| __unset() | Устанавливает свойство объекта в значение null. | yii\base\Object |
| attachBehavior() | Присоединяет поведение к данному компоненту. | yii\base\Component |
| attachBehaviors() | Присоединяет список поведений к компоненту. | yii\base\Component |
| behaviors() | Возвращает список поведений, по которым должен вести себя этот компонент. | yii\base\Component |
| canGetProperty() | Возвращает значение, указывающее, можно ли прочитать свойство. | yii\base\Object |
| canSetProperty() | Возвращает значение, указывающее, можно ли установить свойство. | yii\base\Object |
| className() | Возвращает полное имя класса. | yii\base\Object |
| detachBehavior() | Отсоединяет поведение от компонента. | yii\base\Component |
| detachBehaviors() | Отсоединяет все поведения от компонента. | yii\base\Component |
| ensureBehaviors() | Убеждается, что поведения, объявленные в behaviors(), присоединены к этому компоненту. | yii\base\Component |
| getBehavior() | Возвращает объект поведения с заданным именем. | yii\base\Component |
| getBehaviors() | Возвращает все присоединенные к этому компоненту поведения. | yii\base\Component |
| getCount() | Возвращает количество моделей данных на текущей странице. | yii\data\BaseDataProvider |
| getKeys() | Возвращает значения ключей, связанные с моделями данных. | yii\data\BaseDataProvider |
| getModels() | Возвращает модели данных на текущей странице. | yii\data\BaseDataProvider |
| getPagination() | Возвращает объект постраничной навигации, используемый этим поставщиком данных. | yii\data\BaseDataProvider |
| getSort() | Возвращает объект сортировки, используемый этим поставщиком данных. | yii\data\BaseDataProvider |
| getTotalCount() | Возвращает общее количество моделей данных. | yii\data\BaseDataProvider |
| hasEventHandlers() | Возвращает значение, указывающее, есть ли какой-либо обработчик, присоединённый к указанному событию. | yii\base\Component |
| hasMethod() | Возвращает значение, указывающее, определён ли метод. | yii\base\Object |
| hasProperty() | Возвращает значение, указывающее, определено ли свойство. | yii\base\Object |
| init() | Инициализирует объект. | yii\data\BaseDataProvider |
| off() | Отсоединяет существующий обработчик событий от данного компонента. | yii\base\Component |
| on() | Присоединяет обработчик событий к событию. | yii\base\Component |
| prepare() | Подготавливает модели данных и ключи. | yii\data\BaseDataProvider |
| refresh() | Обновляет поставщик данных. | yii\data\BaseDataProvider |
| setKeys() | Устанавливает значения ключей, связанные с моделями данных. | yii\data\BaseDataProvider |
| setModels() | Устанавливает модели данных на текущей странице. | yii\data\BaseDataProvider |
| setPagination() | Устанавливает постраничную навигацию для этого поставщика данных. | yii\data\BaseDataProvider |
| setSort() | Устанавливает определение сортировки для этого поставщика данных. | yii\data\BaseDataProvider |
| setTotalCount() | Устанавливает общее количество моделей данных. | yii\data\BaseDataProvider |
| trigger() | Вызывает событие. | yii\base\Component |
Защищенные методы
| Метод | Описание | Определено в |
|---|---|---|
| prepareKeys() | Подготавливает ключи, связанные с доступными в настоящее время моделями данных. | yii\data\BaseDataProvider |
| prepareModels() | Подготавливает модели данных, которые будут доступны на текущей странице. | yii\data\BaseDataProvider |
| prepareTotalCount() | Возвращает значение, указывающее общее количество моделей данных в этом поставщике данных. | yii\data\BaseDataProvider |
Подробное описание свойств
$count общедоступное только для чтения свойство
Количество моделей данных на текущей странице.
public integer getCount ( )
$id общедоступное свойство
Идентификатор, уникально определяющий поставщик данных среди всех поставщиков данных. Генерируется автоматически следующим образом, если не задан:
- Идентификатор первого поставщика данных пуст.
- Идентификаторы второго и всех последующих поставщиков данных: "dp-1", "dp-2" и т.д.
public string $id = null
$keys общедоступное свойство
Список значений ключей, соответствующих $models. Каждая модель данных в $models уникально идентифицируется соответствующим значением ключа в этом массиве.
public array getKeys ( )
public void setKeys ( $keys )
$models общедоступное свойство
Список моделей данных на текущей странице.
public array getModels ( )
public void setModels ( $models )
$pagination общедоступное свойство
Объект постраничной навигации. Если это false, это означает, что постраничная навигация отключена.
public yii\data\Pagination|false getPagination ( )
public void setPagination ( $value )
$sort общедоступное свойство
Объект сортировки. Если это false, это означает, что сортировка отключена.
public yii\data\Sort|boolean getSort ( )
public void setSort ( $value )
$totalCount общедоступное свойство
Общее количество возможных моделей данных.
public integer getTotalCount ( )
public void setTotalCount ( $value )
Подробное описание методов
getCount() public method
Возвращает количество моделей данных на текущей странице.
| public integer getCount ( ) | ||
|---|---|---|
| return | integer |
Количество моделей данных на текущей странице. |
getKeys() public method
Возвращает значения ключей, связанные с моделями данных.
| public array getKeys ( ) | ||
|---|---|---|
| return | array |
Список значений ключей, соответствующих $models. Каждая модель данных в $models однозначно идентифицируется соответствующим значением ключа в этом массиве. |
getModels() public method
Возвращает модели данных на текущей странице.
| public array getModels ( ) | ||
|---|---|---|
| return | array |
Список моделей данных на текущей странице. |
getPagination() public method
Возвращает объект пагинации, используемый этим поставщиком данных.
Обратите внимание, что вам следует сначала вызвать prepare() или getModels(), чтобы получить правильные значения yii\data\Pagination::$totalCount и yii\data\Pagination::$pageCount.
| public yii\data\Pagination|false getPagination ( ) | ||
|---|---|---|
| return | yii\data\Pagination|false |
Объект пагинации. Если это false, это означает, что пагинация отключена. |
getSort() public method
Возвращает объект сортировки, используемый этим поставщиком данных.
| public yii\data\Sort|boolean getSort ( ) | ||
|---|---|---|
| return | yii\data\Sort|boolean |
Объект сортировки. Если это false, это означает, что сортировка отключена. |
getTotalCount() public method
Возвращает общее количество моделей данных.
Когда $pagination ложно, это возвращает то же значение, что и $count. В противном случае вызовется prepareTotalCount(), чтобы получить счет.
| public integer getTotalCount ( ) | ||
|---|---|---|
| return | integer |
Общее количество возможных моделей данных. |
init() public method
Инициализирует объект.
Этот метод вызывается в конце конструктора после инициализации объекта заданной конфигурацией.
| public void init ( ) |
|---|
prepare() public method
Подготавливает модели данных и ключи.
Этот метод подготовит модели данных и ключи, которые можно получить с помощью getModels() и getKeys().
Этот метод будет неявно вызван getModels() и getKeys(), если он еще не был вызван ранее.
| public void prepare ( $forcePrepare = false ) | ||
|---|---|---|
| $forcePrepare | boolean |
Требуется ли принудительная подготовка данных, даже если она уже была выполнена ранее. |
prepareKeys() protected abstract method
Подготавливает ключи, связанные с текущими доступными моделями данных.
| protected abstract array prepareKeys ( $models ) | ||
|---|---|---|
| $models | array |
Доступные модели данных |
| return | array |
Ключи |
prepareModels() protected abstract method
Подготавливает модели данных, которые будут доступны на текущей странице.
| protected abstract array prepareModels ( ) | ||
|---|---|---|
| return | array |
Доступные модели данных |
prepareTotalCount() protected abstract method
Возвращает значение, указывающее общее количество моделей данных в этом поставщике данных.
| protected abstract integer prepareTotalCount ( ) | ||
|---|---|---|
| return | integer |
Общее количество моделей данных в этом поставщике данных. |
refresh() public method
Обновляет поставщик данных.
После вызова этого метода, если getModels(), getKeys() или getTotalCount() вызываются снова, они повторно выполнят запрос и вернут последние доступные данные.
| public void refresh ( ) |
|---|
setKeys() public method
Устанавливает значения ключей, связанные с моделями данных.
| public void setKeys ( $keys ) | ||
|---|---|---|
| $keys | array |
Список значений ключей, соответствующих $models. |
setModels() public method
Устанавливает модели данных на текущей странице.
| public void setModels ( $models ) | ||
|---|---|---|
| $models | array |
Модели на текущей странице |
setPagination() public method
Устанавливает пагинацию для этого поставщика данных.
| public void setPagination ( $value ) | ||
|---|---|---|
| $value | array|yii\data\Pagination|boolean |
Пагинация, которая должна использоваться этим поставщиком данных. Это может быть одно из следующих:
|
| throws | yii\base\InvalidParamException | |
setSort() public method
Устанавливает определение сортировки для этого поставщика данных.
| public void setSort ( $value ) | ||
|---|---|---|
| $value | array|yii\data\Sort|boolean |
Определение сортировки, которое должно использоваться этим поставщиком данных. Это может быть одно из следующих:
|
| throws | yii\base\InvalidParamException | |
setTotalCount() public method
Устанавливает общее количество моделей данных.
| public void setTotalCount ( $value ) | ||
|---|---|---|
| $value | integer |
Общее количество моделей данных. |
© 2008–2017 by Yii Software LLC
Licensed under the three clause BSD license.
http://www.yiiframework.com/doc-2.0/yii-data-basedataprovider.html