クラス WebMvcConfigurationSupport

メソッドの詳細

• setApplicationContext

  public void setApplicationContext(@Nullable ApplicationContext applicationContext)

  Spring ApplicationContext を設定します。リソース読み込み用。

  次で指定:

  インターフェース ApplicationContextAware の setApplicationContext 

  パラメーター:

  applicationContext - このオブジェクトによって使用される ApplicationContext オブジェクト

  関連事項:

  • BeanInitializationException

• getApplicationContext

  @Nullable public final ApplicationContext getApplicationContext()

  関連する Spring ApplicationContext を返します。

  導入:

  4.2

• setServletContext

  public void setServletContext(@Nullable ServletContextEE servletContext)

  ServletContextEE を設定します。リソースの処理、ファイル拡張子の検索など。

  次で指定:

  インターフェース ServletContextAware の setServletContext 

  パラメーター:

  servletContext - このオブジェクトによって使用される ServletContext オブジェクト

  関連事項:

  • InitializingBean.afterPropertiesSet()
  • ApplicationContextAware.setApplicationContext(org.springframework.context.ApplicationContext)

• getServletContext

  @Nullable public final ServletContextEE getServletContext()

  関連する ServletContextEE を返します。

  導入:

  4.2

• requestMappingHandlerMapping

  @Bean public RequestMappingHandlerMapping requestMappingHandlerMapping(@Qualifier("mvcContentNegotiationManager") ContentNegotiationManager contentNegotiationManager, @Qualifier("mvcConversionService") FormattingConversionService conversionService, @Qualifier("mvcResourceUrlProvider") ResourceUrlProvider resourceUrlProvider)

  リクエストをアノテーション付きコントローラーにマッピングするために、0 で順序付けされた RequestMappingHandlerMapping を返します。

• createRequestMappingHandlerMapping

  protected RequestMappingHandlerMapping createRequestMappingHandlerMapping()

  RequestMappingHandlerMapping のカスタムサブクラスにプラグインするための protected メソッド。

  導入:

  4.0

• getInterceptors

  protected final ObjectSE[] getInterceptors(FormattingConversionService mvcConversionService, ResourceUrlProvider mvcResourceUrlProvider)

  HandlerMapping インスタンスの構成に使用される共有ハンドラーインターセプターへのアクセスを提供します。

  このメソッドはオーバーライドできません。代わりに addInterceptors(org.springframework.web.servlet.config.annotation.InterceptorRegistry) を使用してください。

• addInterceptors

  protected void addInterceptors(InterceptorRegistry registry)

  このメソッドをオーバーライドして、コントローラー呼び出しの前後処理用に Spring MVC インターセプターを追加します。

  関連事項:

  • InterceptorRegistry

• getPathMatchConfigurer

  protected PathMatchConfigurer getPathMatchConfigurer()

  PathMatchConfigurer をビルドするためのコールバック。configurePathMatch(org.springframework.web.servlet.config.annotation.PathMatchConfigurer) へのデリゲート。

  導入:

  4.1

• configurePathMatch

  protected void configurePathMatch(PathMatchConfigurer configurer)

  パス一致オプションを構成するには、このメソッドをオーバーライドします。

  導入:

  4.0.3

  関連事項:

  • PathMatchConfigurer

• mvcPatternParser

  @Bean public PathPatternParser mvcPatternParser()

  RequestPath に一致するパターンの解析に使用するグローバル PathPatternParser インスタンスを返します。返されるインスタンスは、configurePathMatch(PathMatchConfigurer) を使用して構成できます。

  導入:

  5.3.4

• mvcUrlPathHelper

  @Bean public UrlPathHelper mvcUrlPathHelper()

  アプリケーションのリクエストマッピングパスを解決するために使用されるグローバル UrlPathHelper インスタンスを返します。インスタンスは configurePathMatch(PathMatchConfigurer) を介して構成できます。

  注意 : これは、解析されたパターンが enabled でない場合にのみ使用されます。

  導入:

  4.1

• mvcPathMatcher

  @Bean public PathMatcher mvcPathMatcher()

  文字列パターンとの URL パスマッチングに使用されるグローバル PathMatcher インスタンスを返します。返されるインスタンスは、configurePathMatch(PathMatchConfigurer) を使用して構成できます。

  注意 : これは、解析されたパターンが enabled でない場合にのみ使用されます。

  導入:

  4.1

• mvcContentNegotiationManager

  @Bean public ContentNegotiationManager mvcContentNegotiationManager()

  指定されたリクエストでリクエストされたメディア型を判別するために使用する ContentNegotiationManager インスタンスを返します。

