|
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 |
||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |