コンストラクターの詳細

• AbstractHandlerMapping

  public AbstractHandlerMapping()

メソッドの詳細

• setDefaultHandler

  public void setDefaultHandler(@Nullable
                                ObjectSE defaultHandler)

  このハンドラーマッピングのデフォルトハンドラーを設定します。特定のマッピングが見つからなかった場合、このハンドラーが返されます。

  デフォルトは null で、デフォルトのハンドラーがないことを示します。

• getDefaultHandler

  @Nullable
  public ObjectSE getDefaultHandler()

  このハンドラーマッピングのデフォルトハンドラーを返します。ない場合は null を返します。

• setAlwaysUseFullPath

  public void setAlwaysUseFullPath(boolean alwaysUseFullPath)

  基になる UrlPathHelper の同じプロパティへのショートカット。

  関連事項:

  UrlPathHelper.setAlwaysUseFullPath(boolean)

• setUrlDecode

  public void setUrlDecode(boolean urlDecode)

  基になる UrlPathHelper の同じプロパティへのショートカット。

  関連事項:

  UrlPathHelper.setUrlDecode(boolean)

• setRemoveSemicolonContent

  public void setRemoveSemicolonContent(boolean removeSemicolonContent)

  基になる UrlPathHelper の同じプロパティへのショートカット。

  関連事項:

  UrlPathHelper.setRemoveSemicolonContent(boolean)

• setUrlPathHelper

  public void setUrlPathHelper(UrlPathHelper urlPathHelper)

  ルックアップパスの解決に使用する UrlPathHelper を設定します。

  これを使用して、デフォルトの UrlPathHelper をカスタムサブクラスでオーバーライドするか、複数の HandlerMappings および MethodNameResolvers で共通の UrlPathHelper 設定を共有します。

• getUrlPathHelper

  public UrlPathHelper getUrlPathHelper()

  ルックアップパスの解決に使用する UrlPathHelper 実装を返します。

• setPathMatcher

  public void setPathMatcher(PathMatcher pathMatcher)

  登録された URL パターンに対する URL パスのマッチングに使用する PathMatcher 実装を設定します。デフォルトは AntPathMatcher です。

  関連事項:

  AntPathMatcher

• getPathMatcher

  public PathMatcher getPathMatcher()

  登録された URL パターンに対して URL パスを照合するために使用する PathMatcher 実装を返します。

• setInterceptors

  public void setInterceptors(ObjectSE... interceptors)

  このハンドラーマッピングによってマップされたすべてのハンドラーに適用するインターセプターを設定します。

  サポートされるインターセプター型は、HandlerInterceptor、WebRequestInterceptor、MappedInterceptor です。マップされたインターセプターは、そのパスパターンに一致するリクエスト URL にのみ適用されます。マップされたインターセプター Bean も、初期化中に型ごとに検出されます。

  パラメーター:

  interceptors - ハンドラーインターセプターの配列

  関連事項:

  adaptInterceptor(java.lang.Object), HandlerInterceptor, WebRequestInterceptor

• setCorsConfigurations

  public void setCorsConfigurations(MapSE<StringSE,CorsConfiguration> corsConfigurations)

  URL パターンに基づいて「グローバル」CORS 構成を設定します。デフォルトでは、最初に一致する URL パターンは、ハンドラーの CORS 構成（存在する場合）と結合されます。

  導入:

  4.2

  関連事項:

  setCorsConfigurationSource(CorsConfigurationSource)

• setCorsConfigurationSource

  public void setCorsConfigurationSource(CorsConfigurationSource corsConfigurationSource)

  「グローバル」CORS 構成ソースを設定します。デフォルトでは、最初に一致する URL パターンは、ハンドラーの CORS 構成（存在する場合）と結合されます。

  導入:

  5.1

  関連事項:

  setCorsConfigurations(Map)

• setCorsProcessor

  public void setCorsProcessor(CorsProcessor corsProcessor)

  一致する CorsConfiguration をリクエストに適用するために使用するカスタム CorsProcessor を構成します。

  デフォルトでは、DefaultCorsProcessor が使用されます。

  導入:

  4.2

• getCorsProcessor

  public CorsProcessor getCorsProcessor()

  設定された CorsProcessor を返します。

• setOrder

  public void setOrder(int order)

  この HandlerMapping Bean の順序値を指定します。

  デフォルト値は Ordered.LOWEST_PRECEDENCE で、順序なしを意味します。

  関連事項:

  Ordered.getOrder()