• getDefaultMediaTypes

  protected MapSE<StringSE,MediaType> getDefaultMediaTypes()

• configureContentNegotiation

  protected void configureContentNegotiation(ContentNegotiationConfigurer configurer)

  コンテンツネゴシエーションを構成するには、このメソッドをオーバーライドします。

  関連事項:

  • DefaultServletHandlerConfigurer

• viewControllerHandlerMapping

  @Bean @Nullable public HandlerMapping viewControllerHandlerMapping(@Qualifier("mvcConversionService") FormattingConversionService conversionService, @Qualifier("mvcResourceUrlProvider") ResourceUrlProvider resourceUrlProvider)

  URL パスをビュー名に直接マップするために 1 の順序でハンドラーマッピングを返します。ビューコントローラーを構成するには、addViewControllers(org.springframework.web.servlet.config.annotation.ViewControllerRegistry) をオーバーライドします。

• addViewControllers

  protected void addViewControllers(ViewControllerRegistry registry)

  このメソッドをオーバーライドして、ビューコントローラーを追加します。

  関連事項:

  • ViewControllerRegistry

• beanNameHandlerMapping

  @Bean public BeanNameUrlHandlerMapping beanNameHandlerMapping(@Qualifier("mvcConversionService") FormattingConversionService conversionService, @Qualifier("mvcResourceUrlProvider") ResourceUrlProvider resourceUrlProvider)

  URL パスをコントローラー Bean 名にマップするには、2 で順序付けされた BeanNameUrlHandlerMapping を返します。

• routerFunctionMapping

  @Bean public RouterFunctionMapping routerFunctionMapping(@Qualifier("mvcConversionService") FormattingConversionService conversionService, @Qualifier("mvcResourceUrlProvider") ResourceUrlProvider resourceUrlProvider)

  ルーター関数をマップするために、-1 で順序付けされた RouterFunctionMapping を返します。他のより詳細なメソッドのいずれかをオーバーライドすることを検討してください。

  • ハンドラーインターセプタを追加するための addInterceptors(org.springframework.web.servlet.config.annotation.InterceptorRegistry)。
  • addCorsMappings(org.springframework.web.servlet.config.annotation.CorsRegistry) は、クロスオリジンリクエスト処理を構成します。
  • カスタムメッセージコンバーターを追加するための configureMessageConverters(java.util.List<org.springframework.http.converter.HttpMessageConverter<?>>)。
  • PathPatternParser をカスタマイズするための configurePathMatch(PathMatchConfigurer)。

  導入:

  5.2

• resourceHandlerMapping

  @Bean @Nullable public HandlerMapping resourceHandlerMapping(@Qualifier("mvcContentNegotiationManager") ContentNegotiationManager contentNegotiationManager, @Qualifier("mvcConversionService") FormattingConversionService conversionService, @Qualifier("mvcResourceUrlProvider") ResourceUrlProvider resourceUrlProvider)

  マップされたリソースハンドラーと共に Integer.MAX_VALUE-1 で順序付けされたハンドラーマッピングを返します。リソース処理を構成するには、addResourceHandlers(org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry) をオーバーライドします。

• addResourceHandlers

  protected void addResourceHandlers(ResourceHandlerRegistry registry)

  このメソッドをオーバーライドして、静的リソースを提供するためのリソースハンドラーを追加します。

  関連事項:

  • ResourceHandlerRegistry

• mvcResourceUrlProvider

  @Bean public ResourceUrlProvider mvcResourceUrlProvider()

  MVC ディスパッチャーで使用する ResourceUrlProvider Bean。

  導入:

  4.1

• defaultServletHandlerMapping

  @Bean @Nullable public HandlerMapping defaultServletHandlerMapping()

  マップされたデフォルトのサーブレットハンドラーを使用して、Integer.MAX_VALUE で順序付けされたハンドラーマッピングを返します。"default" サーブレット処理を構成するには、configureDefaultServletHandling(org.springframework.web.servlet.config.annotation.DefaultServletHandlerConfigurer) をオーバーライドします。

• configureDefaultServletHandling

  protected void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer)

  このメソッドをオーバーライドして、"default" サーブレット処理を構成します。

  関連事項:

  • DefaultServletHandlerConfigurer

