Spec-Zone.ru › CakePHP 2.10

Класс ContainableBehavior

Поведение, позволяющее динамично и атомарно управлять ассоциациями модели, используемыми для вызова find. Наиболее полезно для ограничения количества ассоциаций и возвращаемых данных.

CakeObject
Extended by ModelBehavior
Extended by ContainableBehavior
Пакет: Cake\Model\Behavior
Ссылка: https://book.cakephp.org/2.0/ru/core-libraries/behaviors/containable.html
Авторские права: Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/Model/Behavior/ContainableBehavior.php

Краткое описание свойств

  • $runtime public
    array
    Конфигурация выполнения для данного поведения
  • $types public
    array
    Типы доступных для моделей отношений

Наследованные свойства

  • mapMethods, settings

Краткое описание методов

  • beforeFind() public

    Вызывается перед операцией find(). Используется для разрешения параметра 'contain' в вызове find, например:

  • contain() public

    Отменяет все отношения модели, кроме указанных. Вызов этой функции без параметров отменяет все связанные модели.

  • containments() public
    Обработка ограничений для модели.
  • containmentsMap() public
    Создание карты ограничений
  • fieldDependencies() public
    Вычисление необходимых полей для извлечения требуемых связей для данной модели.
  • resetBindings() public

    Постоянно восстанавливает исходные настройки связей данной модели, что полезно для восстановления связей после использования 'reset' => false в вызове contain.

  • setup() public
    Инициализация поведения для модели с использованием указанных настроек.

Подробное описание методов

beforeFind()source public

beforeFind( Model $Model , array $query )

Вызывается перед операцией find(). Используется для разрешения параметра 'contain' в вызове find, например:

Model->find('all', array('contain' => array('Model1', 'Model2')));

