public interface WebMvcConfigurer@EnableWebMvc を介して有効化された Spring MVC の Java ベースの構成をカスタマイズするためのコールバックメソッドを定義します。@EnableWebMvc - アノテーション付きの構成クラスは、このインターフェースを実装してコールバックし、デフォルト構成をカスタマイズする機会を与えることができます。すべてのインターフェースメソッドのスタブ実装を提供する WebMvcConfigurerAdapter を継承することを検討してください。
| 修飾子と型 | メソッドと説明 |
|---|---|
void | addArgumentResolvers(ListSE<HandlerMethodArgumentResolver> argumentResolvers) リゾルバーを追加して、カスタムコントローラーメソッドの引数型をサポートします。 |
void | addCorsMappings(CorsRegistry registry) クロスオリジンリクエストの処理を設定します。 |
void | addFormatters(FormatterRegistry registry) |
void | addInterceptors(InterceptorRegistry registry) コントローラーメソッド呼び出しの前処理および後処理用に Spring MVC ライフサイクルインターセプターを追加します。 |
void | addResourceHandlers(ResourceHandlerRegistry registry)Web アプリケーションルート、クラスパスなどの特定の場所からイメージ、js、css ファイルなどの静的リソースを提供するハンドラーを追加します。 |
void | addReturnValueHandlers(ListSE<HandlerMethodReturnValueHandler> returnValueHandlers) カスタムコントローラーメソッドの戻り値の型をサポートするハンドラーを追加します。 |
void | addViewControllers(ViewControllerRegistry registry) レスポンスステータスコードおよび / またはビューで事前構成された単純な自動コントローラーを構成して、レスポンス本文をレンダリングします。 |
void | configureAsyncSupport(AsyncSupportConfigurer configurer) 非同期リクエスト処理オプションを構成します。 |
void | configureContentNegotiation(ContentNegotiationConfigurer configurer) コンテンツネゴシエーションオプションを構成します。 |
void | configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) サーブレットコンテナーの "default" サーブレットに転送して、未処理のリクエストを委譲するハンドラーを設定します。 |
void | configureHandlerExceptionResolvers(ListSE<HandlerExceptionResolver> exceptionResolvers) 例外リゾルバーを構成します。 |
void | configureMessageConverters(ListSE<HttpMessageConverter<?>> converters) リクエストまたはレスポンスの本文の読み取りまたは書き込みに使用する HttpMessageConverter を構成します。 |
void | configurePathMatch(PathMatchConfigurer configurer) 末尾のスラッシュの一致、サフィックスの登録、パスマッチャー、パスヘルパーなどの HandlerMappings パスマッチングオプションの構成を支援します。 |
void | configureViewResolvers(ViewResolverRegistry registry) ビューリゾルバーを構成して、コントローラーから返された文字列ベースのビュー名を、レンダリングを実行する具体的な View 実装に変換します。 |
void | extendHandlerExceptionResolvers(ListSE<HandlerExceptionResolver> exceptionResolvers) デフォルトで構成された例外リゾルバーのリストを拡張または変更します。 |
void | extendMessageConverters(ListSE<HttpMessageConverter<?>> converters) 構成されたコンバーターのリストを継承または変更するためのフック。 |
MessageCodesResolver | getMessageCodesResolver() データバインディングおよび検証エラーコードからメッセージコードを構築するためのカスタム MessageCodesResolver を提供します。 |
Validator | getValidator() デフォルトで作成されたものではなく、カスタム Validator を提供します。 |
void configurePathMatch(PathMatchConfigurer configurer)
void configureContentNegotiation(ContentNegotiationConfigurer configurer)
void configureAsyncSupport(AsyncSupportConfigurer configurer)
void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer)
DispatcherServlet が "/" にマップされ、サーブレットコンテナーの静的リソースのデフォルトの処理がオーバーライドされる場合です。void addFormatters(FormatterRegistry registry)
void addInterceptors(InterceptorRegistry registry)
ここに登録されているインターセプターはコントローラーにのみ適用され、リソースハンドラーリクエストには適用されないことに注意してください。静的リソースのリクエストをインターセプトするには、MappedInterceptor Bean を宣言するか、WebMvcConfigurationSupport を継承して詳細構成モードに切り替えてから、resourceHandlerMapping をオーバーライドします。
void addResourceHandlers(ResourceHandlerRegistry registry)
void addCorsMappings(CorsRegistry registry)
void addViewControllers(ViewControllerRegistry registry)
void configureViewResolvers(ViewResolverRegistry registry)
View 実装に変換します。void addArgumentResolvers(ListSE<HandlerMethodArgumentResolver> argumentResolvers)
これは、ハンドラーメソッドの引数を解決するための組み込みサポートをオーバーライドしません。引数解決の組み込みサポートをカスタマイズするには、RequestMappingHandlerAdapter を直接構成します。
argumentResolvers - 最初は空のリスト void addReturnValueHandlers(ListSE<HandlerMethodReturnValueHandler> returnValueHandlers)
このオプションを使用しても、戻り値を処理するための組み込みのサポートは無効になりません。戻り値を処理するための組み込みサポートをカスタマイズするには、RequestMappingHandlerAdapter を直接構成します。
returnValueHandlers - 最初は空のリスト void configureMessageConverters(ListSE<HttpMessageConverter<?>> converters)
HttpMessageConverter を構成します。コンバーターが追加されていない場合、コンバーターのデフォルトのリストが登録されます。 リストにコンバーターを追加すると、デフォルトのコンバーター登録がオフになることに注意してください。デフォルトの登録に影響を与えずにコンバーターを単に追加するには、代わりにメソッド extendMessageConverters(java.util.List) の使用を検討してください。
converters - 最初は空のコンバーターのリスト void extendMessageConverters(ListSE<HttpMessageConverter<?>> converters)
converters - 拡張する構成済みコンバーターのリスト。void configureHandlerExceptionResolvers(ListSE<HandlerExceptionResolver> exceptionResolvers)
指定されたリストは空で始まります。空のままにすると、フレームワークはデフォルトのリゾルバーのセットを構成します。WebMvcConfigurationSupport.addDefaultHandlerExceptionResolvers(List) を参照してください。または、例外リゾルバーがリストに追加された場合、アプリケーションが効果的に引き継ぎ、完全に初期化された例外リゾルバーを提供する必要があります。
あるいは、extendHandlerExceptionResolvers(List) を使用して、デフォルトで構成された例外リゾルバーのリストを継承または変更できます。
exceptionResolvers - 最初は空のリスト extendHandlerExceptionResolvers(List), WebMvcConfigurationSupport.addDefaultHandlerExceptionResolvers(List)void extendHandlerExceptionResolvers(ListSE<HandlerExceptionResolver> exceptionResolvers)
exceptionResolvers - 拡張する構成済みリゾルバーのリスト WebMvcConfigurationSupport.addDefaultHandlerExceptionResolvers(List)Validator getValidator()
Validator を提供します。JSR-303 がクラスパス上にあると仮定した場合のデフォルトの実装は、OptionalValidatorFactoryBean です。戻り値を null のままにして、デフォルトのままにします。MessageCodesResolver getMessageCodesResolver()
MessageCodesResolver を提供します。戻り値を null のままにして、デフォルトのままにします。