リクエストハンドリング¶

リクエスト情報の取得¶

RequestHandler はクライアントやリクエストについての情報を提供するいくつかのメソッドがあります。

RequestHandlerComponent::accepts($type = null)¶

$type は、文字列・配列・null のいずれかです。 文字列の場合、そのコンテンツタイプをクライアントが受付ける場合、 accepts() は true を返します。 配列の場合、そのコンテンツタイプのいずれかを受付ける場合、 accepts() は true を返します。 null の場合、クライアントが受付けるコンテンツタイプの配列を返します。 例:

class ArticlesController extends AppController
{

    public function initialize()
    {
        parent::initialize();
        $this->loadComponent('RequestHandler');
    }

    public function beforeFilter(Event $event)
    {
        if ($this->RequestHandler->accepts('html')) {
            // クライアントが HTML (text/html) のレスポンスを
            // 受付ける場合のみコードが実行されます。
        } elseif ($this->RequestHandler->accepts('xml')) {
            // XML のみ実行するコード
        }
        if ($this->RequestHandler->accepts(['xml', 'rss', 'atom'])) {
            // クライアントが XML か RSS か Atom のいずれかを
            // 受付ける場合にコードが実行されます。
        }
    }
}

リクエスト「型」を検出する他のメソッドは、次のとおりです。

RequestHandlerComponent::isXml()¶

現在のリクエストが XML のレスポンスを受付ける場合は true を返します。

RequestHandlerComponent::isRss()¶

現在のリクエストが RSS のレスポンスを受付ける場合は true を返します。

RequestHandlerComponent::isAtom()¶

現在の呼び出しが Atom のレスポンスを受付ける場合は true を返します。 そうでなければ false を返します。

RequestHandlerComponent::isMobile()¶

ユーザーエージェントにモバイルブラウザーの文字列を含む場合、もしくはクライアントが WAP コンテンツを受け入れる場合は true を返します。 サポートされているモバイルユーザーエージェント文字列は次のとおりです。

• Android

• AvantGo

• BlackBerry

• DoCoMo

• Fennec

• iPad

• iPhone

• iPod

• J2ME

• MIDP

• NetFront

• Nokia

• Opera Mini

• Opera Mobi

• PalmOS

• PalmSource

• portalmmm

• Plucker

• ReqwirelessWeb

• SonyEricsson

• Symbian

• UP.Browser

• webOS

• Windows CE

• Windows Phone OS

• Xiino

RequestHandlerComponent::isWap()¶

クライアントが WAP コンテンツを受付ける場合は true を返します。

上記の全ての検出メソッドは、特定のコンテンツタイプを対象にしたフィルター機能と同様の方法で使用できます。 例えば、 AJAX のリクエストに応答するときには、ブラウザーのキャッシュを無効にして、デバッグレベルを 変更したいでしょう。ただし、非 AJAX リクエストのときは反対にキャッシュを許可したいと思います。 そのようなときは次のようにします。

if ($this->request->is('ajax')) {
    $this->response->disableCache();
}
// コントローラーのアクションの続き

リクエストデータの自動デコード¶

リクエストデータのデコーダーを追加します。 ハンドラーは、コールバックとコールバックのための追加の変数を含める必要があります。 コールバックは、リクエストの入力に含まれるデータの配列を返す必要があります。 たとえば、 CSV ハンドラーを追加する場合:

class ArticlesController extends AppController
{
    public function initialize()
    {
        parent::initialize();
        $parser = function ($data) {
            $rows = str_getcsv($data, "\n");
            foreach ($rows as &$row) {
                $row = str_getcsv($row, ',');
            }
            return $rows;
        };
        $this->loadComponent('RequestHandler', [
            'inputTypeMap' => [
                'csv' => [$parser]
            ]
        ]);
    }
}

ハンドラー関数として、任意の callable を利用できます。 コールバックには追加の引数を渡すこともでき、これは json_decode のような コールバックのときに便利です。

$this->RequestHandler->addInputType('json', ['json_decode', true]);

// 3.1.0 以降では、以下を使用してください
$this->RequestHandler->config('inputTypeMap.json', ['json_decode', true]);

上記の例は、 JSON によるデータを $this->request->getData() の配列にします。 stdClass オブジェクトで取得したい場合は、引数の true なしになります。

コンテンツタイプの設定を確認¶

RequestHandlerComponent::prefers($type = null)¶

クライアントが好むコンテンツタイプを判定します。 パラメーターを省略した場合は、最も可能性の高いコンテンツタイプが返されます。 $type を配列で渡した場合、クライアントが受け付けるものとマッチした最初の値が返されます。 設定はまず、もし Router で解析されたファイルの拡張子により確定されます。 次に、 HTTP_ACCEPT にあるコンテンツタイプのリストから選ばれます。

$this->RequestHandler->prefers('json');

リクエストへの応答¶

RequestHandlerComponent::renderAs($controller, $type)¶

指定した型に、コントローラーの出力モードを変更します。適切なヘルパーが存在し、 それがコントローラー中のヘルパー配列で指定されていなければ、これを追加します。

// コントローラーに xml レスポンスの出力を強制。
$this->RequestHandler->renderAs($this, 'xml');

このメソッドは、現在のコンテンツタイプに一致するヘルパーを追加しようとします。 例えば、 rss として出力する場合、 RssHelper が追加されます。

RequestHandlerComponent::respondAs($type, $options)¶

コンテンツタイプにマップした名前に基づき、応答するヘッダーをセットします。 このメソッドは、一度に多くのレスポンスプロパティーを設定することができます。

$this->RequestHandler->respondAs('xml', [
    // ダウンロードを強制
    'attachment' => true,
    'charset' => 'UTF-8'
]);

RequestHandlerComponent::responseType()¶

現在の応答するコンテンツタイプのヘッダーをの型を返します。もしセットされていなければ null を返します。

HTTP キャッシュバリデーションの活用¶

HTTP キャッシュバリデーションモデルは、クライアントへのレスポンスにコピーを使用するかどうかを 判断する（リバースプロキシーとして知られる）キャッシュゲートウェイを使用する処理です。 このモデルでは、主に帯域幅を節約しますが、正しく使用することで応答時間の短縮や、いくつかの CPU の処理を節約することができます。

コントローラーで RequestHandlerComponent を有効化すると、ビューが描画される前に、自動的に チェックを行います。このチェックでは、前回クライアントが要求してからレスポンスに変更がないかを 判断するため、レスポンスオブジェクトと元のリクエストを比較します。

レスポンスが変更無いと見なされる場合、ビューの描画処理は行われず、クライアントには何も返さず 処理時間を短縮、帯域幅を節約します。レスポンスステータスコードは 304 Not Modified にセットされます。

自動的なチェックは、 checkHttpCache を false にすることで 行わないようにすることができます。

public function initialize()
{
    parent::initialize();
    $this->loadComponent('RequestHandler', [
        'checkHttpCache' => false
    ]);
}

カスタムビュークラスの利用¶

JsonView/XmlView を利用する場合、カスタムビュークラスでデフォルトのシリアライズ方法を上書きしたり、 独自のカスタムクラスを追加したい場合があるでしょう。

その場合、既存のタイプや新規タイプのクラスをマッピングすることができます。 また、 viewClassMap 設定を使用して、これを自動的に設定することができます。

public function initialize()
{
    parent::initialize();
    $this->loadComponent('RequestHandler', [
        'viewClassMap' => [
            'json' => 'ApiKit.MyJson',
            'xml' => 'ApiKit.MyXml',
            'csv' => 'ApiKit.Csv'
        ]
    ]);
}