StandaloneMockMvcBuilder (Spring Framework API)

java.lang.ObjectSE
- org.springframework.test.web.servlet.MockMvcBuilderSupport
- - org.springframework.test.web.servlet.setup.AbstractMockMvcBuilder<StandaloneMockMvcBuilder>
  - - org.springframework.test.web.servlet.setup.StandaloneMockMvcBuilder

実装されたすべてのインターフェース:
MockMvcBuilder, ConfigurableMockMvcBuilder<StandaloneMockMvcBuilder>
```
public class StandaloneMockMvcBuilder
extends AbstractMockMvcBuilder<StandaloneMockMvcBuilder>
```
@Controller 登録を受け入れる MockMvcBuilder により、コントローラーのインスタンス化と初期化、単純な単体テストに類似したそれらの依存関係を完全に制御でき、同時に 1 つのコントローラーをテストすることもできます。
このビルダーは、DispatcherServlet がアノテーション付きコントローラーでリクエストを処理するために必要な最小限のインフラストラクチャーを作成し、カスタマイズの方法も提供します。結果の構成およびカスタマイズオプションは、ビルダースタイルメソッドを使用することを除き、MVC Java 構成を使用するのと同等です。
ビューリゾルバーを設定するには、実行されるすべてのリクエストに使用する "fixed" ビューを選択するか（setSingleView(View) を参照）、ViewResolver のリストを提供します（setViewResolvers(ViewResolver...) を参照）。
導入:
3.2
作成者:
Rossen Stoyanchev

コンストラクターのサマリー
コンストラクター
修飾子コンストラクターと説明
protected StandaloneMockMvcBuilder(ObjectSE... controllers)
protected コンストラクター。