• getOrder

  public int getOrder()

  インターフェースからコピーされた説明: Ordered
  このオブジェクトの順序値を取得します。

  値が高いほど、優先度は低くなります。結果として、最も低い値を持つオブジェクトが最高の優先度を持ちます（サーブレット load-on-startup の値に多少似ています）。

  同じ順序の値は、影響を受けるオブジェクトの任意のソート位置になります。

  次で指定:

  インターフェース Ordered の getOrder 

  戻り値:

  オーダー額

  関連事項:

  Ordered.HIGHEST_PRECEDENCE, Ordered.LOWEST_PRECEDENCE

• setBeanName

  public void setBeanName(StringSE name)

  インターフェースからコピーされた説明: BeanNameAware
  この Bean を作成した Bean ファクトリで Bean の名前を設定します。

  通常の Bean プロパティの設定後、ただし InitializingBean.afterPropertiesSet() またはカスタム init メソッドなどの init コールバックの前に呼び出されます。

  次で指定:

  インターフェース BeanNameAware の setBeanName 

  パラメーター:

  name - ファクトリ内の Bean の名前。この名前は、ファクトリで使用される実際の Bean 名であり、最初に指定した名前とは異なる場合があります。特に内部 Bean 名の場合、実際の Bean 名は "#..." サフィックスを追加することで一意になります。必要に応じて、BeanFactoryUtils.originalBeanName(String) メソッドを使用して、元の Bean 名（サフィックスなし）を抽出します。

• formatMappingName

  protected StringSE formatMappingName()

• initApplicationContext

  protected void initApplicationContext()
                                 throws BeansException

  インターセプターを初期化します。

  オーバーライド:

  クラス ApplicationObjectSupport の initApplicationContext 

  例外:

  ApplicationContextException - 初期化エラーの場合

  BeansException - ApplicationContext メソッドによってスローされた場合

  関連事項:

  extendInterceptors(java.util.List), initInterceptors()

• extendInterceptors

  protected void extendInterceptors(ListSE<ObjectSE> interceptors)

  構成されたインターセプター（setInterceptors(java.lang.Object...) を参照）を指定すると、サブクラスがオーバーライドして追加のインターセプターを登録できる拡張フック。

  initInterceptors() が指定されたインターセプターを HandlerInterceptor インスタンスに適応させる前に呼び出されます。

  デフォルトの実装は空です。

  パラメーター:

  interceptors - 構成されたインターセプターリスト（非 null）。既存のインターセプターの前後にインターセプターを追加できます

• detectMappedInterceptors

  protected void detectMappedInterceptors(ListSE<HandlerInterceptor> mappedInterceptors)

  型 MappedInterceptor の Bean を検出し、マッピングされたインターセプターのリストに追加します。

  これは、setInterceptors(java.lang.Object...) を介して提供されたすべての MappedInterceptor に加えて呼び出され、デフォルトで、現在のコンテキストとその祖先から型 MappedInterceptor のすべての Bean を追加します。サブクラスはこのポリシーをオーバーライドおよび調整できます。

  パラメーター:

  mappedInterceptors - 追加する空のリスト

• initInterceptors

  protected void initInterceptors()

  WebRequestInterceptor を HandlerInterceptor に適応させる指定されたインターセプターを初期化します。

  関連事項:

  setInterceptors(java.lang.Object...), adaptInterceptor(java.lang.Object)

• adaptInterceptor

  protected HandlerInterceptor adaptInterceptor(ObjectSE interceptor)

  指定されたインターセプターオブジェクトを HandlerInterceptor に適合させます。

  デフォルトでは、サポートされるインターセプター型は HandlerInterceptor および WebRequestInterceptor です。指定された各 WebRequestInterceptor は WebRequestHandlerInterceptorAdapter でラップされます。

  パラメーター:

  interceptor - インターセプター

  戻り値:

  インターセプターダウンキャストまたは HandlerInterceptor に適合

  関連事項:

  HandlerInterceptor, WebRequestInterceptor, WebRequestHandlerInterceptorAdapter

• getAdaptedInterceptors

  @Nullable
  protected final HandlerInterceptor[] getAdaptedInterceptors()

  適応インターセプターを HandlerInterceptor 配列として返します。

  戻り値:

  HandlerInterceptor の配列。ない場合は null 

• getMappedInterceptors

  @Nullable
  protected final MappedInterceptor[] getMappedInterceptors()

  構成されたすべての MappedInterceptor を配列として返します。

  戻り値:

  MappedInterceptor の配列。ない場合は null 

