Объектные формы call_back вызовов
Пакет CORE представляет базовые средства для реализации паттерна OBSERVER. Примеры использования этих средств см. в пакете ACTIVE_RECORD (Регистрация слушателей на объекты) и в пакете WEB_APP (см. класс lmbFormCommand)
В реализации Observer различают 2 роли:
- Сервер (Observable), который генерит сообщения
- Слушатели или подписчики(Observer), которые подписываются на события сервера.
За реализацию этих средств отвечает класс lmbDelegate. Класс lmbDelegate - это по сути объектная форма вызова метода какого-либо объекта.
Пример использования класса lmbDelegate для подписки на события класса lmbActiveRecord
$callback = new lmbDelegate($this, 'clearCache'); lmbActiveRecord :: registerGlobalOnAfterSaveCallback($callback); lmbActiveRecord :: registerGlobalOnAfterDestroyCallback($callback);
Здесь мы подписались методом clearCache какого-го объекта на события on_after_save и on_after_destroy класса lmbActiveRecord.
lmbDelegate может принимать различные параметры в конструктор:
$callback1 = new lmbDelegate($this, 'someMethod'); // метод объекта $callback2 = new lmbDelegate('someGlobalFunction'); // глобальная функция $callback3 = new lmbDelegate(array($this, 'someMethod')); // callback в виде массива $callback3 = new lmbDelegate('MyClass', 'someStaticMethod'); // статический метод класса
Также есть метод lmbDelegate :: objectify($callback), который автоматически распознает, пришел ли ему объект класса lmbDeledate или же один из вариантов, которые можно передать в конструктор.
Подписка на сообщения - это еще не все: необходимо предусмотреть средства оповещения слушателей. Для этого в классе lmbDelegate есть методы:
- invoke() - вызывает call_user_func_array для данных, переданных в конструктор lmbDelegate, а в качестве параметров вызова - все, что были переданы в invoke.
- invokeArray($args = array()) - аналог invoke, только в качестве параметров вызова передаются $args.
- invokeAll($list, $args = array()) - статический метод. Вызывает invokeArray для всех объектов в списке $list
- invokeChain($list, $args = array()) - статический метод. Вызывает invokeArray для всех объектов в списке $list, однако в отличие от invokeAll цепочка прерывается, как только хоть один из callback-ов ворачивает не-NULL значение
Например:
if(count($this->_listeners)) lmbDelegate :: invokeAll($this->_listeners, array($this));
Здесь для каждого случашате из $this→_listeners будет вызван соответствующий callback и в качестве параметра будет передан сам оповещающий объект ($this).

Обсуждение