コンストラクター
修飾子	コンストラクターと説明
`protected`	`StandaloneMockMvcBuilder(ObjectSE... controllers)` protected コンストラクター。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド非推奨のメソッド
修飾子と型	メソッドと説明
`StandaloneMockMvcBuilder`	`addInterceptors(HandlerInterceptor... interceptors)` すべての受信リクエストにマップされたインターセプターを追加します。
`StandaloneMockMvcBuilder`	`addMappedInterceptors(StringSE[] pathPatterns, HandlerInterceptor... interceptors)` パスパターンのセットにマッピングされたインターセプターを追加します。
`StandaloneMockMvcBuilder`	`addPlaceholderValue(StringSE name, StringSE value)` スタンドアロンセットアップでは、リクエストマッピングに埋め込まれたプレースホルダー値のサポートはありません。
`protected MapSE<StringSE, ObjectSE>`	`extendMvcSingletons(ServletContextEE servletContext)` このメソッドは、サブクラスから使用して、追加の `HandlerMapping`、`HandlerAdapter` などの追加の Spring MVC インフラストラクチャを登録できます。
`protected WebApplicationContext`	`initWebAppContext()` `DispatcherServlet` に渡される `WebApplicationContext` を取得するメソッド。
`StandaloneMockMvcBuilder`	`setAsyncRequestTimeout(long timeout)` 非同期実行のタイムアウト値を指定します。
`StandaloneMockMvcBuilder`	`setContentNegotiationManager(ContentNegotiationManager manager)` ContentNegotiationManager を設定します。
`StandaloneMockMvcBuilder`	`setControllerAdvice(ObjectSE... controllerAdvice)` テストで使用する 1 つ以上の `ControllerAdvice` インスタンスを登録します（指定された `Class` はインスタンスになります）。
`StandaloneMockMvcBuilder`	`setConversionService(FormattingConversionService conversionService)` カスタムフォーマッタとコンバーターを備えた変換サービスを提供します。
`StandaloneMockMvcBuilder`	`setCustomArgumentResolvers(HandlerMethodArgumentResolver... argumentResolvers)` コントローラーメソッドの引数にカスタムリゾルバーを提供します。
`StandaloneMockMvcBuilder`	`setCustomHandlerMapping(SupplierSE<RequestMappingHandlerMapping> factory)` ファクトリを構成して、カスタム `RequestMappingHandlerMapping` を作成します。
`StandaloneMockMvcBuilder`	`setCustomReturnValueHandlers(HandlerMethodReturnValueHandler... handlers)` コントローラーメソッドの戻り値のカスタムハンドラーを提供します。
`StandaloneMockMvcBuilder`	`setFlashMapManager(FlashMapManager flashMapManager)` カスタム FlashMapManager インスタンスを提供します。
`StandaloneMockMvcBuilder`	`setHandlerExceptionResolvers(HandlerExceptionResolver... exceptionResolvers)` 配列として使用する HandlerExceptionResolver 型を設定します。
`StandaloneMockMvcBuilder`	`setHandlerExceptionResolvers(ListSE<HandlerExceptionResolver> exceptionResolvers)` リストとして使用する HandlerExceptionResolver 型を設定します。
`StandaloneMockMvcBuilder`	`setLocaleResolver(LocaleResolver localeResolver)` LocaleResolver インスタンスを提供します。
`StandaloneMockMvcBuilder`	`setMessageConverters(HttpMessageConverter<?>... messageConverters)` 引数リゾルバーと戻り値ハンドラーで使用するメッセージコンバーターを設定します。これらは、リクエストとレスポンスの本文の読み取りと書き込みをサポートします。
`void`	`setPatternParser(PathPatternParser parser)` `PathMatcher` を使用した文字列パターンマッチングの代わりに、解析された `PathPatterns` を使用した URL パスマッチングを有効にします。
`StandaloneMockMvcBuilder`	`setRemoveSemicolonContent(boolean removeSemicolonContent)` ";" の場合に設定（セミコロン）コンテンツはリクエスト URI から削除する必要があります。
`StandaloneMockMvcBuilder`	`setSingleView(View view)` 指定されたビューインスタンスを常に返す単一の `ViewResolver` を設定します。
`StandaloneMockMvcBuilder`	`setUseSuffixPatternMatch(boolean useSuffixPatternMatch)` 使用すべきではありません。 5.2.4 現在。パス拡張設定オプションの非推奨については、`RequestMappingHandlerMapping` のクラスレベルの注意を参照してください。
`StandaloneMockMvcBuilder`	`setUseTrailingSlashPatternMatch(boolean useTrailingSlashPatternMatch)` 末尾のスラッシュの有無に関係なく、URL に一致するかどうか。
`StandaloneMockMvcBuilder`	`setValidator(Validator validator)` デフォルトで作成されたものではなく、カスタム `Validator` を提供します。
`StandaloneMockMvcBuilder`	`setViewResolvers(ViewResolver... resolvers)` 指定された `ViewResolvers` でビューリゾルバーを設定します。

クラス org.springframework.test.web.servlet.setup.AbstractMockMvcBuilder から継承されたメソッド
addDispatcherServletCustomizer, addFilter, addFilters, alwaysDo, alwaysExpect, apply, build, defaultRequest, defaultResponseCharacterEncoding, dispatchOptions, self

クラス org.springframework.test.web.servlet.MockMvcBuilderSupport から継承されたメソッド
createMockMvc, createMockMvc

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- コンストラクターの詳細
  - StandaloneMockMvcBuilder
```
protected StandaloneMockMvcBuilder(ObjectSE... controllers)
```
    protected コンストラクター。直接インスタンス化するためのものではありません。
    関連事項:
    MockMvcBuilders.standaloneSetup(Object...)
- メソッドの詳細
  - setControllerAdvice
```
public StandaloneMockMvcBuilder setControllerAdvice(ObjectSE... controllerAdvice)
```
    テストで使用する 1 つ以上の ControllerAdvice インスタンスを登録します（指定された Class はインスタンスになります）。
    通常、@ControllerAdvice は、Spring Bean として宣言されている限り自動検出されます。ただし、スタンドアロンセットアップは Spring の設定をロードしないため、コントローラーのようにここで明示的に登録する必要があります。
    導入:
    4.2
  - setMessageConverters
```
public StandaloneMockMvcBuilder setMessageConverters(HttpMessageConverter<?>... messageConverters)
```
    引数リゾルバーと戻り値ハンドラーで使用するメッセージコンバーターを設定します。これらは、リクエストとレスポンスの本文の読み取りと書き込みをサポートします。メッセージコンバーターがリストに追加されていない場合、代わりにコンバーターのデフォルトリストが追加されます。
  - setValidator
