documentation/manual/es/module_specs/Zend_Controller-ActionHelpers-ActionStack.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2     <!-- EN-Revision: 16003 -->
   3     <!-- Reviewed: no -->
   4 <sect3 id="zend.controller.actionhelpers.actionstack">
   5     <title>ActionStack</title>
   6
   7     <para>
   8         El helper
   9         <emphasis>ActionStack</emphasis>
  10         le permite empujar
  11         requerimientos al
  12         <link linkend="zend.controller.plugins.standard.actionstack">ActionStack</link>
  13         plugin del front controller, el cual le ayuda
  14         efectivamente a crear una cola de acciones a
  15         ejecutar durante la
  16         solicitud. El helper le permite añadir actions ya sea mediante la
  17         especificación de los objetos o una
  18         nueva solicitud action - controller - module.
  19     </para>
  20
  21     <note>
  22         <title>Invocando al Ayudante ActionStack Inicializa el Plugin de
  23             ActionStack</title>
  24
  25         <para>
  26             Invocando al helper
  27             <emphasis>ActionStack</emphasis>
  28             implicitamente registra el plugin de
  29             <emphasis>ActionStack</emphasis>
  30             -- lo que significa que no
  31             necesita registrar explícitamente el plugin de
  32             <emphasis>ActionStack</emphasis>
  33             para utilizar esta
  34             funcionalidad.
  35         </para>
  36     </note>
  37
  38     <example id="zend.controller.actionhelpers.actionstack.simple">
  39         <title>Agregando una Tarea Usando Nombres de Acción, Controllador y
  40             Módulo</title>
  41
  42         <para>
  43             A menudo, es más sencillo simplemente especificar la acción, el
  44             controlador y el módulo
  45             (y parámetros opcionales de requerimientos),
  46             tal como cuando llama a
  47             <methodname>Zend_Controller_Action::_forward()</methodname>
  48             :
  49         </para>
  50
  51         <programlisting language="php"><![CDATA[
  52 class FooController extends Zend_Controller_Action
  53 {
  54     public function barAction()
  55     {
  56         // Agregar dos acciones a la pila (stack)
  57         // Y llamar a  /foo/baz/bar/baz
  58         // (FooController::bazAction() con el requrimiento var bar == baz)
  59         $this->_helper->actionStack('baz',
  60                                     'foo',
  61                                     'default',
  62                                     array('bar' => 'baz'));
  63
  64         // Agregar la llamada a /bar/bat
  65         // (BarController::batAction())
  66         $this->_helper->actionStack('bat', 'bar');
  67     }
  68 }
  69 ]]></programlisting>
  70
  71     </example>
  72
  73     <example id="zend.controller.actionhelpers.actionstack.simple2">
  74         <title>Agregando una Tarea al Objeto Solicitud (Request)</title>
  75
  76         <para>
  77             A veces la naturaleza
  78             <acronym>OOP</acronym>
  79             de un objeto
  80             solicitud tiene más sentido; puede pasar también tal objeto al
  81             ayudante
  82             <emphasis>ActionStack</emphasis>
  83             .
  84         </para>
  85
  86         <programlisting language="php"><![CDATA[
  87 class FooController extends Zend_Controller_Action
  88 {
  89     public function barAction()
  90     {
  91         // Agregar dos acciones al stack
  92         // Agregar la llamada a /foo/baz/bar/baz
  93         // (FooController::bazAction() with request var bar == baz)
  94         $request = clone $this->getRequest();
  95         // No establezca controlador o módulo; use los valores actuales
  96         $request->setActionName('baz')
  97                 ->setParams(array('bar' => 'baz'));
  98         $this->_helper->actionStack($request);
  99
 100         // Agregar la llamada a /bar/bat
 101         // (BarController::batAction())
 102         $request = clone $this->getRequest();
 103         // no establezca módulo; use el valor actual
 104         $request->setActionName('bat')
 105                 ->setControllerName('bar');
 106         $this->_helper->actionStack($request);
 107     }
 108 }
 109 ]]></programlisting>
 110     </example>
 111 </sect3>