• requestMappingHandlerAdapter

  @Bean public RequestMappingHandlerAdapter requestMappingHandlerAdapter(@Qualifier("mvcContentNegotiationManager") ContentNegotiationManager contentNegotiationManager, @Qualifier("mvcConversionService") FormattingConversionService conversionService, @Qualifier("mvcValidator") Validator validator)

  アノテーション付きコントローラーメソッドを介してリクエストを処理するための RequestMappingHandlerAdapter を返します。これらの他のよりきめの細かいメソッドの 1 つをオーバーライドすることを検討してください。

  • カスタム引数リゾルバーを追加するための addArgumentResolvers(java.util.List<org.springframework.web.method.support.HandlerMethodArgumentResolver>)。
  • カスタム戻り値ハンドラーを追加するための addReturnValueHandlers(java.util.List<org.springframework.web.method.support.HandlerMethodReturnValueHandler>)。
  • カスタムメッセージコンバーターを追加するための configureMessageConverters(java.util.List<org.springframework.http.converter.HttpMessageConverter<?>>)。

• createRequestMappingHandlerAdapter

  protected RequestMappingHandlerAdapter createRequestMappingHandlerAdapter()

  RequestMappingHandlerAdapter のカスタムサブクラスにプラグインするための protected メソッド。

  導入:

  4.3

• handlerFunctionAdapter

  @Bean public HandlerFunctionAdapter handlerFunctionAdapter()

  ハンドラー関数を介してリクエストを処理する場合は、HandlerFunctionAdapter を返します。

  導入:

  5.2

• getConfigurableWebBindingInitializer

  protected ConfigurableWebBindingInitializer getConfigurableWebBindingInitializer(FormattingConversionService mvcConversionService, Validator mvcValidator)

  すべての WebDataBinder インスタンスの初期化に使用する ConfigurableWebBindingInitializer を返します。

• getMessageCodesResolver

  @Nullable protected MessageCodesResolver getMessageCodesResolver()

  このメソッドをオーバーライドして、カスタム MessageCodesResolver を提供します。

• mvcConversionService

  @Bean public FormattingConversionService mvcConversionService()

  アノテーション付きコントローラーで使用するために FormattingConversionService を返します。

  このメソッドをオーバーライドする代わりの方法として addFormatters(org.springframework.format.FormatterRegistry) を参照してください。

• addFormatters

  protected void addFormatters(FormatterRegistry registry)

  このメソッドをオーバーライドして、共通の FormattingConversionService にカスタム Converter および / または Formatter デリゲートを追加します。

  関連事項:

  • mvcConversionService()

• mvcValidator

  @Bean public Validator mvcValidator()

  たとえば、@ModelAttribute および @RequestBody メソッドの引数を検証するために、グローバル Validator インスタンスを返します。最初に getValidator() にデリゲートし、それが null を返す場合、OptionalValidatorFactoryBean を作成する前にクラスパスで JSR-303 実装が存在するかどうかを確認します。JSR-303 実装が使用できない場合は、no-op Validator が返されます。

• getValidator

  @Nullable protected Validator getValidator()

  このメソッドをオーバーライドして、カスタム Validator を提供します。

• getArgumentResolvers

  protected final ListSE<HandlerMethodArgumentResolver> getArgumentResolvers()

  RequestMappingHandlerAdapter および ExceptionHandlerExceptionResolver が使用する共有カスタム引数リゾルバーへのアクセスを提供します。

  このメソッドはオーバーライドできません。代わりに addArgumentResolvers(java.util.List<org.springframework.web.method.support.HandlerMethodArgumentResolver>) を使用してください。

  導入:

  4.3

• addArgumentResolvers

  protected void addArgumentResolvers(ListSE<HandlerMethodArgumentResolver> argumentResolvers)

  デフォルトで登録されているものに加えて、使用するカスタム HandlerMethodArgumentResolvers を追加します。

  カスタム引数リゾルバーは、アノテーションの存在に依存するもの（@RequestParameter、@PathVariable など）を除いて、組み込みのリゾルバーの前に呼び出されます。後者は、RequestMappingHandlerAdapter を直接構成することでカスタマイズできます。

  パラメーター:

  argumentResolvers - カスタムコンバーターのリスト (最初は空のリスト)

• getReturnValueHandlers

  protected final ListSE<HandlerMethodReturnValueHandler> getReturnValueHandlers()

  RequestMappingHandlerAdapter および ExceptionHandlerExceptionResolver で使用される共有戻り値ハンドラーへのアクセスを提供します。

  このメソッドはオーバーライドできません。代わりに addReturnValueHandlers(java.util.List<org.springframework.web.method.support.HandlerMethodReturnValueHandler>) を使用してください。

  導入:

  4.3