```
public StandaloneMockMvcBuilder setValidator(Validator validator)
```
    デフォルトで作成されたものではなく、カスタム Validator を提供します。JSR-303 がクラスパス上にあると仮定すると、使用されるデフォルトの実装は LocalValidatorFactoryBean です。
  - setConversionService
```
public StandaloneMockMvcBuilder setConversionService(FormattingConversionService conversionService)
```
    カスタムフォーマッタとコンバーターを備えた変換サービスを提供します。設定しない場合、DefaultFormattingConversionService がデフォルトで使用されます。
  - addInterceptors
```
public StandaloneMockMvcBuilder addInterceptors(HandlerInterceptor... interceptors)
```
    すべての受信リクエストにマップされたインターセプターを追加します。
  - addMappedInterceptors
```
public StandaloneMockMvcBuilder addMappedInterceptors(@Nullable
                                                      StringSE[] pathPatterns,
                                                      HandlerInterceptor... interceptors)
```
    パスパターンのセットにマッピングされたインターセプターを追加します。
  - setContentNegotiationManager
```
public StandaloneMockMvcBuilder setContentNegotiationManager(ContentNegotiationManager manager)
```
    ContentNegotiationManager を設定します。
  - setAsyncRequestTimeout
```
public StandaloneMockMvcBuilder setAsyncRequestTimeout(long timeout)
```
    非同期実行のタイムアウト値を指定します。Spring MVC テストでは、この値を使用して、非同期実行が完了するまで待機する時間を決定し、テストで結果を同期的に検証できるようにします。
    パラメーター:
    timeout - ミリ秒単位のタイムアウト値
  - setCustomArgumentResolvers
```
public StandaloneMockMvcBuilder setCustomArgumentResolvers(HandlerMethodArgumentResolver... argumentResolvers)
```
    コントローラーメソッドの引数にカスタムリゾルバーを提供します。
  - setCustomReturnValueHandlers
```
public StandaloneMockMvcBuilder setCustomReturnValueHandlers(HandlerMethodReturnValueHandler... handlers)
```
    コントローラーメソッドの戻り値のカスタムハンドラーを提供します。
  - setHandlerExceptionResolvers
```
public StandaloneMockMvcBuilder setHandlerExceptionResolvers(ListSE<HandlerExceptionResolver> exceptionResolvers)
```
    リストとして使用する HandlerExceptionResolver 型を設定します。
  - setHandlerExceptionResolvers
```
public StandaloneMockMvcBuilder setHandlerExceptionResolvers(HandlerExceptionResolver... exceptionResolvers)
```
    配列として使用する HandlerExceptionResolver 型を設定します。
  - setViewResolvers
```
public StandaloneMockMvcBuilder setViewResolvers(ViewResolver... resolvers)
```
    指定された ViewResolvers でビューリゾルバーを設定します。設定されていない場合、デフォルトで InternalResourceViewResolver が使用されます。
  - setSingleView
```
public StandaloneMockMvcBuilder setSingleView(View view)
```
    指定されたビューインスタンスを常に返す単一の ViewResolver を設定します。これは、1 つの View インスタンスのみを使用する必要がある場合に便利なショートカットです。生成されたコンテンツ（JSON、XML、Atom）のレンダリング。
  - setLocaleResolver
```
public StandaloneMockMvcBuilder setLocaleResolver(LocaleResolver localeResolver)
```
    LocaleResolver インスタンスを提供します。指定しない場合、使用されるデフォルトは AcceptHeaderLocaleResolver です。
  - setFlashMapManager
```
public StandaloneMockMvcBuilder setFlashMapManager(FlashMapManager flashMapManager)
```
    カスタム FlashMapManager インスタンスを提供します。指定しない場合、デフォルトで SessionFlashMapManager が使用されます。
  - setPatternParser
```
public void setPatternParser(PathPatternParser parser)
```
    PathMatcher を使用した文字列パターンマッチングの代わりに、解析された PathPatterns を使用した URL パスマッチングを有効にします。
    パラメーター:
    parser - 使用するパーサー
    導入:
    5.3
  - setUseSuffixPatternMatch
