repo_zf1/documentation/manual/ja/module_specs/Zend_Controller-Plugins-ActionStack.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 16705 -->
<sect3 id="zend.controller.plugins.standard.actionstack">
    <title>ActionStack</title>

    <para>
        <emphasis>ActionStack</emphasis> プラグインは、リクエストをスタックで管理します。
        <emphasis>postDispatch</emphasis> プラグインとして動作します。
        現在のリクエストオブジェクトで既に転送先が指定されている
        (別のアクションがコールされている) 場合は、何も行いません。
        転送されていない場合はスタックの最上位の要素を取り出し、
        そのリクエストが指すアクションに転送します。
        スタックの処理は <acronym>LIFO</acronym> (後入れ先出し) 方式で行います。
    </para>

    <para>
        このプラグインをフロントコントローラから取得するには、
        <methodname>Zend_Controller_Front::getPlugin('Zend_Controller_Plugin_ActionStack')</methodname>
        とします。プラグインオブジェクトを取得したら、
        さまざまな仕組みを利用できるようになります。
    </para>

    <itemizedlist>
        <listitem><para>
                <methodname>getRegistry()</methodname> および <methodname>setRegistry()</methodname>。
                <emphasis>ActionStack</emphasis> は、内部的に
                <classname>Zend_Registry</classname> のインスタンスを使ってスタックを管理しています。
                別のレジストリインスタンスでこれを置き換えたり、
                インスタンスを取得したりする際にこれらのアクセサを使用します。
        </para></listitem>

        <listitem><para>
                <methodname>getRegistryKey()</methodname> および <methodname>setRegistryKey()</methodname>。
                これらは、スタックに格納する際にレジストリのどのキーを使用するかを指定します。
                デフォルト値は '<classname>Zend_Controller_Plugin_ActionStack</classname>' です。
        </para></listitem>

        <listitem><para>
                <methodname>getStack()</methodname> は、
                そのアクションのスタック全体を取得します。
        </para></listitem>

        <listitem><para>
                <methodname>pushStack()</methodname> および <methodname>popStack()</methodname>
                は、それぞれスタックへの追加とスタックからの取り出しを行います。
                <methodname>pushStack()</methodname> にはリクエストオブジェクトを渡します。
        </para></listitem>
    </itemizedlist>

    <para>
        さらに <methodname>forward()</methodname> メソッドが存在します。
        このメソッドにはリクエストオブジェクトを渡し、
        フロントコントローラにおける現在のリクエストオブジェクトの状態を
        ここで渡したオブジェクトの状態に設定します。
        そして、リクエストを未ディスパッチ状態に戻します
        (ディスパッチループの次の処理に強制的に進ませます)。
    </para>
</sect3>
<!--
vim:se ts=4 sw=4 et:
-->