Spec-Zone.ru › CakePHP 2.8

Класс BehaviorCollection

Класс коллекции поведения модели.

Определяет интерфейс Behavior и содержит общие функциональные возможности взаимодействия с моделью.

ObjectCollection
Extended by BehaviorCollection реализует CakeEventListener
Пакет: Cake\Модель
Авторские права: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/Model/BehaviorCollection.php

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

  • $_mappedMethods protected
    array
    Содержит список всех методов, которые были сопоставлены с регулярными выражениями
  • $_methods protected
    array
    Содержит список всех методов присоединённых поведений
  • $modelName public
    string
    Хранит ссылку на присоединённое имя

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

  • _enabled, _loaded, defaultPriority

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

  • attach() public
    Обратный совместимый псевдоним для load()
  • detach() public
    Обратный совместимый псевдоним для unload()
  • dispatchMethod() public
    Отправляет метод поведения. Вызовет либо обычные методы, либо сопоставленные методы.
  • hasMethod() public

    Проверяет, реализует ли поведение в этой коллекции предоставленный метод. Также проверит mappedMethods.

  • implementedEvents() public

    Возвращает реализованные события, которые будут перенаправлены в функцию trigger для отправки их отдельно для каждого поведения.

  • init() public
    Присоединяет объект модели и загружает список поведений
  • load() public

    Загружает поведение в коллекцию. Вы можете использовать $config['enabled'] = false для загрузки поведения с отключенными обратными вызовами. По умолчанию обратные вызовы включены. Отключенные поведения всё ещё могут использоваться как обычные.

  • methods() public

    Получает список методов присоединённых поведений, т.е. все публичные, не связанные с обратными вызовами методы. Это не включает mappedMethods.

  • unload() public
    Отсоединяет поведение от модели

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

attach()source public

attach( string $behavior , array $config array() )

Обратный совместимый псевдоним для load()

Устарело

3.0.0 Будет удалено в версии 3.0. Заменено на load().

Параметры

string $behavior
Имя поведения.
array $config необязательно array()
Параметры конфигурации.

detach()source public

detach( string $name )

Обратный совместимый псевдоним для unload()

Устарело

3.0.0 Будет удалено в версии 3.0. Используйте unload вместо него.

Параметры

string $name
Имя поведения

dispatchMethod()source public

dispatchMethod( Model $model , string $method , array $params array() , boolean $strict false )

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

Если метод не обрабатывается BehaviorCollection, а $strict ложно, то будет возвращено специальное значение array('unhandled') для сигнализации о том, что метод не найден.

Параметры

Model $model
Модель, на которой изначально был вызван метод.
string $method
Вызванный метод.
array $params необязательно array()
Параметры для вызываемого метода.
boolean $strict необязательно false
Если методы не найдены, сгенерировать ошибку.

Возвращает

array
Все методы для всех присоединённых поведений к этому объекту

hasMethod()source public

hasMethod( string $method , boolean $callback false )

Проверяет, реализует ли поведение в этой коллекции предоставленный метод. Также проверит mappedMethods.

Параметры

string $method
Искомый метод.
boolean $callback необязательно false
Возвратить обратный вызов для метода.

Возвращает

mixed

Если $callback ложно, то будет возвращён булевый результат, если истина, то массив с информацией об обратном вызове. Для сопоставленных методов массив будет содержать 3 элемента.


implementedEvents()source public

implementedEvents( )

Возвращает реализованные события, которые будут перенаправлены в функцию trigger для отправки их отдельно для каждого поведения.

Возвращает

array

Реализация

CakeEventListener::implementedEvents()

init()source public

init( string $modelName , array $behaviors array() )

Присоединяет объект модели и загружает список поведений

Параметры

string $modelName
Имя модели.
array $behaviors необязательно array()
Список поведений.

load()source public

load( string $behavior , array $config array() )

Загружает поведение в коллекцию. Вы можете использовать $config['enabled'] = false для загрузки поведения с отключенными обратными вызовами. По умолчанию обратные вызовы включены. Отключенные поведения всё ещё могут использоваться как обычные.

Вы можете использовать псевдоним своего поведения, как существующего поведения, установив ключ 'className', например:

public $actsAs = array(
  'Tree' => array(
    'className' => 'AliasedTree'
  );
);

Все вызовы для поведения Tree будут использовать AliasedTree вместо него.

Параметры

string $behavior
Имя поведения в формате CamelCase
array $config необязательно array()
Параметры конфигурации поведения

Возвращает

boolean
Успех - true, неудача - false

Исключение

MissingBehaviorException
если поведение не найдено.

methods()source public

methods( )

Получает список методов присоединённых поведений, т.е. все публичные, не связанные с обратными вызовами методы. Это не включает mappedMethods.

Возвращает

array
Все публичные методы для всех присоединённых к этой коллекции поведений

unload()source public

unload( string $name )

Отсоединяет поведение от модели

Параметры

string $name
Имя поведения в формате CamelCase

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

ObjectCollection::unload()

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

__get()source public

__get( string $name )

Предоставляет публичный доступ для чтения к загруженным объектам

Параметры

string $name
Имя свойства для чтения

Возвращает

mixed

__isset()source public

__isset( string $name )

Предоставляет доступ isset к _loaded

Параметры

string $name
Имя проверяемого объекта.

Возвращает

boolean
END_OF_DOCUMENT_MARKER

attached()source public