```
@DeprecatedSE
public StandaloneMockMvcBuilder setUseSuffixPatternMatch(boolean useSuffixPatternMatch)
```
    非推奨。5.2.4 現在。パス拡張設定オプションの廃止については、RequestMappingHandlerMapping のクラスレベルの注意を参照してください。
    パターンをリクエストに一致させるときにサフィックスパターン一致（".*" ）を使用するかどうか。有効にすると、"/users" にマップされたメソッドは "/users.*" にも一致します。
    デフォルト値は false です。
  - setUseTrailingSlashPatternMatch
```
public StandaloneMockMvcBuilder setUseTrailingSlashPatternMatch(boolean useTrailingSlashPatternMatch)
```
    末尾のスラッシュの有無に関係なく、URL と一致するかどうか。有効にすると、"/users" にマップされたメソッドは "/users/" にも一致します。
    デフォルト値は true です。
  - setRemoveSemicolonContent
```
public StandaloneMockMvcBuilder setRemoveSemicolonContent(boolean removeSemicolonContent)
```
    ";" の場合に設定（セミコロン）コンテンツはリクエスト URI から削除する必要があります。値が提供されている場合は、AbstractHandlerMapping.setRemoveSemicolonContent(boolean) に順番に設定されます。
  - addPlaceholderValue
```
public StandaloneMockMvcBuilder addPlaceholderValue(StringSE name,
                                                    StringSE value)
```
    スタンドアロンセットアップでは、リクエストマッピングに埋め込まれたプレースホルダー値のサポートはありません。このメソッドでは、手動で提供されたプレースホルダー値を使用して、解決できます。または、WebApplicationContext を初期化するテストの作成を検討してください。
    導入:
    4.2.8
  - setCustomHandlerMapping
```
public StandaloneMockMvcBuilder setCustomHandlerMapping(SupplierSE<RequestMappingHandlerMapping> factory)
```
    ファクトリを構成して、カスタム RequestMappingHandlerMapping を作成します。
    パラメーター:
    factory - ファクトリ
    導入:
    5.0
  - initWebAppContext
```
protected WebApplicationContext initWebAppContext()
```
    クラスからコピーされた説明: AbstractMockMvcBuilder
    DispatcherServlet に渡される WebApplicationContext を取得するメソッド。MockMvc インスタンスが作成される前に AbstractMockMvcBuilder.build() から呼び出されます。
    次で指定:
    クラス AbstractMockMvcBuilder<StandaloneMockMvcBuilder> の initWebAppContext
  - extendMvcSingletons
```
protected MapSE<StringSE,ObjectSE> extendMvcSingletons(@Nullable
                                                 ServletContextEE servletContext)
```
    このメソッドは、サブクラスから使用して、追加の HandlerMapping、HandlerAdapter などの追加の Spring MVC インフラストラクチャを登録できます。
    パラメーター:
    servletContext - ServletContext
    戻り値:
    追加の MVC インフラストラクチャオブジェクトインスタンスを含むマップ
    導入:
    5.1.4

クラス StandaloneMockMvcBuilder

コンストラクターのサマリー

メソッドのサマリー

クラス org.springframework.test.web.servlet.setup.AbstractMockMvcBuilder から継承されたメソッド

クラス org.springframework.test.web.servlet.MockMvcBuilderSupport から継承されたメソッド

クラス java.lang.ObjectSE から継承されたメソッド

コンストラクターの詳細

StandaloneMockMvcBuilder

メソッドの詳細

setControllerAdvice

setMessageConverters

setValidator

setConversionService

addInterceptors

addMappedInterceptors

setContentNegotiationManager

setAsyncRequestTimeout

setCustomArgumentResolvers

setCustomReturnValueHandlers

setHandlerExceptionResolvers

setHandlerExceptionResolvers

setViewResolvers

setSingleView

setLocaleResolver

setFlashMapManager

setPatternParser

setUseSuffixPatternMatch

setUseTrailingSlashPatternMatch

setRemoveSemicolonContent

addPlaceholderValue

setCustomHandlerMapping

initWebAppContext

extendMvcSingletons