• getHandler

  @Nullable
  public final HandlerExecutionChain getHandler(HttpServletRequestEE request)
                                                   throws ExceptionSE

  特定のリクエストのハンドラーを検索し、特定のハンドラーが見つからない場合はデフォルトのハンドラーにフォールバックします。

  次で指定:

  インターフェース HandlerMapping の getHandler 

  パラメーター:

  request - 現在の HTTP リクエスト

  戻り値:

  対応するハンドラーインスタンス、またはデフォルトハンドラー

  例外:

  ExceptionSE - 内部エラーがある場合

  関連事項:

  getHandlerInternal(javax.servlet.http.HttpServletRequest)

• getHandlerInternal

  @Nullable
  protected abstract ObjectSE getHandlerInternal(HttpServletRequestEE request)
                                                  throws ExceptionSE

  特定のリクエストのハンドラーを検索し、特定のリクエストが見つからない場合は null を返します。このメソッドは getHandler(javax.servlet.http.HttpServletRequest) によって呼び出されます。null の戻り値は、デフォルトのハンドラー（設定されている場合）につながります。

  CORS プリフライトリクエストでは、このメソッドはプリフライトリクエストではなく、URL パス、"Access-Control-Request-Method" ヘッダーからの HTTP メソッド、ヘッダーに基づいて予想される実際のリクエストに対して一致を返す必要があります "Access-Control-Request-Headers" ヘッダーから、getCorsConfiguration(Object, HttpServletRequest) を介して CORS 設定を取得できるようにします。

  メモ: このメソッドは、ハンドラーオブジェクトと動的に決定されたインターセプターを組み合わせて、事前に構築された HandlerExecutionChain を返すこともあります。静的に指定されたインターセプターは、そのような既存のチェーンにマージされます。

  パラメーター:

  request - 現在の HTTP リクエスト

  戻り値:

  対応するハンドラーインスタンス。見つからない場合は null 

  例外:

  ExceptionSE - 内部エラーがある場合

• getHandlerExecutionChain

  protected HandlerExecutionChain getHandlerExecutionChain(ObjectSE handler,
                                                           HttpServletRequestEE request)

  該当するインターセプターを含む、指定されたハンドラー用の HandlerExecutionChain を作成します。

  デフォルトの実装では、指定されたハンドラー、ハンドラーマッピングの共通インターセプター、現在のリクエスト URL に一致する MappedInterceptors を使用して、標準の HandlerExecutionChain を構築します。インターセプターは、登録された順に追加されます。サブクラスは、インターセプターのリストを継承 / 再配置するためにこれをオーバーライドできます。

  注意 : 渡されたハンドラーオブジェクトは、生のハンドラーまたは事前に作成された HandlerExecutionChain の場合があります。このメソッドは、新しい HandlerExecutionChain の構築または既存のチェーンの拡張のいずれかで、これら 2 つのケースを明示的に処理する必要があります。

  カスタムサブクラスにインターセプターを単純に追加するには、super.getHandlerExecutionChain(handler, request) を呼び出し、返されたチェーンオブジェクトで HandlerExecutionChain.addInterceptor(org.springframework.web.servlet.HandlerInterceptor) を呼び出すことを検討してください。

  パラメーター:

  handler - 解決されたハンドラーインスタンス (非 null)

  request - 現在の HTTP リクエスト

  戻り値:

  HandlerExecutionChain (非 null)

  関連事項:

  getAdaptedInterceptors()

• hasCorsConfigurationSource

  protected boolean hasCorsConfigurationSource(ObjectSE handler)

  このハンドラーに CorsConfigurationSource がある場合、true を返します。

  導入:

  5.2

• getCorsConfiguration

  @Nullable
  protected CorsConfiguration getCorsConfiguration(ObjectSE handler,
                                                             HttpServletRequestEE request)

  指定されたハンドラーの CORS 構成を取得します。

  パラメーター:

  handler - チェックするハンドラー（非 null）。

  request - 現在のリクエスト。

  戻り値:

  ハンドラーの CORS 構成、ない場合は null 

  導入:

  4.2

• getCorsHandlerExecutionChain

  protected HandlerExecutionChain getCorsHandlerExecutionChain(HttpServletRequestEE request,
                                                               HandlerExecutionChain chain,
                                                               @Nullable
                                                               CorsConfiguration config)

  CORS 関連の処理のために HandlerExecutionChain を更新します。

  プリフライトリクエストの場合、デフォルトの実装は、選択されたハンドラーを、構成された setCorsProcessor(org.springframework.web.cors.CorsProcessor) を呼び出す単純な HttpRequestHandler に置き換えます。

  実際のリクエストの場合、デフォルトの実装は、CORS 関連のチェックを行い、CORS ヘッダーを追加する HandlerInterceptor を挿入します。

  パラメーター:

  request - 現在のリクエスト

  chain - ハンドラーチェーン

  config - 該当する CORS 設定 (おそらく null)

  導入:

  4.2