attached( string $name null )

Получает список присоединённых объектов или статус присоединённости заданного объекта.

Устаревшее

3.0.0 Будет удалено в версии 3.0. Используйте вместо этого loaded().

Параметры

строка $name необязательно null

Необязательно. Имя объекта, для которого нужно проверить статус присоединённости. Если опущен, возвращает массив текущих присоединённых объектов.

Возвращает

смешанный тип

Если $name указан, возвращает булево значение статуса соответствующего объекта. В противном случае возвращает массив всех присоединённых объектов.


disable()source public

disable( string|array $name )

Отключает обратные вызовы для объекта или массива объектов. Публичные методы объекта всё ещё могут вызываться как обычно.

Параметры

строка|массив $name
Имя объектов (с заглавными буквами в каждом слове) для отключения (строка или массив).

enable()source public

enable( string|array $name , boolean $prioritize true )

Включает обратные вызовы для объекта или массива объектов.

Параметры

строка|массив $name
Имя объекта(ов) (с заглавными буквами в каждом слове) для включения (строка или массив).
булево $prioritize необязательно true
Устанавливает приоритет списка включенных объектов после включения объекта(ов).

enabled()source public

enabled( string $name null )

Получает список текущих включенных объектов или текущий статус отдельного объекта.

Параметры

строка $name необязательно null

Необязательно. Имя объекта, для которого нужно проверить статус. Если опущен, возвращает массив текущих включенных объектов.

Возвращает

смешанный тип

Если $name указан, возвращает булево значение статуса соответствующего объекта. В противном случае возвращает массив всех включенных объектов.


loaded()source public

loaded( string $name null )

Получает список загруженных объектов или статус загрузки заданного объекта.

Параметры

строка $name необязательно null

Необязательно. Имя объекта, для которого нужно проверить статус. Если опущен, возвращает массив текущих загруженных объектов.

Возвращает

смешанный тип

Если $name указан, возвращает булево значение статуса соответствующего объекта. В противном случае возвращает массив всех загруженных объектов.


normalizeObjectArray()source public static

normalizeObjectArray( array $objects )

Нормализует массив объектов, создаёт массив, который упрощает ленивую загрузку.

Параметры

массив $objects
Массив дочерних объектов для нормализации.

Возвращает

массив
Массив нормализованных объектов.

prioritize()source public

prioritize( )

Устанавливает приоритет списка включенных объектов.

Возвращает

массив
Список объектов с приоритетом

set()source public

set( string $name null , Object $object null )

Добавляет или перезаписывает экземпляр объекта в коллекцию.

Параметры

строка $name необязательно null
Имя объекта.
Object $object необязательно null
Объект для использования.

Возвращает

массив
Загруженные объекты

setPriority()source public

setPriority( string|array $name , integer|null $priority null )

Устанавливает приоритет для объекта или массива объектов.

Параметры

строка|массив $name

Имя объекта(ов) (с заглавными буквами в каждом слове) для включения (строка или массив). Если строка, используется второй параметр $priority. В противном случае должен быть ассоциативный массив с именами объектов в качестве ключей и приоритетами в качестве значений.

целое число|null $priority необязательно null
Целое число для установки приоритета или null для значения по умолчанию.

trigger()source public

trigger( string|CakeEvent $callback , array $params array() , array $options array() )

Вызывает метод обратного вызова для каждого объекта в коллекции. Используется для вызова методов объектов в коллекции. Методы будут вызваны в порядке их присоединения.

Опции

  • breakOn Установите значение или значения, на которых вы хотите остановить распространение обратного вызова. Может быть скалярным значением или массивом значений для прерывания. По умолчанию false.

  • break Установите в true для включения прерывания. Когда триггер прерывается, возвращаемое значение последнего объекта будет возвращено. Если используется вместе с collectReturn, собранные результаты будут возвращены. По умолчанию false.

  • collectReturn Установите в true, чтобы собрать возвращаемое значение каждого объекта в массив. Этот массив возвращаемых значений будет возвращён вызовом trigger(). По умолчанию false.

  • modParams Позволяет каждому объекту изменять параметры для последующего объекта. Установка modParams в целочисленное значение позволит вам изменить параметр с этим индексом. Любое ненулевое значение будет изменять параметр с указанным индексом. По умолчанию false.

Параметры

строка|CakeEvent $callback

Метод, который нужно вызвать для всех объектов. Предполагается, что все объекты реализуют вызываемый метод. Если предоставлен экземпляр CakeEvent, тогда имя события будет обработано для получения имени обратного вызова. Это делается путем получения последнего слова после любого двоеточия в имени события (например, событие Model.afterSave вызовет обратный вызов afterSave).

массив $params необязательно array()
Массив параметров для вызванного обратного вызова.
массив $options необязательно array()
Массив опций.

Возвращает

смешанный тип
Либо последнее возвращаемое значение, либо все результаты, если collectReturn включен.

Исключения

CakeException
при использовании modParams с индексом, который не существует.

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

$_mappedMethodssource

protected массив

Хранит список всех методов, которые были сопоставлены с регулярными выражениями.

array()

$_methodssource

protected массив

Хранит список всех методов присоединённых поведений.

array()

$modelNamesource

public строка

Содержит ссылку на имя, к которому прикреплено поведение.

null

© 2005–2016 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.
http://api.cakephp.org/2.8/class-BehaviorCollection.html

Spec-Zone.ru

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