Play Frameworkでコントローラからリダイレクトする方法を徹底解説！
生徒
「Play Frameworkで、処理が終わった後に自動的に別のページに飛ばしたいときはどうすればいいですか？」
先生
「それは『リダイレクト』という機能を使います。例えばログインに成功した後にマイページへ移動させるような動きですね。」
生徒
「URLを直接指定する以外に、もっと賢い方法はありますか？」
先生
「もちろんです！Play Frameworkには、ルーティングと連動した便利なリダイレクト方法があります。Javaのコードを使って詳しく説明しますね。」
1. リダイレクトとは？
Webアプリケーションにおけるリダイレクト（Redirect）とは、サーバーがブラウザに対して「別のURLへアクセスし直してください」と命令を送る仕組みのことです。Play Frameworkのコントローラで特定の処理（データの保存や削除など）を完了させた後、そのまま画面を表示するのではなく、別のページへユーザーを誘導したい場合に活用します。
プログラミング未経験の方に分かりやすく例えると、リダイレクトは「案内所」のようなものです。例えば、役所の窓口で「手続きが終わりましたので、隣の建物へ行ってください」と言われるのと同じです。ブラウザはその案内を受けて、自動的に新しいページを開き直します。これにより、二重送信の防止や、ユーザーにとって自然な画面遷移を実現することができます。
2. シンプルなURLリダイレクトの書き方
まずは最も基本的な、特定のURL文字列を直接指定してリダイレクトさせる方法です。Play Frameworkでは redirect() というメソッドを使用します。このメソッドに移動先のURLを渡すだけで、ブラウザへ転送命令を送ることができます。
Javaのコントローラ内では、戻り値の型として Result を指定し、最後にこのメソッドの結果を return します。
package controllers;
import play.mvc.*;
public class MyController extends Controller {
public Result redirectToExternal() {
// 指定した外部サイトや固定のURLへジャンプさせる
return redirect("https://www.google.com");
}
}
この方法は非常に簡単ですが、プログラム内部のページ遷移で使う場合は、後述する「リバースルーティング」を使った方法の方が推奨されます。
3. リバースルーティングによる賢いリダイレクト
Play Frameworkの大きな特徴の一つに、リバースルーティングがあります。これは、URLを直接書くのではなく、「コントローラのメソッド名」を指定してURLを逆引きする仕組みです。これを使うことで、将来 routes ファイルでURLを変更したとしても、プログラム側のコードを書き直す必要がなくなります。
使い方は、routes.コントローラ名.メソッド名() という形式を redirect() メソッドの中に記述します。これがJavaでの型安全（タイプセーフ）な開発を支える重要な技術です。
package controllers;
import play.mvc.*;
public class LoginController extends Controller {
public Result login() {
// ログイン処理が成功したと仮定して
// HomeControllerのindexメソッドに対応するURLへリダイレクト
return redirect(routes.HomeController.index());
}
}
4. HTTPステータスコードとリダイレクトの種類
リダイレクトには、実はいくつかの種類があります。最も一般的なのは「一時的な移動」を意味する303 See Otherです。Play Frameworkの標準的な redirect() メソッドは、この303ステータスコードを返します。
他にも、恒久的な移動を意味する301リダイレクトや、一時的な移動の307などがありますが、Webアプリケーションの通常の操作（ボタンを押した後の遷移など）では303を使うのが安全です。これにより、ユーザーがブラウザの「戻る」ボタンや「更新」ボタンを押したときに、同じデータが何度もサーバーに送られてしまうエラーを防ぐことができます。これはPOST-Redirect-GET（PRG）パターンと呼ばれる非常に重要な設計手法です。
5. 引数を持つメソッドへのリダイレクト
ページを移動させる際に、IDなどのパラメータを渡したいこともありますよね。例えば、商品を登録した後に、その商品の「詳細画面」へ飛ばしたい場合です。リバースルーティングを使えば、Javaのメソッドを呼び出すのと同じ感覚で引数を渡すことができます。
以下の例では、ユーザーIDを指定してプロフィール画面へリダイレクトさせています。コントローラの引数として値を渡すだけで、Playが自動的に /profile/123 のような適切なURLを組み立ててくれます。
package controllers;
import play.mvc.*;
public class RegistrationController extends Controller {
public Result register() {
int userId = 123; // 本来はデータベース保存後に取得するID
// 引数 userId を渡して ProfileController の show メソッドへ飛ばす
return redirect(routes.ProfileController.show(userId));
}
}
6. Routesファイルの設定とリダイレクトの関係
リダイレクトを正しく動作させるためには、conf/routes ファイルに正しくパスが定義されている必要があります。Play Frameworkのプロジェクトにおいて、ルーティングはすべてのリクエストとレスポンスの起点となる設計図です。
先ほどのプロフィール表示の例であれば、以下のような設定が routes ファイルに書かれているはずです。この定義があるからこそ、Javaのコード側でリバースルーティングが使えるようになるのです。
# プロフィール画面の定義
GET /profile/:id controllers.ProfileController.show(id: Int)
このように、URLの形式とJavaのメソッドが密接に関連しているのがPlayのコントローラ入門において理解すべき基本構造です。
7. フラッシュスコープと組み合わせたリダイレクト
リダイレクトの際、「保存しました！」という短いメッセージを次の画面で表示したいことがよくあります。しかし、リダイレクトは一度通信を切って新しいページを読み直すため、普通の変数ではデータを引き継げません。そこで使うのがフラッシュスコープ（Flash Scope）です。
フラッシュスコープは、次のリクエストが来るまでの間だけ、一時的にデータを保存してくれるクッキーのような仕組みです。リダイレクトの命令に flashing("キー", "メッセージ") を繋げることで、簡単に情報を渡すことができます。
public Result deleteUser(int id) {
// ユーザー削除処理...
return redirect(routes.UserController.list())
.flashing("success", "ユーザーを削除しました。");
}
8. 開発環境でのリダイレクト確認方法
正しくリダイレクトされているかどうかを確認するには、ブラウザの「デベロッパーツール（F12キー）」が便利です。ネットワークタブを開いた状態で処理を実行し、ステータスコードが 303 になっているか、そしてその後の通信で目的のページに GET リクエストが飛んでいるかをチェックしてみましょう。
IntelliJやVSCodeなどのエディタを使っている場合、リバースルーティングのコードから Ctrl + クリック で routes ファイルの該当箇所へジャンプすることもできます。こうした開発環境構築のテクニックを駆使することで、複雑な画面遷移も迷わずに実装できるようになります。
9. リダイレクトを使う際の注意点
最後に、注意すべきポイントをいくつか挙げます。まず、無限ループに気をつけてください。ページAからページBへリダイレクトさせ、ページBでもページAへリダイレクトさせる処理を書くと、ブラウザがエラーを吐いて止まってしまいます。遷移の設計図をあらかじめ書いておくことが、プロジェクト作成の段階では大切です。
また、機密性の高い情報をリダイレクトのURLパラメータに乗せるのも避けましょう。URLはブラウザの履歴に残ってしまうため、重要なデータはセッション管理やデータベースを使って受け渡すのが基本です。Play Frameworkの機能を正しく理解して、安全で使いやすいWebアプリケーションを目指しましょう！
