2
16

Responder

  1. Object
    1. Responder

Une instance de Responder envoie automatiquement des messages de notification à une ou plusieurs instances. Des instances de Responder peuvent être liées afin que les notifications soient automatiquement transmises d'un répondeur à un autre.

MÉTHODES D'INSTANCE

  1. namespace Responder;
  2.  
  3. require_once 'So-o.php';
  4.  
  5. defclass('Responder', null, 1, null, array('nextResponders'), null, array('respondTo', 'nextResponders', 'setNextResponders', 'addNextResponder', 'removeNextResponder'));

La classe Responder hérite de la classe Object. La propriété d'instance nextResponders contient la liste des instances qui ont demandé à être notifiées lorsqu'un événement se produit. La classe Responder ajoute les messages d'instance respondTo, nextResponders, setNextResponders, addNextResponder et removeNextResponder.

nextResponders
SYNOPSIS

sendmsg($self, 'nextResponders')

DESCRIPTION

nextResponders retourne la liste des répondeurs de $self dans un tableau.

CODE
  1. function i_nextResponders($self) {
  2.     return sendmsg($self, 'get', 'nextResponders');
  3. }
setNextResponders
SYNOPSIS

sendmsg($self, 'setNextResponders', $responders)

DESCRIPTION

setNextResponders initialise la liste des répondeurs de $self à $responders. $responders est un tableau d'instances.

CODE
  1. function i_setNextResponders($self, $responders) {
  2.     return sendmsg($self, 'set', 'nextResponders', $responders);
  3. }
addNextResponder
SYNOPSIS

sendmsg($self, 'addNextResponder', $r)

DESCRIPTION

addNextResponder ajoute $r à la liste des répondeurs de $self.

CODE
  1. function i_addNextResponder($self, $r) {
  2.     $responders=sendmsg($self, 'get', 'nextResponders');
  3.  
  4.     if ($responders)  {
  5.         if (!in_array($r, $responders)) {
  6.             $responders[]=$r;
  7.             sendmsg($self, 'set', 'nextResponders', $responders);
  8.         }
  9.     }
  10.     else {
  11.         $responders=array($r);
  12.         sendmsg($self, 'set', 'nextResponders', $responders);
  13.     }
  14.  
  15.     return $self;
  16. }
removeNextResponder
SYNOPSIS

sendmsg($self, 'removeNextResponder', $r)

DESCRIPTION

removeNextResponder retire $r de la liste des répondeurs de $self.

CODE
  1. function i_removeNextResponder($self, $r) {
  2.     $responders=sendmsg($self, 'get', 'nextResponders');
  3.  
  4.     if ($responders) {
  5.         $i=array_search($r, $responders);
  6.  
  7.         if ($i !== false) {
  8.             unset($responders[$i]);
  9.             sendmsg($self, 'set', 'nextResponders', $responders);
  10.         }
  11.     }
  12.  
  13.     return $self;
  14. }
respondTo
SYNOPSIS

sendmsg($self, 'respondTo', $msg[, $arg ...])

DESCRIPTION

Si $self répond à $msg, respondTo envoie $msg et ses paramètres $arg à $self. Si $self ne répond pas à msg ou si l'exécution du message retourne false, respondTo transmet le message et ses paramètres à toutes les instances de la liste des répondeurs de $self.

CODE
  1. function i_respondTo($self, $msg) {
  2.     if (sendmsg($self, 'respondsTo', $msg) and sendmsg($self, 'perform', $msg, array_slice(func_get_args(), 2))) {
  3.         return $self;
  4.     }
  5.  
  6.     $responders=sendmsg($self, 'get', 'nextResponders');
  7.  
  8.     if ($responders) {
  9.         foreach ($responders as $r) {
  10.             sendmsg($r, 'perform', 'respondTo', array_slice(func_get_args(), 1));
  11.         }
  12.     }
  13.  
  14.     return $self;
  15. }
EXEMPLE

Une instance de Button notifie le message clicked quand elle reçoit le message click :

  1. namespace Button;
  2.  
  3. require_once 'So-o.php';
  4.  
  5. require_once 'Responder.php';
  6.  
  7. defclass('Button', $Responder, 1, null, null, null, array('click'));
  8.  
  9. function i_click($self) {
  10.     echo $self, ' click', PHP_EOL;
  11.  
  12.     sendmsg($self, 'respondTo', 'clicked', $self);
  13. }