• addReturnValueHandlers

  protected void addReturnValueHandlers(ListSE<HandlerMethodReturnValueHandler> returnValueHandlers)

  デフォルトで登録されているものに加えて、カスタム HandlerMethodReturnValueHandlers を追加します。

  カスタム戻り値ハンドラーは、アノテーションの存在に依存するハンドラー（@ResponseBody、@ModelAttribute など）を除いて、組み込みハンドラーの前に呼び出されます。後者は、RequestMappingHandlerAdapter を直接構成することでカスタマイズできます。

  パラメーター:

  returnValueHandlers - カスタムハンドラーのリスト (最初は空のリスト)

• getMessageConverters

  protected final ListSE<HttpMessageConverter<?>> getMessageConverters()

  RequestMappingHandlerAdapter および ExceptionHandlerExceptionResolver が使用する共有 HttpMessageConverters へのアクセスを提供します。

  このメソッドはオーバーライドできません。代わりに configureMessageConverters(java.util.List<org.springframework.http.converter.HttpMessageConverter<?>>) を使用してください。デフォルトのメッセージコンバーターの追加については、addDefaultHttpMessageConverters(java.util.List<org.springframework.http.converter.HttpMessageConverter<?>>) も参照してください。

• configureMessageConverters

  protected void configureMessageConverters(ListSE<HttpMessageConverter<?>> converters)

  RequestMappingHandlerAdapter および ExceptionHandlerExceptionResolver で使用するカスタム HttpMessageConverters を追加するには、このメソッドをオーバーライドします。

  リストにコンバーターを追加すると、デフォルトで登録されるデフォルトのコンバーターがオフになります。デフォルトのメッセージコンバーターの追加については、addDefaultHttpMessageConverters(java.util.List<org.springframework.http.converter.HttpMessageConverter<?>>) も参照してください。

  パラメーター:

  converters - メッセージコンバーターを追加するリスト (最初は空のリスト)

• extendMessageConverters

  protected void extendMessageConverters(ListSE<HttpMessageConverter<?>> converters)

  このメソッドをオーバーライドして、構成後にコンバーターのリストを継承または変更します。これは、デフォルトのコンバーターを登録して、このメソッドを介してカスタムコンバーターを挿入できるようにする場合などに役立ちます。

  パラメーター:

  converters - 拡張する構成済みコンバーターのリスト

  導入:

  4.1.3

• addDefaultHttpMessageConverters

  protected final void addDefaultHttpMessageConverters(ListSE<HttpMessageConverter<?>> messageConverters)

  指定されたリストにデフォルトの HttpMessageConverter インスタンスのセットを追加します。サブクラスは configureMessageConverters(java.util.List<org.springframework.http.converter.HttpMessageConverter<?>>) からこのメソッドを呼び出すことができます。

  パラメーター:

  messageConverters - デフォルトのメッセージコンバーターを追加するリスト

• getAsyncSupportConfigurer

  protected AsyncSupportConfigurer getAsyncSupportConfigurer()

  AsyncSupportConfigurer をビルドするためのコールバック。configureAsyncSupport(AsyncSupportConfigurer) へのデリゲート。

  導入:

  5.3.2

• configureAsyncSupport

  protected void configureAsyncSupport(AsyncSupportConfigurer configurer)

  このメソッドをオーバーライドして、非同期リクエスト処理オプションを構成します。

  関連事項:

  • AsyncSupportConfigurer

• mvcUriComponentsContributor

  @Bean public CompositeUriComponentsContributor mvcUriComponentsContributor(@Qualifier("mvcConversionService") FormattingConversionService conversionService, @Qualifier("requestMappingHandlerAdapter") RequestMappingHandlerAdapter requestMappingHandlerAdapter)

  MvcUriComponentsBuilder で使用するために CompositeUriComponentsContributor のインスタンスを返します。

  導入:

  4.0

• httpRequestHandlerAdapter

  @Bean public HttpRequestHandlerAdapter httpRequestHandlerAdapter()

  HttpRequestHandlers でリクエストを処理するために HttpRequestHandlerAdapter を返します。

• simpleControllerHandlerAdapter

  @Bean public SimpleControllerHandlerAdapter simpleControllerHandlerAdapter()

  インターフェースベースのコントローラーでリクエストを処理するための SimpleControllerHandlerAdapter を返します。

• handlerExceptionResolver

  @Bean public HandlerExceptionResolver handlerExceptionResolver(@Qualifier("mvcContentNegotiationManager") ContentNegotiationManager contentNegotiationManager)

  configureHandlerExceptionResolvers(java.util.List<org.springframework.web.servlet.HandlerExceptionResolver>) または addDefaultHandlerExceptionResolvers(java.util.List<org.springframework.web.servlet.HandlerExceptionResolver>, org.springframework.web.accept.ContentNegotiationManager) のいずれかで取得した例外リゾルバーのリストを含む HandlerExceptionResolverComposite を返します。

  注意 : この方法は、CGLIB の制約により、最終的にすることはできません。それをオーバーライドするのではなく、リゾルバーのリストを提供できる configureHandlerExceptionResolvers(java.util.List<org.springframework.web.servlet.HandlerExceptionResolver>) をオーバーライドすることを検討してください。

