§コンテントネゴシエーション

コンテントネゴシエーションは、同じリソース (URI) から異なる表現を提供することを可能にする機構です。これは 例えば いくつかの出力フォーマット (XML, JSON, etc.) をサポートする Web サービスを書く場合に便利です。サーバ主導のネゴシエーションは、基本的に Accept* リクエストヘッダを使って実行されます。HTTP 仕様で、コンテントネゴシエーションについてもっと詳しい情報を見つけることができます。

§言語

あるリクエストで利用可能な言語の一覧は、Accept-Language ヘッダからこれらを探して、品質値に従って並び替える play.mvc.Http.RequestHeader#acceptLanguages を使うことで取得できます。Play はこれを使ってリクエストの HTTP コンテキストに lang 値を設定するので、最適な言語が使用されます (アプリケーションがサポートしている場合。そうでない場合はアプリケーションのデフォルト言語が使用されます) 。

§コンテンツ

同様に、play.mvc.Http.RequestHeader#acceptedTypes メソッドは、あるリクエストに対するレスポンスにおいて利用可能な MIME タイプの一覧を提供します。このメソッドは、利用可能な MIME タイプを Accept リクエストヘッダから検索し、品質値に従って並び替えます。

play.mvc.Http.RequestHeader#accepts メソッドを使って、現在のリクエストが提供される MIME タイプを利用できるかどうかをテストすることができます:

public Result list() {
    List<Item> items = Item.find.all();
    if (request().accepts("text/html")) {
        return ok(views.html.Application.list.render(items));
    } else {
        return ok(Json.toJson(items));
    }
}

Next: エラーハンドリング

このドキュメントの翻訳は Play チームによってメンテナンスされているものではありません。間違いを見つけた場合、このページのソースコードをここで確認することができます。ドキュメントガイドラインを読んで、お気軽にプルリクエストを送ってください。