public class MockRequestDispatcher extends ObjectSE implements RequestDispatcherEE
RequestDispatcher
EE インターフェースのモック実装。MockHttpServletRequest.getRequestDispatcher(String)
ERROR_EXCEPTIONEE, ERROR_EXCEPTION_TYPEEE, ERROR_MESSAGEEE, ERROR_REQUEST_URIEE, ERROR_SERVLET_NAMEEE, ERROR_STATUS_CODEEE, FORWARD_CONTEXT_PATHEE, FORWARD_MAPPINGEE, FORWARD_PATH_INFOEE, FORWARD_QUERY_STRINGEE, FORWARD_REQUEST_URIEE, FORWARD_SERVLET_PATHEE, INCLUDE_CONTEXT_PATHEE, INCLUDE_MAPPINGEE, INCLUDE_PATH_INFOEE, INCLUDE_QUERY_STRINGEE, INCLUDE_REQUEST_URIEE, INCLUDE_SERVLET_PATHEE
コンストラクターと説明 |
---|
MockRequestDispatcher(StringSE resource) 指定されたリソースの新しい MockRequestDispatcher を作成します。 |
修飾子と型 | メソッドと説明 |
---|---|
void | forward(ServletRequestEE request, ServletResponseEE response) リクエストをサーブレットからサーバー上の別のリソース(サーブレット、JSP ファイル、HTML ファイル)に転送します。 |
protected MockHttpServletResponse | getMockHttpServletResponse(ServletResponseEE response) 基になる MockHttpServletResponse を取得し、必要に応じて HttpServletResponseWrapper EE デコレータをアンラップします。 |
void | include(ServletRequestEE request, ServletResponseEE response) レスポンスにリソース(サーブレット、JSP ページ、HTML ファイル)のコンテンツを含めます。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
public MockRequestDispatcher(StringSE resource)
resource
- ディスパッチするサーバーリソース、特定のパスにある、特定の名前で指定されたサーバーリソース public void forward(ServletRequestEE request, ServletResponseEE response)
javax.servlet.RequestDispatcherEE
getRequestDispatcher()
を介して取得された RequestDispatcher
の場合、ServletRequest
オブジェクトのパス要素とパラメーターは、ターゲットリソースのパスに一致するように調整されます。
forward
は、レスポンスがクライアントにコミットされる前に(レスポンス本文の出力がフラッシュされる前に)呼び出す必要があります。レスポンスがすでにコミットされている場合、このメソッドは IllegalStateException
をスローします。レスポンスバッファー内のコミットされていない出力は、転送の前に自動的にクリアされます。
リクエストおよびレスポンスパラメーターは、呼び出しサーブレットのサービスメソッドに渡されたものと同じオブジェクトであるか、ラップする ServletRequestWrapper
EE または ServletResponseWrapper
EE クラスのサブクラスである必要があります。
このメソッドは、指定されたリクエストのディスパッチャー型を DispatcherType.FORWARD
に設定します。
RequestDispatcherEE
の forwardEE
request
- クライアントがサーブレットに対して行うリクエストを表す ServletRequest
EE オブジェクト response
- サーブレットがクライアントに返すレスポンスを表す ServletResponse
EE オブジェクト ServletRequest.getDispatcherType()
EEpublic void include(ServletRequestEE request, ServletResponseEE response)
javax.servlet.RequestDispatcherEE
ServletResponse
EE オブジェクトにはパス要素があり、パラメーターは呼び出し元から変更されません。含まれているサーブレットは、レスポンスステータスコードを変更したり、ヘッダーを設定したりできません。変更しようとしても無視されます。
リクエストおよびレスポンスパラメーターは、呼び出しサーブレットのサービスメソッドに渡されたものと同じオブジェクトであるか、ラップする ServletRequestWrapper
EE または ServletResponseWrapper
EE クラスのサブクラスである必要があります。
このメソッドは、指定されたリクエストのディスパッチャー型を DispatcherType.INCLUDE
に設定します。
RequestDispatcherEE
の includeEE
request
- クライアントのリクエストを含む ServletRequest
EE オブジェクト response
- サーブレットのレスポンスを含む ServletResponse
EE オブジェクト ServletRequest.getDispatcherType()
EEprotected MockHttpServletResponse getMockHttpServletResponse(ServletResponseEE response)
MockHttpServletResponse
を取得し、必要に応じて HttpServletResponseWrapper
EE デコレータをアンラップします。