Model->find('all', array('contain' => array(
    'Model1' => array('Model11', 'Model12'),
    'Model2',
    'Model3' => array(
        'Model31' => 'Model311',
        'Model32',
        'Model33' => array('Model331', 'Model332')
)));

Параметры

Model $Model
Модель, использующая поведение
массив $query
Параметры запроса, заданные cake

Возвращаемое значение

массив

Переопределяет

ModelBehavior::beforeFind()

contain()source public

contain( Model $Model )

Отменяет все отношения модели, кроме указанных. Вызов этой функции без параметров отменяет все связанные модели.

Параметры

Model $Model
Модель, на которую накладывается ограничение связей

Ссылка

https://book.cakephp.org/2.0/ru/core-libraries/behaviors/containable.html#using-containable

containments()source public

containments( Model $Model , array $contain , array $containments array() , boolean $throwErrors null )

Обработка ограничений для модели.

Параметры

Model $Model
Модель, на которую накладывается ограничение связей
массив $contain
Параметры для ограничения этой модели
массив $containments optional array()
Текущий набор ограничений
логическое $throwErrors optional null
Показывать ли ошибки для несуществующих связей

Возвращаемое значение

массив
Ограничения

containmentsMap()source public

containmentsMap( array $containments )

Создание карты ограничений

Параметры

массив $containments
Ограничения

Возвращаемое значение

массив
Созданные ограничения

fieldDependencies()source public

fieldDependencies( Model $Model , array $map , array|boolean $fields array() )

Вычисление необходимых полей для извлечения требуемых связей для данной модели.

Параметры

Model $Model
Модель
массив $map
Карта отношений для данной модели
массив|логическое $fields optional array()
Если массив, поля для начальной загрузки, если false, использовать $Model в качестве основной модели

Возвращаемое значение

массив
Поля

resetBindings()source public

resetBindings( Model $Model )

Постоянно восстанавливает исходные настройки связей данной модели, что полезно для восстановления связей после использования 'reset' => false в вызове contain.

Параметры

Model $Model
Модель, для которой нужно сбросить связи

setup()source public

setup( Model $Model , array $settings array() )

Инициализация поведения для модели с использованием указанных настроек.

Доступные настройки:

  • recursive: (логическое, необязательно) установить в true, чтобы containable автоматически определял необходимый уровень рекурсии для извлечения указанных моделей и устанавливал уровень рекурсии модели на этот уровень. Установка в false отключает эту функцию. ПО УМОЛЧАНИЮ: true
  • notices: (логическое, необязательно) выводит E_NOTICES для связей, указанных в вызове containable, которые не являются допустимыми. ПО УМОЛЧАНИЮ: true
  • autoFields: (логическое, необязательно) автоматически добавляет необходимые поля для извлечения запрошенных связей. ПО УМОЛЧАНИЮ: true

Параметры

Model $Model
Модель, использующая поведение
массив $settings optional array()
Настройки для переопределения модели.

Переопределяет

ModelBehavior::setup()

Наследованные методы из ModelBehavior

_addToWhitelist()source protected

_addToWhitelist( Model $model , string $field )

Если свойство whitelist модели $model не пустое, $field будет добавлен в него. Примечание: этот метод следует использовать только в beforeValidate или beforeSave, чтобы гарантировать, что он изменяет whitelist только для текущей операции сохранения. Также убедитесь, что вы явно устанавливаете значение поля, которое вы разрешаете.

Параметры

Model $model
Модель, использующая это поведение
строка $field
Поле, которое необходимо добавить в whitelist модели $model

afterDelete()source public

afterDelete( Model $model )

Метод afterDelete вызывается после удаления прикреплённой модели.

Параметры

Model $model
Модель, использующая это поведение

afterFind()source public

afterFind( Model $model , mixed $results , boolean $primary false )

Обработчик после find. Может использоваться для изменения результатов, возвращаемых find.

Параметры

Model $model
Модель, использующая это поведение
смешанное $results
Результаты операции find
логическое $primary optional false
Является ли эта модель запрошенной напрямую (в отличие от запроса как ассоциации)

Возвращаемое значение

смешанное
Значение массива заменит значение $results – любое другое значение будет проигнорировано.
END_OF_DOCUMENT_MARKER

afterSave()source public

afterSave( Model $model , boolean $created , array $options array() )

Метод afterSave вызывается после сохранения модели.

Параметры

Model $model
Модель, использующая этот метод.
boolean $created
Истина, если это сохранение создало новую запись.
array $options опционально array()
Опции, переданные из Model::save().

Возвращает

boolean

См. также

Model::save()

afterValidate()source public

afterValidate( Model $model )

afterValidate вызывается сразу после валидации данных модели. Вы можете использовать этот обратный вызов для выполнения любых необходимых очисток или подготовки данных.

Параметры

Model $model
Модель, использующая этот метод.

Возвращает

mixed
False остановит распространение этого события другим методам.

beforeDelete()source public

beforeDelete( Model $model , boolean $cascade true )

beforeDelete вызывается перед любым удалением присоединенной модели, но после вызова beforeDelete модели. Возвращение false из beforeDelete прервет удаление.

Параметры

Model $model
Модель, использующая этот метод.
boolean $cascade опционально true
Если true, записи, зависящие от этой записи, также будут удалены.

Возвращает

mixed
False, если операция должна быть прервана. Любой другой результат будет продолжен.

beforeSave()source public

beforeSave( Model $model , array $options array() )

beforeSave вызывается перед сохранением модели. Возвращение false из beforeSave прервет операцию сохранения.

Параметры

Model $model
Модель, использующая этот метод.
array $options опционально array()
Опции, переданные из Model::save().

Возвращает

mixed
False, если операция должна быть прервана. Любой другой результат будет продолжен.

См. также

Model::save()

beforeValidate()source public

beforeValidate( Model $model , array $options array() )

beforeValidate вызывается перед валидацией модели. Вы можете использовать этот обратный вызов для добавления правил валидации в массив validate модели. Возвращение false позволит вам заставить валидацию завершиться неудачей.

Параметры

Model $model
Модель, использующая этот метод.
array $options опционально array()
Опции, переданные из Model::save().

Возвращает

mixed
False или null прервут операцию. Любой другой результат будет продолжен.

См. также

Model::save()

cleanup()source public

cleanup( Model $model )

Очистка любых инициализаций, выполненных этим методом для модели. Вызывается при динамической отвязке метода от модели с помощью Model::detach().

Параметры

Model $model
Модель, использующая этот метод.

См. также

BehaviorCollection::detach()

onError()source public

onError( Model $model , string $error )

Обработчик ошибок источника данных.

Параметры

Model $model
Модель, использующая этот метод.
string $error
Ошибка, сгенерированная в источнике данных.

Методы, унаследованные от CakeObject

__construct()source public

__construct( )

Конструктор, без действий.

_mergeVars()source protected

_mergeVars( array $properties , string $class , boolean $normalize true )

Объединяет свойство $property этого объекта со свойством в определении $class. Значение этого класса для свойства будет объединено поверх $class'.

Это обеспечивает некоторую магию DRY, предоставляемую CakePHP. Если вы хотите отключить ее, переопределите этот метод как пустую функцию.

Параметры

array $properties
Имя свойств для объединения.
string $class
Класс для объединения свойства с.
boolean $normalize опционально true
Установите в значение true, чтобы выполнить свойства через Hash::normalize() перед объединением.

_set()source protected

_set( array $properties array() )

Позволяет устанавливать несколько свойств объекта в одной строке кода. Будут установлены только свойства, которые являются частью объявления класса.

Параметры

array $properties опционально array()
Ассоциативный массив, содержащий свойства и соответствующие значения.

_stop()source protected

_stop( integer|string $status 0 )

Остановка выполнения текущего скрипта. Оборачивает exit(), что упрощает тестирование.

Параметры

integer|string $status опционально 0
см. http://php.net/exit для значений

dispatchMethod()source public

dispatchMethod( string $method , array $params array() )

Вызывает метод этого объекта с заданными параметрами. Предоставляет объектно-ориентированную оболочку для call_user_func_array.

Параметры

string $method
Имя вызываемого метода
array $params опционально array()
Список параметров для использования при вызове $method

Возвращает

mixed
Результат вызова метода

log()source public

log( string $msg , integer $type LOG_ERR , null|string|array $scope null )

Удобный метод для записи сообщения в CakeLog. См. CakeLog::write() для получения дополнительной информации о записи в журналы.

Параметры

string $msg
Сообщение журнала
integer $type опционально LOG_ERR
Константа типа ошибки. Определена в app/Config/core.php.
null|string|array $scope опционально null

Область(и), в которой создается сообщение журнала. См. CakeLog::config() для получения дополнительной информации о областях ведения журналов.

Возвращает

boolean
Успех записи в журнал

requestAction()source public

requestAction( string|array $url , array $extra array() )

Вызывает метод контроллера из любой точки. Может использоваться для соединения контроллеров или привязки плагинов к основному приложению. requestAction может использоваться для возврата отрендеренных представлений или получения возвращаемого значения действий контроллера.

Внутри этот метод использует Router::reverse() для преобразования параметра $url в строковый URL. Вы должны использовать форматы URL, совместимые с Router::reverse().

Передача данных POST и GET

Данные POST и GET могут быть смоделированы в requestAction. Используйте $extra['url'] для данных GET. Параметр $extra['data'] позволяет моделировать данные POST.

Параметры

string|array $url

Строка или массив-URL. В отличие от других массивов URL в CakePHP, этот URL не будет автоматически обрабатывать переданные и именованные аргументы в параметре $url.

array $extra опционально array()

Если массив включает ключ "return", он устанавливает AutoRender в значение true. Также может использоваться для отправки данных GET/POST и именованных/переданных аргументов.

Возвращает

mixed

Булево значение true или false при успехе/неудачи или содержимое отрендеренного действия, если в $extra установлен ключ 'return'.


toString()source public

toString( )

Преобразование CakeObject в строку. Каждый класс может переопределить этот метод по необходимости.

Возвращает

string
Имя этого класса

Подробное описание свойств

$runtimesource

public массив

Конфигурация выполнения для этого поведения

array()

$typessource

public массив

Типы отношений, доступные для моделей

array('belongsTo', 'hasOne', 'hasMany', 'hasAndBelongsToMany')

© 2005–2017 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/2.10/class-ContainableBehavior.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API