Class \Prado\Util\TCallChain

TCallChain is a recursive event calling mechanism. This class implements the {@see \Prado\Util\IDynamicMethods} class so that any 'dy' event calls can be caught and patched through to the intended recipient

Class hierarchy

\Prado\Util\TCallChain implements IDynamicMethods

\Prado\Collections\TList implements IteratorAggregate, ArrayAccess, Countable

\Prado\TComponent

Author: Brad Anderson <javalizard@gmail.com>
Since: 3.2.3

Methods summary
`public`	`__construct(string $method) : mixed` This initializes the list and the name of the method to be called
`public`	`__dycall(string $method, array<string\|int, mixed> $args) : mixed` This catches all the unpatched dynamic events. When the method call matches the call chain method, it passes the arguments to the original __call (of the dynamic event being unspecified in TCallChain) and funnels into the method {@see call}, so the next dynamic event handler can be called. If the original method call has these parameters `$originalobject->dyExampleMethod('param1', 'param2', 'param3')` and within the chained dynamic events, this can be called `class DyBehavior extends TBehavior { public function dyExampleMethod($param1, $param2, $param3, $callchain) $callchain->dyExampleMethod($param1, $param2, $param3) } }` to call the next event in the chain.
`public`	`addCall(array<string\|int, mixed>\|string $method, array<string\|int, mixed> $args) : mixed` This initializes the list and the name of the method to be called
`public`	`call(array<string\|int, mixed> ...$args) : mixed` This method calls the next Callable in the list. All of the method arguments coming into this method are substituted into the original method argument of call in the chain. If the original method call has these parameters `$originalobject->dyExampleMethod('param1', 'param2', 'param3')` `$callchain->dyExampleMethod('alt1', 'alt2')` then the next call in the call chain will recieve the parameters as if this were called `$behavior->dyExampleMethod('alt1', 'alt2', 'param3', $callchainobject)` When dealing with IClassBehaviors, the first parameter of the stored argument list in 'dy' event calls is always the object containing the behavior. This modifies the parameter replacement mechanism slightly to leave the object containing the behavior alone and only replacing the other parameters in the argument list. As per __call, any calls to a 'dy' event do not need the object containing the behavior as the addition of the object to the argument list as the first element is automatic for IClassBehaviors. The last parameter of the method parameter list for any callable in the call chain will be the TCallChain object itself. This is so that any behavior implementing these calls will have access to the call chain. Each callable should either call the TCallChain call method internally for direct chaining or call the method being chained (in which case the dynamic handler will pass through to this call method). If the dynamic intra object/behavior event is not called in the behavior implemented dynamic method, it will return to this method and call the following behavior implementation so as no behavior with an implementation of the dynamic event is left uncalled. This does break the call chain though and will not act as a "parameter filter". When there are no handlers or no handlers left, it returns the first parameter of the argument list.

Inherited methods
__call, __callStatic, __clone, __construct, __destruct, __get, __isset, __set, __sleep, __unset, __wakeup, add, addParsedObject, asa, attachBehavior, attachBehaviors, attachClassBehavior, attachEventHandler, callBehaviorsMethod, canGetProperty, canSetProperty, clear, clearBehaviors, contains, copyFrom, count, createdOnTemplate, detachBehavior, detachBehaviors, detachClassBehavior, detachEventHandler, disableBehavior, disableBehaviors, enableBehavior, enableBehaviors, evaluateExpression, evaluateStatements, fxAttachClassBehavior, fxDetachClassBehavior, getAutoGlobalListen, getBehaviors, getBehaviorsEnabled, getClassHierarchy, getCount, getEventHandlers, getIterator, getListeningToGlobalEvents, getReadOnly, getSubProperty, hasEvent, hasEventHandler, hasMethod, hasProperty, indexOf, insertAfter, insertAt, insertBefore, isa, itemAt, listen, mergeWith, offsetExists, offsetGet, offsetSet, offsetUnset, raiseEvent, remove, removeAt, setReadOnly, setSubProperty, toArray, unlisten, _getZappableSleepProps, collapseReadOnly, getCallChain, getClassFxEvents, instanceBehavior, filter_prado_fx

Inherited constants
`\Prado\TComponent::GLOBAL_RAISE_EVENT_LISTENER`

Classes

Interfaces

Traits

Search results

Class \Prado\Util\TCallChain

Class hierarchy