click affiche un message de trace puis notifie le message clicked.

Une instance de Action répond à clicked :

  1. namespace Action;
  2.  
  3. require_once 'So-o.php';
  4.  
  5. require_once 'Responder.php';
  6.  
  7. defclass('Action', $Responder, 1, null, null, null, array('clicked'));
  8.  
  9. function i_clicked($self, $sender) {
  10.     echo $self . ' clicked from ', $sender, PHP_EOL;
  11.  
  12.     return false;
  13. }
$ php -a
php > require_once 'Button.php';
php > $btn1=sendmsg($Button, 'new');
php > sendmsg($btn1, 'click');
object(Button) click

Créez une instance de Action et ajoutez-la comme répondeur à l'instance de Button :

php > require_once 'Action.php';
php > $act1=sendmsg($Action, 'new');
php > sendmsg($btn1, 'addNextResponder', $act1);
php > sendmsg($btn1, 'click');
object(Button) click
object(Action) clicked from object(Button)

clicked est automatiquement envoyé par $btn1 à $act1.

Une instance de AnotherAction répond aussi à clicked :

  1. namespace AnotherAction;
  2.  
  3. require_once 'So-o.php';
  4.  
  5. require_once 'Responder.php';
  6.  
  7. defclass('AnotherAction', $Responder, 1, null, null, null, array('clicked'));
  8.  
  9. function i_clicked($self, $sender) {
  10.     echo $self . ' clicked from ', $sender, PHP_EOL;
  11.  
  12.     return true;
  13. }

Ajoutez une instance de AnotherAction comme répondeur à l'instance de Button :

php > require_once 'AnotherAction.php';
php > $act2=sendmsg($AnotherAction, 'new');
php > sendmsg($btn1, 'addNextResponder', $act2);
php > sendmsg($btn1, 'click');
object(Button) click
object(Action) clicked from object(Button)
object(AnotherAction) clicked from object(Button)

clicked est envoyé par $btn1 à $act1 puis à $act2.

Des répondeurs peuvent constituer une chaîne :

php > sendmsg($btn1, 'removeNextResponder', $act2);
php > sendmsg($btn1, 'click');
object(Button) click
object(Action) clicked from object(Button)

$btn1 n'a plus que $act1 comme répondeur. Ajoutez $act2 comme répondeur à $act1 :

php > sendmsg($act1, 'addNextResponder', $act2);
php > sendmsg($btn1, 'click');
object(Button) click
object(Action) clicked from object(Button)
object(AnotherAction) clicked from object(Button)

Dans cette configuration, clicked est envoyé au répondeur de $btn1 puis au répondeur de $act1.

Si un répondeur retourne true, la chaîne est rompue :

php > sendmsg($act1, 'removeNextResponder', $act2);
php > sendmsg($btn1, 'removeNextResponder', $act1);
php > sendmsg($btn1, 'click');
object(Button) click
php > sendmsg($btn1, 'addNextResponder', $act2);
php > sendmsg($act2, 'addNextResponder', $act1);
php > sendmsg($btn1, 'click');
object(Button) click
object(AnotherAction) clicked from object(Button)

clicked est envoyé par $btn1 à $act2 qui retourne true et bloque l'envoi du message à $act1.

Commentaires

Votre commentaire :
[p] [b] [i] [u] [s] [quote] [pre] [br] [code] [url] [email] strip aide 2000

Entrez un maximum de 2000 caractères.
Améliorez la présentation de votre texte avec les balises de formatage suivantes :
[p]paragraphe[/p], [b]gras[/b], [i]italique[/i], [u]souligné[/u], [s]barré[/s], [quote]citation[/quote], [pre]tel quel[/pre], [br]à la ligne,
[url]http://www.izend.org[/url], [url=http://www.izend.org]site[/url], [email]izend@izend.org[/email], [email=izend@izend.org]izend[/email],
[code]commande[/code], [code=langage]code source en c, java, php, html, javascript, xml, css, sql, bash, dos, make, etc.[/code].