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