• configureHandlerExceptionResolvers

  protected void configureHandlerExceptionResolvers(ListSE<HandlerExceptionResolver> exceptionResolvers)

  使用する HandlerExceptionResolvers のリストを構成するには、このメソッドをオーバーライドします。

  リストにリゾルバーを追加すると、デフォルトで登録されるデフォルトのリゾルバーがオフになります。デフォルトの例外リゾルバーを追加するために使用できる addDefaultHandlerExceptionResolvers(java.util.List<org.springframework.web.servlet.HandlerExceptionResolver>, org.springframework.web.accept.ContentNegotiationManager) も参照してください。

  パラメーター:

  exceptionResolvers - 例外リゾルバーを追加するリスト (最初は空のリスト)

• extendHandlerExceptionResolvers

  protected void extendHandlerExceptionResolvers(ListSE<HandlerExceptionResolver> exceptionResolvers)

  HandlerExceptionResolvers の構成後にリストを継承または変更するには、このメソッドをオーバーライドします。

  これは、たとえば、デフォルトのリゾルバーを登録し、このメソッドを介してカスタムのリゾルバーを挿入できるようにする場合に便利です。

  パラメーター:

  exceptionResolvers - 拡張する構成済みリゾルバーのリスト。

  導入:

  4.3

• addDefaultHandlerExceptionResolvers

  protected final void addDefaultHandlerExceptionResolvers(ListSE<HandlerExceptionResolver> exceptionResolvers, ContentNegotiationManager mvcContentNegotiationManager)

  デフォルトの HandlerExceptionResolvers を追加するためにサブクラスで使用できるメソッド。

  次の例外リゾルバーを追加します。

  • ExceptionHandler メソッドを介して例外を処理するための ExceptionHandlerExceptionResolver。
  • ResponseStatus でアノテーションされた例外の場合は ResponseStatusExceptionResolver。
  • 既知の Spring 例外型を解決するための DefaultHandlerExceptionResolver

• createExceptionHandlerExceptionResolver

  protected ExceptionHandlerExceptionResolver createExceptionHandlerExceptionResolver()

  ExceptionHandlerExceptionResolver のカスタムサブクラスにプラグインするための protected メソッド。

  導入:

  4.3

• mvcViewResolver

  @Bean public ViewResolver mvcViewResolver(@Qualifier("mvcContentNegotiationManager") ContentNegotiationManager contentNegotiationManager)

  ビューの解決に使用するビューリゾルバーのチェーンを含む ViewResolverComposite を登録します。デフォルトでは、コンテンツネゴシエーションビューの解決が使用されていない限り、このリゾルバーは 0 で順序付けられます。使用されている場合、順序は Ordered.HIGHEST_PRECEDENCE にプルアップられます。

  他のリゾルバーが構成されていない場合、他の潜在的な ViewResolver Bean がビューを解決できるようにするために、ViewResolverComposite.resolveViewName(String, Locale) は null を返します。

  導入:

  4.1

• configureViewResolvers

  protected void configureViewResolvers(ViewResolverRegistry registry)

  このメソッドをオーバーライドして、ビューリゾルバーを構成します。

  関連事項:

  • ViewResolverRegistry

• getCorsConfigurations

  protected final MapSE<StringSE,CorsConfiguration> getCorsConfigurations()

  パスパターンをキーとして、登録されている CorsConfiguration オブジェクトを返します。

  導入:

  4.2

• addCorsMappings

  protected void addCorsMappings(CorsRegistry registry)

  このメソッドをオーバーライドして、クロスオリジンリクエスト処理を構成します。

  導入:

  4.2

  関連事項:

  • CorsRegistry

• mvcHandlerMappingIntrospector

  @Bean @Lazy public HandlerMappingIntrospector mvcHandlerMappingIntrospector()

• localeResolver

  @Bean public LocaleResolver localeResolver()

• themeResolver

  @Bean @DeprecatedSE public ThemeResolver themeResolver()

  使用すべきではありません。

• flashMapManager

  @Bean public FlashMapManager flashMapManager()

• viewNameTranslator

  @Bean public RequestToViewNameTranslator viewNameTranslator()