Spec-Zone.ru › CakePHP 2.10

Класс CakeEventManager

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

Пакет: Cake\Событие
Авторские права: Авторские права (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
Лицензия: Лицензия MIT
Расположение: Cake/Event/CakeEventManager.php

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

  • $_generalManager protected static
    CakeEventManager
    Глобально доступный экземпляр, используемый для отправки событий, прикрепленных из любого контекста
  • $_isGlobal protected
    boolean
    Внутренний флаг для различения общего менеджера и синглтона
  • $_listeners protected
    object
    Список обратных вызовов слушателей, связанных с
  • $defaultPriority public static
    integer
    Значение очереди приоритетов по умолчанию для новых прикрепленных слушателей

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

  • _attachSubscriber() protected

    Вспомогательная функция для прикрепления всех реализованных обратных вызовов экземпляра класса CakeEventListener как отдельных методов к этому менеджеру

  • _detachSubscriber() protected
    Вспомогательная функция для отключения всех слушателей, предоставляемых объектом, реализующим CakeEventListener
  • _extractCallable() protected

    Вспомогательная функция для извлечения и возврата типа обратного вызова PHP из определения обратного вызова из возвращаемого значения метода implementedEvents в CakeEventListener

  • attach() public
    Добавляет нового слушателя к событию. Слушатели
  • detach() public
    Удаляет слушателя из активных слушателей.
  • dispatch() public
    Отправляет новое событие всем настроенным слушателям
  • instance() public static

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

  • listeners() public
    Возвращает список всех слушателей для eventKey в порядке их вызова
  • prioritisedListeners() public
    Возвращает слушателей для указанного ключа события, индексированного по приоритету

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

_attachSubscriber()source protected

_attachSubscriber( CakeEventListener $subscriber )

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

Параметры

CakeEventListener $subscriber
Слушатель событий.

_detachSubscriber()source protected

_detachSubscriber( CakeEventListener $subscriber , string $eventKey null )

Вспомогательная функция для отключения всех слушателей, предоставляемых объектом, реализующим CakeEventListener

Параметры

CakeEventListener $subscriber
слушатель, который требуется отключить
строка $eventKey опционально null
необязательный ключ имени события, для отключения слушателя

_extractCallable()source protected

_extractCallable( array $function , CakeEventListener $object )

Вспомогательная функция для извлечения и возврата типа обратного вызова PHP из определения обратного вызова из возвращаемого значения метода implementedEvents в CakeEventListener

Параметры

массив $function
массив, взятый из определения обработчика события
CakeEventListener $object
объект-обработчик

Возвращает

callable

attach()source public

attach( callable|CakeEventListener $callable , string $eventKey null , array $options array() )

Добавляет нового слушателя к событию. Слушатели

Параметры

обратный вызов|CakeEventListener $callable

Действительный PHP обратный вызов или экземпляр CakeEventListener, который вызывается при срабатывании события с именем $eventKey. Если передан экземпляр CakeEventListener, то метод implementedEvents будет вызван в объекте для регистрации объявленных событий индивидуально в качестве методов, которые будет управлять этот класс. Можно определить несколько обработчиков событий на одно имя события.

строка $eventKey опционально null

Уникальное идентификационное имя события, с которым будет связан обратный вызов. Если $callable является экземпляром CakeEventListener, этот аргумент будет проигнорирован

массив $options опционально array()

используется для установки флагов priority и passParams для слушателя. Приоритеты обрабатываются как очереди, и несколько прикрепленных элементов в одной очереди приоритетов будут обрабатываться в порядке вставки. passParams означает, что свойство данных события будет преобразовано в аргументы функции при вызове слушателя. Если $called является экземпляром CakeEventListener, этот параметр будет проигнорирован

Исключения

InvalidArgumentException

Если ключ события отсутствует или обратный вызов не является экземпляром CakeEventListener.


detach()source public

detach( callable|CakeEventListener $callable , string $eventKey null )

Удаляет слушателя из активных слушателей.

Параметры

обратный вызов|CakeEventListener $callable
любой допустимый PHP обратный вызов или экземпляр CakeEventListener
строка $eventKey опционально null
Уникальное идентификационное имя события, с которым был связан обратный вызов

dispatch()source public

dispatch( string|CakeEvent $event )

Отправляет новое событие всем настроенным слушателям

Параметры

строка|CakeEvent $event
имя ключа события или экземпляр CakeEvent

Возвращает

CakeEvent

Срабатывает

$event

instance()source public static

instance( CakeEventManager $manager null )

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

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

Параметры

CakeEventManager $manager опционально null
Необязательный экземпляр менеджера событий.

Возвращает

CakeEventManager
Глобальный менеджер событий

listeners()source public

listeners( string $eventKey )

Возвращает список всех слушателей для eventKey в порядке их вызова

Параметры

строка $eventKey
Ключ события.

Возвращает

массив

prioritisedListeners()source public

prioritisedListeners( string $eventKey )

Возвращает слушателей для указанного ключа события, индексированного по приоритету

Параметры

строка $eventKey
Ключ события.

Возвращает

массив

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

$_generalManagersource

protected static CakeEventManager

Глобальный экземпляр, используемый для отправки событий, прикрепленных из любого контекста

null

$_isGlobalsource

protected boolean

Внутренний флаг для различения общего менеджера от синглтона

false

$_listenerssource

protected object

Список обработчиков событий, связанных с

array()

$defaultPrioritysource

public static integer

Значение очереди по приоритету по умолчанию для новых прикрепленных обработчиков

10

© 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-CakeEventManager.html

Spec-Zone.ru

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