|
Mergedoc Translation |
||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||
public interface RequestDispatcher
クライアントからリクエストを受け取り、さらにそのリクエストをサーバ上の (Servlet や HTML ファイル、JSP ファイルのような) リソースに転送するオブジェクトを定義します。
Servlet コンテナは RequestDispatcher オブジェクトを生成します。
このオブジェクトは特定のパスか、指定された名前で参照できるサーバ上のリソースのラッパーとして使われます。
このインタフェースは Servlet をラップするために用意されていますが、Servlet コンテナが RequestDispatcher オブジェクトを生成すれば、どのようなタイプのリソースでもラップできます。
ServletContext.getRequestDispatcher(java.lang.String),
ServletContext.getNamedDispatcher(java.lang.String),
ServletRequest.getRequestDispatcher(java.lang.String)| メソッドの概要 | |
|---|---|
void |
forward(ServletRequest request,
ServletResponse response)
Servletからサーバ上の他のリソース (Servlet、JSP ファイル、HTMLファイル) へとリクエストをフォワードします。 |
void |
include(ServletRequest request,
ServletResponse response)
リソース (Servlet、JSP ファイル、HTML ファイル) の内容をレスポンスにインクルードします。 |
| メソッドの詳細 |
|---|
void forward(ServletRequest request,
ServletResponse response)
throws ServletException,
java.io.IOException
RequestDispatcher オブジェクトは getRequestDispatcher() メソッドを通して得られるので、ServletRequest オブジェクトには最終的なフォワード先となるリソースのパスに合うようなパス要素やパラメータがあります。
forward メソッドはレスポンスがクライアントに送り返される前に(レスポンスボディの出力がフラッシュされる前に)実行されなければなりません。
レスポンスがすでに返された後に実行されると、このメソッドは IllegalStateException をスローします。
レスポンスバッファの送り返されてない出力は、フォワードの前にクリアされます。
リクエスト、レスポンスに関連付けられているパラメータは Servlet の service メソッドに渡されるものと同じオブジェクトか、リクエスト、レスポンスをラップしている ServletRequestWrapper 、あるいは ServletResponseWrapper クラスのサブクラスでなければなりません。
request - クライアントがServlet に出したリクエストを表す ServletRequest オブジェクトresponse - Servlet がクライアントに返すレスポンスを表す ServletResponse オブジェクト
ServletException - 最終的なフォワード先となるリソースがこの例外をスローした場合
java.io.IOException - 最終的なフォワード先となるリソースがこの例外をスローした場合
java.lang.IllegalStateException - すでにレスポンスが返された後に実行された場合
void include(ServletRequest request,
ServletResponse response)
throws ServletException,
java.io.IOException
リクエスト、レスポンスに関連付けられているパラメータは Servlet の service メソッドに渡されるものと同じか、リクエスト、レスポンスをラップしている ServletRequestWrapper 、あるいは ServletResponseWrapper クラスのサブクラスでなければなりません。
request - クライアントのリクエストを表す ServletRequest オブジェクトresponse - Servlet のレスポンスを表す ServletResponse オブジェクト
ServletException - インクルードされるリソースがこの例外をスローした場合
java.io.IOException - インクルードされるリソースがこの例外をスローした場合
|
Mergedoc Translation |
||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||