クラス AbstractMockHttpServletRequestBuilder<B extends AbstractMockHttpServletRequestBuilder<B>>
- 型パラメーター:
B
- ビルダー型への自己参照
- 実装されたすべてのインターフェース:
Mergeable
、ConfigurableSmartRequestBuilder<B>
、RequestBuilder
、SmartRequestBuilder
- 既知の直属サブクラス
AbstractMockMultipartHttpServletRequestBuilder
、MockHttpServletRequestBuilder
、MockMvcTester.MockMvcRequestBuilder
MockMvc
でリクエストを実行するための入力として必要な MockHttpServletRequest
のベースビルダー。- 導入:
- 6.2
- 作成者:
- Rossen Stoyanchev, Juergen Hoeller, Arjen Poutsma, Sam Brannen, Kamill Sokol
コンストラクターのサマリー
コンストラクター修飾子コンストラクター説明protected
AbstractMockHttpServletRequestBuilder
(HttpMethod httpMethod) 指定されたHttpMethod
を使用して新しいインスタンスを作成します。方法の概要
修飾子と型メソッド説明生の文字列値を使用してAccept
ヘッダーを設定しますが、(テスト目的で)整形式ではない可能性があります。'Accept' ヘッダーを指定されたメディア型に設定します。final MockHttpServletRequest
buildRequest
(ServletContextEE servletContext) MockHttpServletRequest
を構築します。characterEncoding
(StringSE encoding) リクエストの文字エンコーディングを設定します。characterEncoding
(CharsetSE encoding) リクエストの文字エンコーディングを設定します。content
(byte[] content) リクエスト本文を設定します。リクエストの本文を UTF-8 文字列として設定します。contentType
(StringSE contentType) リクエストの "Content-Type" ヘッダーを生の文字列値として設定します。これは、(テスト目的で)整形式ではない可能性があります。contentType
(MediaType contentType) リクエストの "Content-Type" ヘッダーを設定します。contextPath
(StringSE contextPath) コンテキストパスを表す requestURI の部分を指定します。指定された Cookie をリクエストに追加します。protected MockHttpServletRequest
createServletRequest
(ServletContextEE servletContext) 提供されたServletContext
に基づいて新しいMockHttpServletRequest
を作成します。「入力」フラッシュ属性を設定します。flashAttrs
(MapSE<StringSE, ObjectSE> flashAttributes) フラッシュ属性を設定します。指定された値を指定されたフォームフィールドに追加し、リクエストパラメーターマップにも追加します。formFields
(MultiValueMap<StringSE, StringSE> formFields) MultiValueMap
を使用したformField(String, String...)
のバリアント。リクエストにヘッダーを追加します。headers
(HttpHeaders httpHeaders) すべてのヘッダーをリクエストに追加します。boolean
この特定のインスタンスに対してマージが有効になっていますか?リクエストのロケールを設定し、以前のロケールを上書きします。指定されたロケールを優先リクエストロケールとして追加します。"this" インスタンスにまだ設定されていない場合にのみ、値を受け入れる「親」RequestBuilder のプロパティをマージします。リクエストパラメーターをMockHttpServletRequest.getParameterMap()
に追加します。params
(MultiValueMap<StringSE, StringSE> params) MultiValueMap
を使用したparam(String, String...)
のバリアント。pathInfo を表す requestURI の部分を指定します。postProcessRequest
(MockHttpServletRequest request) リクエストの後処理を適用します。principal
(PrincipalSE principal) リクエストのプリンシパルを設定します。queryParam
(StringSE name, StringSE... values) クエリ文字列に追加し、request parameters
マップにも追加します。queryParams
(MultiValueMap<StringSE, StringSE> params) クエリ文字列に追加し、request parameters
マップにも追加します。remoteAddress
(StringSE remoteAddress) リクエストのリモートアドレスを設定します。requestAttr
(StringSE name, ObjectSE value) リクエスト属性を設定します。secure
(boolean secure) HTTPS などのセキュアチャネルの使用を示すServletRequest
EE のセキュアプロパティを設定します。protected B
self()
servletPath
(StringSE servletPath) サーブレットがマップされるパスを表す requestURI の部分を指定します。session
(MockHttpSession session) 使用する HTTP セッションを設定します。リクエスト間で再利用される場合があります。sessionAttr
(StringSE name, ObjectSE value) セッション属性を設定します。sessionAttrs
(MapSE<StringSE, ObjectSE> sessionAttributes) セッション属性を設定します。URI テンプレートと URI 変数を使用して、リクエストの URI を指定します。完全に構築された絶対URI
SE を使用して URI を指定します。with
(RequestPostProcessor postProcessor) MockHttpServletRequestBuilder
に直接組み込まれていない方法でMockHttpServletRequest
をさらに初期化するための拡張ポイント。
コンストラクターの詳細
AbstractMockHttpServletRequestBuilder
指定されたHttpMethod
を使用して新しいインスタンスを作成します。- パラメーター:
httpMethod
- HTTP メソッド (GET、POST など)
メソッドの詳細
self
uri
完全に構築された絶対URI
SE を使用して URI を指定します。uri
URI テンプレートと URI 変数を使用して、リクエストの URI を指定します。contextPath
コンテキストパスを表す requestURI の部分を指定します。コンテキストパスを指定する場合、リクエスト URI の先頭に一致する必要があります。ほとんどの場合、requestURI からコンテキストパスを省略することでテストを作成できます。これは、ほとんどのアプリケーションが実際にデプロイされている名前に依存しないためです。ここで指定する場合、コンテキストパスは "/" で始まる必要があり、"/" で終わることはできません。
servletPath
サーブレットがマップされるパスを表す requestURI の部分を指定します。これは通常、コンテキストパスの後の requestURI の一部です。ほとんどの場合、テストは requestURI からサーブレットパスを省略して記述できます。これは、ほとんどのアプリケーションがサーブレットがマップされるプレフィックスに実際には依存しないためです。たとえば、サーブレットが
"/main/*"
にマップされている場合、テストは requestURI"/main/accounts/1"
ではなく"/accounts/1"
を使用して記述できます。ここで指定する場合、servletPath は "/" で始まる必要があり、"/" で終わってはなりません。pathInfo
pathInfo を表す requestURI の部分を指定します。指定しない場合 (推奨)、requestURI から contextPath と servletPath を削除し、残りの部分を使用して、pathInfo が自動的に導出されます。ここで指定する場合、pathInfo は "/" で始まる必要があります。
指定した場合は、pathInfo がそのまま使用されます。
secure
HTTPS などのセキュアチャネルの使用を示すServletRequest
EE のセキュアプロパティを設定します。- パラメーター:
secure
- リクエストが安全なチャネルを使用しているかどうか
characterEncoding
リクエストの文字エンコーディングを設定します。- パラメーター:
encoding
- 文字エンコーディング- 導入:
- 5.3.10
- 関連事項:
characterEncoding
リクエストの文字エンコーディングを設定します。- パラメーター:
encoding
- 文字エンコーディング
content
リクエスト本文を設定します。コンテンツが提供され、
contentType(MediaType)
がapplication/x-www-form-urlencoded
に設定されている場合、コンテンツは解析されて、request parameters
マップを作成するために使用されます。- パラメーター:
content
- ボディコンテンツ
content
リクエストの本文を UTF-8 文字列として設定します。コンテンツが提供され、
contentType(MediaType)
がapplication/x-www-form-urlencoded
に設定されている場合、コンテンツは解析されて、request parameters
マップを作成するために使用されます。- パラメーター:
content
- ボディコンテンツ
contentType
リクエストの "Content-Type" ヘッダーを設定します。コンテンツが提供され、
contentType
がapplication/x-www-form-urlencoded
に設定されている場合、コンテンツは解析され、request parameters
マップを作成するために使用されます。- パラメーター:
contentType
- コンテンツ型
contentType
リクエストの "Content-Type" ヘッダーを生の文字列値として設定します。これは、(テスト目的で)整形式ではない可能性があります。- パラメーター:
contentType
- コンテンツ型- 導入:
- 4.1.2
accept
'Accept' ヘッダーを指定されたメディア型に設定します。- パラメーター:
mediaTypes
- 1 つ以上のメディア型
accept
生の文字列値を使用してAccept
ヘッダーを設定しますが、(テスト目的で)整形式ではない可能性があります。- パラメーター:
mediaTypes
- 1 つ以上のメディア型。カンマ区切りの文字列として内部的に結合されます
header
リクエストにヘッダーを追加します。値は常に追加されます。- パラメーター:
name
- ヘッダー名values
- 1 つ以上のヘッダー値
headers
すべてのヘッダーをリクエストに追加します。値は常に追加されます。- パラメーター:
httpHeaders
- 追加するヘッダーと値
param
リクエストパラメーターをMockHttpServletRequest.getParameterMap()
に追加します。Servlet API では、リクエスト文字列および / または
application/x-www-form-urlencoded
リクエストのボディからリクエストパラメーターを解析できます。このメソッドは、リクエストパラメーターマップに追加するだけです。次のいずれかを使用してクエリまたはフォームデータを指定することにより、サーブレットリクエストパラメーターの追加を使用することもできます。MockMvcRequestBuilders
へのクエリを含む URL を指定します。queryParam(java.lang.String, java.lang.String...)
またはqueryParams
を介してクエリパラメーターを追加します。content
にcontentType
application/x-www-form-urlencoded
を提供します。
- パラメーター:
name
- パラメーター名values
- 1 つ以上の値
params
MultiValueMap
を使用したparam(String, String...)
のバリアント。- パラメーター:
params
- 追加するパラメーター- 導入:
- 4.2.4
queryParam
クエリ文字列に追加し、request parameters
マップにも追加します。パラメーター名と値は、クエリ文字列に追加されるときにエンコードされます。- パラメーター:
name
- パラメーター名values
- 1 つ以上の値- 導入:
- 5.2.2
queryParams
クエリ文字列に追加し、request parameters
マップにも追加します。パラメーター名と値は、クエリ文字列に追加されるときにエンコードされます。- パラメーター:
params
- 追加するパラメーター- 導入:
- 5.2.2
formField
指定された値を指定されたフォームフィールドに追加し、リクエストパラメーターマップにも追加します。- パラメーター:
name
- フィールド名values
- 1 つ以上の値- 導入:
- 6.1.7
formFields
MultiValueMap
を使用したformField(String, String...)
のバリアント。- パラメーター:
formFields
- 追加するフォームフィールド- 導入:
- 6.1.7
cookie
指定された Cookie をリクエストに追加します。Cookie は常に追加されます。- パラメーター:
cookies
- 追加するクッキー
locale
指定されたロケールを優先リクエストロケールとして追加します。- パラメーター:
locales
- 追加するロケール- 導入:
- 4.3.6
- 関連事項:
locale
リクエストのロケールを設定し、以前のロケールを上書きします。- パラメーター:
locale
- ロケール、またはそれをリセットするnull
- 関連事項:
requestAttr
リクエスト属性を設定します。- パラメーター:
name
- 属性名value
- 属性値
sessionAttr
セッション属性を設定します。- パラメーター:
name
- セッション属性名value
- セッション属性値
sessionAttrs
セッション属性を設定します。- パラメーター:
sessionAttributes
- セッション属性
flashAttr
「入力」フラッシュ属性を設定します。- パラメーター:
name
- フラッシュ属性名value
- フラッシュ属性値
flashAttrs
フラッシュ属性を設定します。- パラメーター:
flashAttributes
- フラッシュ属性
session
使用する HTTP セッションを設定します。リクエスト間で再利用される場合があります。sessionAttr(String, Object)
を介して提供される個々の属性は、ここで提供されるセッションのコンテンツをオーバーライドします。- パラメーター:
session
- HTTP セッション
principal
リクエストのプリンシパルを設定します。- パラメーター:
principal
- 校長
remoteAddress
リクエストのリモートアドレスを設定します。- パラメーター:
remoteAddress
- リモートアドレス (IP)- 導入:
- 6.0.10
with
MockHttpServletRequestBuilder
に直接組み込まれていない方法でMockHttpServletRequest
をさらに初期化するための拡張ポイント。このインターフェースの実装には、ビルダースタイルのメソッド自体を含めることができ、静的ファクトリメソッドを介してアクセス可能にすることができます。- 次で指定:
- インターフェース
ConfigurableSmartRequestBuilder<B extends AbstractMockHttpServletRequestBuilder<B>>
のwith
- パラメーター:
postProcessor
- 追加するポストプロセッサー
isMergeEnabled
public boolean isMergeEnabled()この特定のインスタンスに対してマージが有効になっていますか?- 次で指定:
- インターフェース
Mergeable
のisMergeEnabled
- 戻り値:
- 常に
true
を返します。
merge
"this" インスタンスにまだ設定されていない場合にのみ、値を受け入れる「親」RequestBuilder のプロパティをマージします。buildRequest
MockHttpServletRequest
を構築します。- 次で指定:
- インターフェース
RequestBuilder
のbuildRequest
- パラメーター:
servletContext
- リクエストの作成に使用するServletContext
EE- 戻り値:
- リクエスト
createServletRequest
postProcessRequest
インターフェースからコピーされた説明:SmartRequestBuilder
リクエストの後処理を適用します。通常、これは 1 つ以上のorg.springframework.test.web.servlet.request.RequestPostProcessors
を呼び出すことを意味します。- 次で指定:
- インターフェース
SmartRequestBuilder
のpostProcessRequest
- パラメーター:
request
- 初期化するリクエスト- 戻り値:
- 使用するリクエスト。渡されたリクエストまたはラップされたリクエスト