repo_zf1/documentation/manual/ja/module_specs/Zend_Json-Server.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 19477 -->
<sect1 id="zend.json.server">
    <title>Zend_Json_Server - JSON-RPCサーバー</title>

    <para>
        <classname>Zend_Json_Server</classname>は<ulink
            url="http://groups.google.com/group/json-rpc/">JSON-RPC</ulink>
        サーバー実装です。それは
        <ulink url="http://groups.google.com/group/json-rpc/web/json-rpc-1-2-proposal">バージョン 2 仕様</ulink>
        と同様に
        <ulink url="http://json-rpc.org/wiki/specification">JSON-RPCバージョン 1 仕様</ulink>
        の両方をサポートします;
        それは、サービスのメタデータをサービス利用者に提供するために、
        <ulink url="http://groups.google.com/group/json-schema/web/service-mapping-description-proposal">サービス
            マッピング定義 (SMD) 仕様</ulink>の
        <acronym>PHP</acronym>実装を提供します。
    </para>

    <para>
        JSON-RPCは、軽量なリモート・プロシージャ呼出しプロトコルです。
        そのプロトコルでは、<acronym>JSON</acronym>をそのメッセージのエンベロープのために利用します。
        このJSON-RPC実装は<acronym>PHP</acronym>の<ulink
            url="http://www.php.net/manual/ja/class.soapserver.php">SoapServer</ulink>
        <acronym>API</acronym>に従います。
        このことにより典型的状況では、簡単に下記のことができます:
    </para>

    <itemizedlist>
        <listitem><para>サーバーオブジェクトのインスタンス化</para></listitem>
        <listitem><para>一つ以上の関数やクラス/オブジェクトをサーバーオブジェクトに配置</para></listitem>
        <listitem><para>リクエストの handle()</para></listitem>
    </itemizedlist>

    <para>
        <classname>Zend_Json_Server</classname>は
        どんな付属のクラスまたは関数でも<xref linkend="zend.server.reflection" />Reflectionを実行することを利用します。
        また、SMDと実施するメソッド呼び出しのシグナチュアとの両方をビルドするためにその情報を使います。
        そのように、それはどんな付属の関数またはクラス・メソッドでも完全な<acronym>PHP</acronym> docblock文書を最小限、持つ命令文です:
    </para>

    <itemizedlist>
        <listitem><para>パラメータとそれらで期待される変数の型の全て</para></listitem>
        <listitem><para>戻り値変数の型</para></listitem>
    </itemizedlist>

    <para>
        <classname>Zend_Json_Server</classname>はこの時だけPOSTリクエストをリスンします;
        幸いにも、この文書の時点では、ワイルドなJSON-RPC実装の大半は、
        そのようにリクエストをポストするだけです。
        次の例で示されるように、
        リクエストの処理だけではなく、サービスSMDの配信の両方で
        同じサーバーエンドポイントを簡単に利用できるようにします。
    </para>

    <example id="zend.json.server.usage">
        <title>Zend_Json_Server利用方法</title>

        <para>
            最初に、JSON-RPCサーバーによって公開したいクラスを定義しましょう。
            そのクラスを 'Calculator' とし、
            'add'、'subtract'、'multiply' 及び 'divide'メソッドを定義します:
        </para>

        <programlisting language="php"><![CDATA[
/**
 * Calculator - JSON-RPCを通じて公開するサンプル・クラス。
 */
class Calculator
{
    /**
     * ２つの変数の合計を返します
     *
     * @param  int $x
     * @param  int $y
     * @return int
     */
    public function add($x, $y)
    {
        return $x + $y;
    }

    /**
     * ２つの変数の差を返します
     *
     * @param  int $x
     * @param  int $y
     * @return int
     */
    public function subtract($x, $y)
    {
        return $x - $y;
    }

    /**
     * ２つの変数の積を返します
     *
     * @param  int $x
     * @param  int $y
     * @return int
     */
    public function multiply($x, $y)
    {
        return $x * $y;
    }

    /**
     * ２つの変数の除算結果を返します
     *
     * @param  int $x
     * @param  int $y
     * @return float
     */
    public function divide($x, $y)
    {
        return $x / $y;
    }
}
]]></programlisting>

        <para>
            それぞれのメソッドで戻り値のための項目だけでなく、
            それぞれのパラメータとその型を示す項目を持つdocblockを持つことに注意してください。
            それに関しては、Zend Frameworkで<classname>Zend_Json_Server</classname>や
            その他のいずれのサーバー構成要素を利用するときでも、これは<emphasis>絶対重要</emphasis>です。
        </para>

        <para>
            それでは、リクエストを処理するためのスクリプトを作成します:
        </para>

        <programlisting language="php"><![CDATA[
$server = new Zend_Json_Server();

// どのような機能が利用できるか示します:
$server->setClass('Calculator');

//リクエストを処理:
$server->handle();
]]></programlisting>

        <para>
            しかしながら、JSON-RPCクライアントがメソッドを自動検出できるように、
            SMDを返す問題を対象にしません。
            それは、<acronym>HTTP</acronym>がメソッドをリクエストすることを確定し、
            それから、若干のサーバー・メタデータを指定することによって達成されます:
        </para>

        <programlisting language="php"><![CDATA[
$server = new Zend_Json_Server();
$server->setClass('Calculator');

if ('GET' == $_SERVER['REQUEST_METHOD']) {
    // URLのエンドポイント及び使用するJSON-RPCのバージョンを示します:
    $server->setTarget('/json-rpc.php')
           ->setEnvelope(Zend_Json_Server_Smd::ENV_JSONRPC_2);

    // SMDをつかみます
    $smd = $server->getServiceMap();

    // クライアントにSMDを返します
    header('Content-Type: application/json');
    echo $smd;
    return;
}

$server->handle();
]]></programlisting>

        <para>
            DojoツールキットでJSON-RPCサーバーを利用するなら、
            その２つがきちんと相互作用することを確実にするために、
            特別な互換性フラグをセットする必要もあります:
        </para>

        <programlisting language="php"><![CDATA[
$server = new Zend_Json_Server();
$server->setClass('Calculator');

if ('GET' == $_SERVER['REQUEST_METHOD']) {
    $server->setTarget('/json-rpc.php')
           ->setEnvelope(Zend_Json_Server_Smd::ENV_JSONRPC_2);
    $smd = $server->getServiceMap();

    // Dojo互換を設定します:
    $smd->setDojoCompatible(true);

    header('Content-Type: application/json');
    echo $smd;
    return;
}

$server->handle();
]]></programlisting>
    </example>

    <sect2 id="zend.json.server.details">
        <title>高度な詳細</title>

        <para>
            <classname>Zend_Json_Server</classname>の機能の大半が
            <xref linkend="zend.json.server.usage" />で説明されており、
            より高度な機能を利用できます。
        </para>

        <sect3 id="zend.json.server.details.zendjsonserver">
            <title>Zend_Json_Server</title>

            <para>
                <classname>Zend_Json_Server</classname>は、
                JSON-RPCを提供する中心的なクラスです;
                それはすべてのリクエストを扱い、
                レスポンス・ペイロードを返します。
                下記のメソッドがあります:
            </para>

            <itemizedlist>
                <listitem><para><methodname>addFunction($function)</methodname>:
                    サーバーに関連するユーザーランド関数を指定します。
                </para></listitem>
                <listitem><para><methodname>setClass($class)</methodname>:
                    サーバーに関連するクラスまたはオブジェクトを指定します;
                    そのアイテムのすべてのpublicメソッドは、
                    JSON-RPCメソッドに公開されます。
                </para></listitem>
                <listitem><para><code>fault($fault = null, $code = 404, $data =
                        null)</code>:
                    <classname>Zend_Json_Server_Error</classname>オブジェクトを生成して返します。
                </para></listitem>
                <listitem><para><methodname>handle($request = false)</methodname>:
                    JSON-RPCリクエストを処理します;
                    任意で、利用するための<classname>Zend_Json_Server_Request</classname>オブジェクトを渡します。
                    (デフォルトで１つ生成されます)
                </para></listitem>
                <listitem><para><methodname>getFunctions()</methodname>:
                    付属のメソッド全ての一覧を返します。
                </para></listitem>
                <listitem><para><code>setRequest(Zend_Json_Server_Request
                        $request)</code>:
                    サーバーのために使用するためのリクエストオブジェクトを指定します。
                </para></listitem>
                <listitem><para><methodname>getRequest()</methodname>:
                    サーバーで使われるリクエストオブジェクトを取得します。
                </para></listitem>
                <listitem><para><code>setResponse(Zend_Json_Server_Response
                        $response)</code>:
                    サーバーのために使用するためのレスポンスオブジェクトを設定します。
                </para></listitem>
                <listitem><para><methodname>getResponse()</methodname>: 
                    サーバーで使われるレスポンスオブジェクトを取得します。
                </para></listitem>
                <listitem><para><methodname>setAutoEmitResponse($flag)</methodname>:
                    サーバーがレスポンスとすべてのヘッダを自動的に送り出さなければならないかどうか示します;
                    デフォルトで、これはtrueです。
                </para></listitem>
                <listitem><para><methodname>autoEmitResponse()</methodname>:
                    レスポンスの自動送出が使用可能かどうか決定します。
                </para></listitem>
                <listitem><para><methodname>getServiceMap()</methodname>:
                    <classname>Zend_Json_Server_Smd</classname>オブジェクトの形で
                    サービス・マップ記述を取得します
                </para></listitem>
            </itemizedlist>
        </sect3>

        <sect3 id="zend.json.server.details.zendjsonserverrequest">
            <title>Zend_Json_Server_Request</title>

            <para>
                JSON-RPCのリクエスト環境は、
                <classname>Zend_Json_Server_Request</classname>オブジェクトにカプセル化されます。
                このオブジェクトによって、リクエストIDやパラメータ、JSON-RPC仕様のバージョンを含む
                JSON-RPCリクエストの必要な部分を設定できます。
                それには<acronym>JSON</acronym>または一組のオプションによってそれ自体をロードする能力があって、
                それ自体を<methodname>toJson()</methodname>メソッドにより<acronym>JSON</acronym>として翻訳できます。
            </para>

            <para>
                リクエスト・オブジェクトでは、以下のメソッドを利用できます:
            </para>

            <itemizedlist>
                <listitem><para><methodname>setOptions(array $options)</methodname>:
                    オブジェクトの設定を指定します。
                    <varname>$options</varname>は、どの 'set' メソッドにもマッチするキーを含むでしょう:
                    <methodname>setParams()</methodname>、<methodname>setMethod()</methodname>、
                    <methodname>setId()</methodname>及び<methodname>setVersion()</methodname>
                </para></listitem>
                <listitem><para><methodname>addParam($value, $key = null)</methodname>:
                    メソッド呼び出しで使うパラメータを追加します。
                    パラメータは値そのものか、パラメータ名を任意に含むことができます。
                </para></listitem>
                <listitem><para><methodname>addParams(array $params)</methodname>:
                    一度に複数のパラメータを追加します。
                    <methodname>addParam()</methodname>の代わりになります。
                </para></listitem>
                <listitem><para><methodname>setParams(array $params)</methodname>:
                    一度に全てのパラメータを設定します;
                    既存の全てのパラメータを上書きします。
                </para></listitem>
                <listitem><para><methodname>getParam($index)</methodname>:
                    位置または名前でパラメータを返します。
                </para></listitem>
                <listitem><para><methodname>getParams()</methodname>:
                    一度に全てのパラメータを返します。
                </para></listitem>
                <listitem><para><methodname>setMethod($name)</methodname>:
                    呼び出すメソッドを設定します。
                </para></listitem>
                <listitem><para><methodname>getMethod()</methodname>:
                    呼び出されるメソッドを取得します。
                </para></listitem>
                <listitem><para><methodname>isMethodError()</methodname>:
                    リクエストが異常で、エラーに終わるかどうか決定します。
                </para></listitem>
                <listitem><para><methodname>setId($name)</methodname>:
                    リクエスト識別子（クライアントでレスポンスにリクエストにマッチすることに使われる）をセットします。
                </para></listitem>
                <listitem><para><methodname>getId()</methodname>:
                    リクエストの識別子を取得します。
                </para></listitem>
                <listitem><para><methodname>setVersion($version)</methodname>:
                    リクエストが適合するJSON-RPC仕様バージョンを設定します。
                    おそらく '1.0' かまたは '2.0' のどちらかです。
                </para></listitem>
                <listitem><para><methodname>getVersion()</methodname>:
                    リクエストで使われるJSON-RPC仕様バージョンを取得します。
                </para></listitem>
                <listitem><para><methodname>loadJson($json)</methodname>:
                    <acronym>JSON</acronym>文字列からリクエストオブジェクトを読み込みます。
                </para></listitem>
                <listitem><para><methodname>toJson()</methodname>:
                    リクエストを<acronym>JSON</acronym>ストリングに翻訳します。
                </para></listitem>
            </itemizedlist>

            <para>
                <acronym>HTTP</acronym>に特有のバージョンは、
                <classname>Zend_Json_Server_Request_Http</classname>を通して利用できます。
                このクラスは<code>php://input</code>を通じてリクエストを取得し、
                <methodname>getRawJson()</methodname>メソッドを通じて生の<acronym>JSON</acronym>へのアクセスを可能にします。
            </para>
        </sect3>

        <sect3 id="zend.json.server.details.zendjsonserverresponse">
            <title>Zend_Json_Server_Response</title>

            <para>
                JSON-RPCレスポンス・ペイロードは、
                <classname>Zend_Json_Server_Response</classname>オブジェクトにカプセル化されます。
                このオブジェクトにより、
                リクエストの戻り値、レスポンスがエラーかどうか、
                リクエスト識別子、レスポンスが従うJSON-RPC仕様バージョン、
                そして任意にサービス・マップをセットできます。
            </para>

            <para>
                レスポンス・オブジェクトでは、以下のメソッドを利用できます:
            </para>

            <itemizedlist>
                <listitem><para><methodname>setResult($value)</methodname>:
                    レスポンス結果を設定します。
                </para></listitem>
                <listitem><para><methodname>getResult()</methodname>:
                    レスポンス結果を取得します。
                </para></listitem>
                <listitem><para><code>setError(Zend_Json_Server_Error
                    $error)</code>:
                    エラーオブジェクトを設定します。
                    設定すると、<acronym>JSON</acronym>にシリアライズ化するとき、これがレスポンスとして使われます。
                </para></listitem>
                <listitem><para><methodname>getError()</methodname>:
                    もしあれば、エラーオブジェクトを取得します。
                </para></listitem>
                <listitem><para><methodname>isError()</methodname>:
                    レスポンスがエラー・レスポンスであるかどうか。
                </para></listitem>
                <listitem><para><methodname>setId($name)</methodname>:
                    リクエスト識別子
                    （クライアントはオリジナルのリクエストでレスポンスにマッチするかもしれません）
                    を設定します。
                </para></listitem>
                <listitem><para><methodname>getId()</methodname>:
                    リクエスト識別子を取得します。
                </para></listitem>
                <listitem><para><methodname>setVersion($version)</methodname>:
                    レスポンスが適合するJSON-RPCバージョンを設定します。
                </para></listitem>
                <listitem><para><methodname>getVersion()</methodname>:
                    レスポンスが適合するJSON-RPCバージョンを取得します。
                </para></listitem>
                <listitem><para><methodname>toJson()</methodname>:
                    レスポンスがエラー・レスポンスで、エラー・オブジェクトをシリアライズ化するならば、
                    <acronym>JSON</acronym>に対するレスポンスをシリアライズ化します。
                </para></listitem>
                <listitem><para><methodname>setServiceMap($serviceMap)</methodname>:
                    サービス・マップ・オブジェクトをレスポンスに設定します。
                </para></listitem>
                <listitem><para><methodname>getServiceMap()</methodname>:
                    もしあれば、サービス・マップ・オブジェクトを取得します。
                </para></listitem>
            </itemizedlist>

            <para>
                <acronym>HTTP</acronym>に依存したバージョンは、
                <classname>Zend_Json_Server_Response_Http</classname>を通じて利用できます。
                このクラスは<acronym>JSON</acronym>としてレスポンスをシリアライズ化するだけでなく、
                適切な<acronym>HTTP</acronym>ヘッダを送ります。
            </para>
        </sect3>

        <sect3 id="zend.json.server.details.zendjsonservererror">
            <title>Zend_Json_Server_Error</title>

            <para>
                JSON-RPCには、エラー状況を報告するために、特別なフォーマットがあります。
                エラーはすべて、最小限、エラー・メッセージとエラーコードを用意する必要があります;
                任意に、追加のデータ（例えばbacktrace）を用意できます。
            </para>

            <para>
                エラーコードは、
                <ulink url="http://xmlrpc-epi.sourceforge.net/specs/rfc.fault_codes.php">
                XML-RPC EPIプロジェクト</ulink>によって推奨されるコードに由来します。
                <classname>Zend_Json_Server</classname>は、エラー状態に基づくコードを適切に割り当てます。
                アプリケーション例外のためには、コード '-32000' が使われます。
            </para>

            <para>
                <classname>Zend_Json_Server_Error</classname>
                は以下のメソッドを公開します:
            </para>

            <itemizedlist>
                <listitem><para><methodname>setCode($code)</methodname>:
                    エラーコードを設定します;
                    認められたXML-RPCエラーコード範囲にそのコードがないならば、
                    -32000が割り当てられます。
                </para></listitem>
                <listitem><para><methodname>getCode()</methodname>:
                    現行のエラーコードを取得します。
                </para></listitem>
                <listitem><para><methodname>setMessage($message)</methodname>:
                    エラーメッセージを設定します。
                </para></listitem>
                <listitem><para><methodname>getMessage()</methodname>:
                    現行のエラーメッセージを取得します。
                </para></listitem>
                <listitem><para><methodname>setData($data)</methodname>:
                    backtraceのような、
                    エラーを制限する補助データをさらにセットします。
                </para></listitem>
                <listitem><para><methodname>getData()</methodname>:
                    現行のエラー補助データをいずれも取得します。
                </para></listitem>
                <listitem><para><methodname>toArray()</methodname>:
                    エラーを配列にキャストします。
                    配列は 'code'や'message'及び'data'キーを含むでしょう。
                </para></listitem>
                <listitem><para><methodname>toJson()</methodname>:
                    エラーをJSON-RPCエラー表現にキャストします。
                </para></listitem>
            </itemizedlist>
        </sect3>

        <sect3 id="zend.json.server.details.zendjsonserversmd">
            <title>Zend_Json_Server_Smd</title>

            <para>
                SMDは、サービス・マッピング記述、
                特定のウェブ・サービスとクライアントが相互作用できる方法を定義する<acronym>JSON</acronym>スキーマ、を表します。
                この文書の時点では、
                <ulink url="http://groups.google.com/group/json-schema/web/service-mapping-description-proposal">
                仕様</ulink>は正式にまだ批准されませんでした、
                しかし、それは他のJSON-RPC利用者のクライアントだけでなく、
                Dojoツールキットの範囲内ですでに使用中です。
            </para>

            <para>
                最も基本的には、サービス・マッピング記述は、トランスポート（POST、GET、<acronym>TCP</acronym>/IP、その他）
                リクエスト・エンベロープ・タイプ（通常、サーバーのプロトコルに基づきます）、
                サービスプロバイダのターゲット<acronym>URL</acronym>、
                そして利用できるサービスマップのメソッドを示します。
                JSON-RPCの場合、サービス・マップは利用できるメソッドのリストです、
                そしてそれは、各々のメソッドの期待される戻り値タイプだけでなく、
                利用できるパラメータとタイプを文書化します。
            </para>

            <para>
                <classname>Zend_Json_Server_Smd</classname>は、
                サービス・マップをビルドするオブジェクト指向方法を準備します。
                最も基本的には、ミューテータを用いてサービスを記述しているメタデータをそれに渡して、
                サービス（メソッドと関数）を指定します。
            </para>

            <para>
                サービス記述自体は、
                一般的に<classname>Zend_Json_Server_Smd_Service</classname>のインスタンスです;
                <classname>Zend_Json_Server_Smd</classname>の
                いろいろなサービス・ミューテータへの配列としてすべての情報を渡すこともできます、
                そして、それはサービス・オブジェクトのインスタンスを生成します。
                サービス・オブジェクトは、サービス名（一般的に関数またはメソッド名）、
                パラメータ（名前、型と位置）や戻り値の型のような情報を含みます。
                めったに使われない機能ですが、
                各々のサービスはそれ自身のターゲットとエンベロープを任意に持つことができます。
            </para>

            <para>
                付属のクラスと関数のreflectionを用いて、
                <classname>Zend_Json_Server</classname>は舞台裏ですべてを実際に行ないます;
                クラスと関数自身への参照で提供することができないカスタム機能を準備する必要がある場合だけ、
                あなた自身のサービス・マップを生成しなければなりません。
            </para>

            <para>
                <classname>Zend_Json_Server_Smd</classname>での利用可能なメソッドを含みます:
            </para>

            <itemizedlist>
                <listitem><para><methodname>setOptions(array $options)</methodname>:
                    オプション配列からSMDオブジェクトをセットアップします。
                    ミューテーターのすべてを、キーとして使うことができます。
                    (メソッドは 'set' で始まります)
                </para></listitem>
                <listitem><para><methodname>setTransport($transport)</methodname>:
                    サービスにアクセスするために使われるトランスポートを設定します;
                    現行では POST だけがサポートされます。
                </para></listitem>
                <listitem><para><methodname>getTransport()</methodname>:
                    現行のサービストランスポートを取得します。
                </para></listitem>
                <listitem><para><methodname>setEnvelope($envelopeType)</methodname>:
                    サービスにアクセスするために使われるであろうリクエスト・エンベロープを設定します。
                    現行では定数の
                    <constant>Zend_Json_Server_Smd::ENV_JSONRPC_1</constant>及び
                    <constant>Zend_Json_Server_Smd::ENV_JSONRPC_2</constant>をサポートします。
                </para></listitem>
                <listitem><para><methodname>getEnvelope()</methodname>:
                    現行のリクエスト・エンベロープを取得します。
                </para></listitem>
                <listitem><para><methodname>setContentType($type)</methodname>:
                     リクエストが使うであろうコンテンツタイプを設定します。
                     (デフォルトでは、これは 'application/json' です)
                </para></listitem>
                <listitem><para><methodname>getContentType()</methodname>:
                    サービスにリクエストするための、現行のコンテンツタイプを取得します。
                </para></listitem>
                <listitem><para><methodname>setTarget($target)</methodname>:
                    サービスのための<acronym>URL</acronym>エンドポイントを設定します。
                </para></listitem>
                <listitem><para><methodname>getTarget()</methodname>:
                    サービスのための<acronym>URL</acronym>エンドポイントを取得します。
                </para></listitem>
                <listitem><para><methodname>setId($id)</methodname>:
                    一般的に、（ターゲットと同じく）これはサービスの<acronym>URL</acronym>エンドポイントです。
                </para></listitem>
                <listitem><para><methodname>getId()</methodname>:
                    サービスIDを取得します。
                    (一般的に、サービスの<acronym>URL</acronym>エンドポイントです)
                </para></listitem>
                <listitem><para><methodname>setDescription($description)</methodname>:
                    サービスの定義を設定します。
                    (一般的に、サービスの目的を説明する物語の情報です)
                </para></listitem>
                <listitem><para><methodname>getDescription()</methodname>:
                    サービスの定義を取得します。
                </para></listitem>
                <listitem><para><methodname>setDojoCompatible($flag)</methodname>:
                    SMDがDojoツールキットと互換かどうか示すフラグを設定します。
                    trueの場合、生成された<acronym>JSON</acronym> SMDは、
                    DojoのJSON-RPCクライアントが期待する形式に従ってフォーマットされます。
                </para></listitem>
                <listitem><para><methodname>isDojoCompatible()</methodname>:
                    Dojo互換性フラグの値を返します。
                    (デフォルトではfalseです)
                </para></listitem>
                <listitem><para><methodname>addService($service)</methodname>:
                    マップするサービスを追加します。
                    <classname>Zend_Json_Server_Smd_Service</classname>のコンストラクタに渡す情報の配列か、
                    またはそのクラスのインスタンスでしょう。
                </para></listitem>
                <listitem><para><methodname>addServices(array $services)</methodname>:
                    一度に複数のサービスを追加します。
                </para></listitem>
                <listitem><para><methodname>setServices(array $services)</methodname>:
                    一度に複数のサービスを設定します。
                    以前に設定されたサービスを全て上書きします。
                </para></listitem>
                <listitem><para><methodname>getService($name)</methodname>:
                    名前でサービスを取得します。
                </para></listitem>
                <listitem><para><methodname>getServices()</methodname>:
                    付属のサービスを全て取得します。
                </para></listitem>
                <listitem><para><methodname>removeService($name)</methodname>:
                    マップからサービスを除去します。
                </para></listitem>
                <listitem><para><methodname>toArray()</methodname>:
                    サービスマップを配列にキャストします。
                </para></listitem>
                <listitem><para><methodname>toDojoArray()</methodname>:
                    サービスマップをDojoツールキット互換の配列にキャストします。
                </para></listitem>
                <listitem><para><methodname>toJson()</methodname>:
                    サービスマップを<acronym>JSON</acronym>表現にキャストします。
                </para></listitem>
            </itemizedlist>

            <para>
                <classname>Zend_Json_Server_Smd_Service</classname>には下記のメソッドがあります:
            </para>

            <itemizedlist>
                <listitem><para><methodname>setOptions(array $options)</methodname>:
                    配列からオブジェクトの状態を設定します。
                    どのミューテーター(メソッドは 'set' で始まります)でもキーとして使われ、
                    このメソッドを通じて設定されるでしょう。
                </para></listitem>
                <listitem><para><methodname>setName($name)</methodname>:
                    サービス名を設定します。
                    (一般的には、関数やメソッドの名前)
                </para></listitem>
                <listitem><para><methodname>getName()</methodname>:
                     サービス名を取得します。
                </para></listitem>
                <listitem><para><methodname>setTransport($transport)</methodname>:
                    サービスのトランスポートを設定します。
                    (現行では、<classname>Zend_Json_Server_Smd</classname>によりサポートされる
                    トランスポートのみ許可されます)
                </para></listitem>
                <listitem><para><methodname>getTransport()</methodname>: Retrieve the
                        current transport.</para></listitem>
                <listitem><para><methodname>setTarget($target)</methodname>:
                    サービスの<acronym>URL</acronym>エンドポイントを設定します。
                    (一般的には、サービスが付与される全体的なSMDとこれは同じです。)
                </para></listitem>
                <listitem><para><methodname>getTarget()</methodname>:
                    サービスの<acronym>URL</acronym>エンドポイントを取得します。
                </para></listitem>
                <listitem><para><methodname>setEnvelope($envelopeType)</methodname>:
                    サービスのエンベロープタイプを設定します。
                    (現行では、<classname>Zend_Json_Server_Smd</classname>によりサポートされる
                    エンベロープのみ許可されます)
                </para></listitem>
                <listitem><para><methodname>getEnvelope()</methodname>:
                    サービスのエンベロープタイプを取得します。
                </para></listitem>
                <listitem><para><code>addParam($type, array $options = array(),
                            $order = null)</code>:
                    サービスにパラメータを追加します。
                    デフォルトで、パラメータ型だけは必要です。
                    しかしながら、下記のオプションのように、指令を与えたいかもしれません:
                    </para>
                    <itemizedlist>
                        <listitem><para><emphasis>name</emphasis>:
                            パラメータ名
                        </para></listitem>
                        <listitem><para><emphasis>optional</emphasis>:
                            パラメータが任意か否か
                        </para></listitem>
                        <listitem><para><emphasis>default</emphasis>:
                            パラメータの既定値
                        </para></listitem>
                        <listitem><para><emphasis>description</emphasis>:
                            パラメータを記述するテキスト
                        </para></listitem>
                    </itemizedlist>
                </listitem>
                <listitem><para><methodname>addParams(array $params)</methodname>:
                    一度にいくつかのパラメータを追加します;
                    各々のパラメータは、最小限、パラメータ型を記述する '型' 、
                    さらに任意で '順序' キーを含む連想配列でなければなりません。
                    その他の全てのキーは<methodname>addOption()</methodname>に
                    <varname>$options</varname>として渡されます。
                </para></listitem>
                <listitem><para><methodname>setParams(array $params)</methodname>:
                    一度に複数のパラメーターを設定します。
                    既存のパラメータを全て上書きします。
                </para></listitem>
                <listitem><para><methodname>getParams()</methodname>:
                    現行で設定されているパラメータを全て取得します。
                </para></listitem>
                <listitem><para><methodname>setReturn($type)</methodname>:
                    サービスの返り値の型を設定します。
                </para></listitem>
                <listitem><para><methodname>getReturn()</methodname>:
                    サービスの返り値の型を取得します。
                </para></listitem>
                <listitem><para><methodname>toArray()</methodname>:
                    サービスを配列にキャストします。
                </para></listitem>
                <listitem><para><methodname>toJson()</methodname>:
                    サービスを<acronym>JSON</acronym>表現にキャストします。
                </para></listitem>
            </itemizedlist>
        </sect3>
    </sect2>
</sect1>
<!--
vim:se ts=4 sw=4 et:
-->