AbstractHandlerMethodMapping (Spring Framework 5.0.0.RELEASE API)

java.lang.ObjectSE
- org.springframework.context.support.ApplicationObjectSupport
- - org.springframework.web.context.support.WebApplicationObjectSupport
  - - org.springframework.web.servlet.handler.AbstractHandlerMapping
    - - org.springframework.web.servlet.handler.AbstractHandlerMethodMapping<T>

型パラメーター:
T - ハンドラーメソッドを受信リクエストに一致させるために必要な条件を含む HandlerMethod のマッピング。
実装されているすべてのインターフェース:
Aware, InitializingBean, ApplicationContextAware, Ordered, ServletContextAware, HandlerMapping
既知の直属サブクラス
RequestMappingInfoHandlerMapping
```
public abstract class AbstractHandlerMethodMapping<T>
extends AbstractHandlerMapping
implements InitializingBean
```
リクエストと HandlerMethod の間のマッピングを定義する HandlerMapping 実装の抽象基本クラス。
登録された各ハンドラーメソッドについて、マッピング型 <T> の詳細を定義するサブクラスで一意のマッピングが維持されます。
導入:
3.1
作成者:
Arjen Poutsma, Rossen Stoyanchev, Juergen Hoeller

フィールドのサマリー
- クラス org.springframework.context.support.ApplicationObjectSupport から継承されたフィールド
  logger
- インターフェース org.springframework.web.servlet.HandlerMapping から継承されたフィールド
  BEST_MATCHING_PATTERN_ATTRIBUTE, INTROSPECT_TYPE_LEVEL_MAPPING, MATRIX_VARIABLES_ATTRIBUTE, PATH_WITHIN_HANDLER_MAPPING_ATTRIBUTE, PRODUCIBLE_MEDIA_TYPES_ATTRIBUTE, URI_TEMPLATE_VARIABLES_ATTRIBUTE
- インターフェース org.springframework.core.Ordered から継承されたフィールド
  HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

コンストラクターの概要
コンストラクター
コンストラクターと説明
AbstractHandlerMethodMapping()

コンストラクター
コンストラクターと説明
`AbstractHandlerMethodMapping()`

メソッドのサマリー

すべてのメソッドインスタンスメソッド抽象メソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`afterPropertiesSet()` 初期化時にハンドラーメソッドを検出します。
`protected HandlerMethod`	`createHandlerMethod(ObjectSE handler, MethodSE method)` HandlerMethod インスタンスを作成します。
`protected void`	`detectHandlerMethods(ObjectSE handler)` ハンドラーでハンドラーメソッドを探します。
`protected CorsConfiguration`	`getCorsConfiguration(ObjectSE handler, HttpServletRequestEE request)` 指定されたハンドラーの CORS 構成を取得します。
`protected HandlerMethod`	`getHandlerInternal(HttpServletRequestEE request)` 指定されたリクエストのハンドラーメソッドを検索します。
`MapSE<T, HandlerMethod>`	`getHandlerMethods()` すべてのマッピングと HandlerMethod を含む（読み取り専用）マップを返します。
`ListSE<HandlerMethod>`	`getHandlerMethodsForMappingName(StringSE mappingName)` 指定されたマッピング名のハンドラーメソッドを返します。
`protected abstract ComparatorSE<T>`	`getMappingComparator(HttpServletRequestEE request)` 一致するマッピングをソートするためのコンパレーターを返します。
`protected abstract T`	`getMappingForMethod(MethodSE method, ClassSE<?> handlerType)` ハンドラーメソッドのマッピングを提供します。
`protected abstract SetSE<StringSE>`	`getMappingPathPatterns(T mapping)` マッピングに含まれる URL パスを抽出して返します。
`protected abstract T`	`getMatchingMapping(T mapping, HttpServletRequestEE request)` マッピングが現在のリクエストに一致するかどうかを確認し、現在のリクエストに関連する条件を含む（潜在的に新しい）マッピングを返します。
`HandlerMethodMappingNamingStrategy<T>`	`getNamingStrategy()` 構成された命名戦略または `null` を返します。
`protected void`	`handleMatch(T mapping, StringSE lookupPath, HttpServletRequestEE request)` 一致するマッピングが見つかったときに呼び出されます。
`protected HandlerMethod`	`handleNoMatch(SetSE<T> mappings, StringSE lookupPath, HttpServletRequestEE request)` 一致するマッピングが見つからないときに呼び出されます。
`protected void`	`handlerMethodsInitialized(MapSE<T, HandlerMethod> handlerMethods)` すべてのハンドラーメソッドが検出された後に呼び出されます。
`protected CorsConfiguration`	`initCorsConfiguration(ObjectSE handler, MethodSE method, T mapping)` マッピングの CORS 設定を抽出して返します。
`protected void`	`initHandlerMethods()` ApplicationContext で Bean をスキャンし、ハンドラーメソッドを検出して登録します。
`protected abstract boolean`	`isHandler(ClassSE<?> beanType)` 指定された型がハンドラーメソッドを持つハンドラーかどうか。
`protected HandlerMethod`	`lookupHandlerMethod(StringSE lookupPath, HttpServletRequestEE request)` 現在のリクエストに最適なハンドラーメソッドを検索します。
`protected void`	`registerHandlerMethod(ObjectSE handler, MethodSE method, T mapping)` ハンドラーメソッドとその一意のマッピングを登録します。
`void`	`registerMapping(T mapping, ObjectSE handler, MethodSE method)` 指定されたマッピングを登録します。
`void`	`setDetectHandlerMethodsInAncestorContexts(boolean detectHandlerMethodsInAncestorContexts)` 祖先 ApplicationContexts の Bean でハンドラーメソッドを検出するかどうか。
`void`	`setHandlerMethodMappingNamingStrategy(HandlerMethodMappingNamingStrategy<T> namingStrategy)` マップされたすべてのハンドラーメソッドにデフォルト名を割り当てるために使用する命名戦略を構成します。
`void`	`unregisterMapping(T mapping)` 指定されたマッピングを登録解除します。

クラス org.springframework.web.servlet.handler.AbstractHandlerMapping から継承されたメソッド
adaptInterceptor, detectMappedInterceptors, extendInterceptors, getAdaptedInterceptors, getCorsConfigurations, getCorsHandlerExecutionChain, getCorsProcessor, getDefaultHandler, getHandler, getHandlerExecutionChain, getMappedInterceptors, getOrder, getPathMatcher, getUrlPathHelper, initApplicationContext, initInterceptors, setAlwaysUseFullPath, setCorsConfigurations, setCorsProcessor, setDefaultHandler, setInterceptors, setOrder, setPathMatcher, setRemoveSemicolonContent, setUrlDecode, setUrlPathHelper

クラス org.springframework.web.context.support.WebApplicationObjectSupport から継承されたメソッド
getServletContext, getTempDir, getWebApplicationContext, initApplicationContext, initServletContext, isContextRequired, setServletContext

クラス org.springframework.context.support.ApplicationObjectSupport から継承されたメソッド
getApplicationContext, getMessageSourceAccessor, obtainApplicationContext, requiredContextClass, setApplicationContext

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

- コンストラクターの詳細
  - AbstractHandlerMethodMapping
```
public AbstractHandlerMethodMapping()
```
- メソッドの詳細
  - setDetectHandlerMethodsInAncestorContexts
```
public void setDetectHandlerMethodsInAncestorContexts(boolean detectHandlerMethodsInAncestorContexts)
```
    祖先 ApplicationContexts の Bean でハンドラーメソッドを検出するかどうか。
    デフォルトは「false」: 現在の ApplicationContext の Bean のみが考慮されます。つまり、この HandlerMapping 自体が定義されているコンテキスト（通常、現在の DispatcherServlet のコンテキスト）のみが考慮されます。
    このフラグをオンにして、祖先コンテキスト（通常は Spring ルート WebApplicationContext）のハンドラー Bean も検出します。
  - setHandlerMethodMappingNamingStrategy
```
public void setHandlerMethodMappingNamingStrategy(HandlerMethodMappingNamingStrategy<T> namingStrategy)
```
    マップされたすべてのハンドラーメソッドにデフォルト名を割り当てるために使用する命名戦略を構成します。
    デフォルトの命名戦略は、クラス名の大文字の後に "#"、メソッド名が続くというものです。たとえば、メソッド getFoo を持つクラス TestController の場合は "TC#getFoo" になります。
  - getNamingStrategy
```
@Nullable
public HandlerMethodMappingNamingStrategy<T> getNamingStrategy()
```
    構成された命名戦略または null を返します。
  - getHandlerMethods
```
public MapSE<T,HandlerMethod> getHandlerMethods()
```
    すべてのマッピングと HandlerMethod を含む（読み取り専用）マップを返します。
  - getHandlerMethodsForMappingName
```
@Nullable
public ListSE<HandlerMethod> getHandlerMethodsForMappingName(StringSE mappingName)
```
    指定されたマッピング名のハンドラーメソッドを返します。
    パラメーター:
    mappingName - マッピング名
    戻り値:
    一致する HandlerMethod または null のリスト。返されたリストは変更されることはなく、反復しても安全です。
    関連事項:
    setHandlerMethodMappingNamingStrategy(org.springframework.web.servlet.handler.HandlerMethodMappingNamingStrategy<T>)
  - registerMapping
```
public void registerMapping(T mapping,
                            ObjectSE handler,
                            MethodSE method)
```
    指定されたマッピングを登録します。
    このメソッドは、初期化が完了した後、実行時に呼び出すことができます。
    パラメーター:
    mapping - ハンドラーメソッドのマッピング
    handler - ハンドラー
    method - メソッド
  - unregisterMapping
```
public void unregisterMapping(T mapping)
```
    指定されたマッピングを登録解除します。
    このメソッドは、初期化が完了した後、実行時に呼び出すことができます。
    パラメーター:
    mapping - 登録解除するマッピング
  - afterPropertiesSet
```
public void afterPropertiesSet()
```
    初期化時にハンドラーメソッドを検出します。
    次で指定:
    インターフェース InitializingBean の afterPropertiesSet
  - initHandlerMethods
```
protected void initHandlerMethods()
```
    ApplicationContext で Bean をスキャンし、ハンドラーメソッドを検出して登録します。
    関連事項:
    isHandler(Class), getMappingForMethod(Method, Class), handlerMethodsInitialized(Map)
  - detectHandlerMethods
```
protected void detectHandlerMethods(ObjectSE handler)
```
    ハンドラーでハンドラーメソッドを探します。
    パラメーター:
    handler - ハンドラーまたはハンドラーインスタンスの Bean 名
  - registerHandlerMethod
```
protected void registerHandlerMethod(ObjectSE handler,
                                     MethodSE method,
                                     T mapping)
```
    ハンドラーメソッドとその一意のマッピングを登録します。検出された各ハンドラーメソッドに対して起動時に呼び出されます。
    パラメーター:
    handler - ハンドラーまたはハンドラーインスタンスの Bean 名
    method - 登録する方法
    mapping - ハンドラーメソッドに関連付けられたマッピング条件
    例外:
    IllegalStateExceptionSE - 別のメソッドが同じマッピングですでに登録されている場合
  - createHandlerMethod
```
protected HandlerMethod createHandlerMethod(ObjectSE handler,
                                            MethodSE method)
```
    HandlerMethod インスタンスを作成します。
    パラメーター:
    handler - Bean 名または実際のハンドラーインスタンス
    method - ターゲットメソッド
    戻り値:
    作成された HandlerMethod
  - initCorsConfiguration
```
@Nullable
protected CorsConfiguration initCorsConfiguration(ObjectSE handler,
                                                            MethodSE method,
                                                            T mapping)
```
    マッピングの CORS 設定を抽出して返します。
  - handlerMethodsInitialized
```
protected void handlerMethodsInitialized(MapSE<T,HandlerMethod> handlerMethods)
```
    すべてのハンドラーメソッドが検出された後に呼び出されます。
    パラメーター:
    handlerMethods - ハンドラーメソッドとマッピングを含む読み取り専用マップ。
  - getHandlerInternal
```
protected HandlerMethod getHandlerInternal(HttpServletRequestEE request)
                                    throws ExceptionSE
```
    指定されたリクエストのハンドラーメソッドを検索します。
    次で指定:
    クラス AbstractHandlerMapping の getHandlerInternal
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    対応するハンドラーインスタンス。見つからない場合は null
    例外:
    ExceptionSE - 内部エラーがある場合
  - lookupHandlerMethod
```
@Nullable
protected HandlerMethod lookupHandlerMethod(StringSE lookupPath,
                                                      HttpServletRequestEE request)
                                               throws ExceptionSE
```
    現在のリクエストに最も一致するハンドラーメソッドを検索します。複数の一致が見つかった場合、最適な一致が選択されます。
    パラメーター:
    lookupPath - 現在のサーブレットマッピング内のマッピングルックアップパス
    request - 現在のリクエスト
    戻り値:
    最適なハンドラーメソッド、または一致しない場合は null
    例外:
    ExceptionSE
    関連事項:
    handleMatch(Object, String, HttpServletRequest), handleNoMatch(Set, String, HttpServletRequest)
  - handleMatch
```
protected void handleMatch(T mapping,
                           StringSE lookupPath,
                           HttpServletRequestEE request)
```
    一致するマッピングが見つかったときに呼び出されます。
    パラメーター:
    mapping - 一致するマッピング
    lookupPath - 現在のサーブレットマッピング内のマッピングルックアップパス
    request - 現在のリクエスト
  - handleNoMatch
```
@Nullable
protected HandlerMethod handleNoMatch(SetSE<T> mappings,
                                                StringSE lookupPath,
                                                HttpServletRequestEE request)
                                         throws ExceptionSE
```
    一致するマッピングが見つからないときに呼び出されます。
    パラメーター:
    mappings - 登録済みのすべてのマッピング
    lookupPath - 現在のサーブレットマッピング内のマッピングルックアップパス
    request - 現在のリクエスト
    例外:
    ServletExceptionEE - エラーの場合
    ExceptionSE
  - getCorsConfiguration
```
protected CorsConfiguration getCorsConfiguration(ObjectSE handler,
                                                 HttpServletRequestEE request)
```
    クラスからコピーされた説明: AbstractHandlerMapping
    指定されたハンドラーの CORS 構成を取得します。
    オーバーライド:
    クラス AbstractHandlerMapping の getCorsConfiguration
    パラメーター:
    handler - チェックするハンドラー（非 null）。
    request - 現在のリクエスト。
    戻り値:
    ハンドラーの CORS 構成、ない場合は null
  - isHandler
```
protected abstract boolean isHandler(ClassSE<?> beanType)
```
    指定された型がハンドラーメソッドを持つハンドラーかどうか。
    パラメーター:
    beanType - チェックされている Bean の型
    戻り値:
    これがハンドラー型の場合は "true"、そうでない場合は "false"。
  - getMappingForMethod
```
@Nullable
protected abstract T getMappingForMethod(MethodSE method,
                                                   ClassSE<?> handlerType)
```
    ハンドラーメソッドのマッピングを提供します。マッピングを提供できないメソッドは、ハンドラーメソッドではありません。
    パラメーター:
    method - マッピングを提供する方法
    handlerType - ハンドラー型、場合によってはメソッドの宣言クラスのサブ型
    戻り値:
    マッピング、またはメソッドがマッピングされていない場合は null
  - getMappingPathPatterns
```
protected abstract SetSE<StringSE> getMappingPathPatterns(T mapping)
```
    マッピングに含まれる URL パスを抽出して返します。
  - getMatchingMapping
```
@Nullable
protected abstract T getMatchingMapping(T mapping,
                                                  HttpServletRequestEE request)
```
    マッピングが現在のリクエストに一致するかどうかを確認し、現在のリクエストに関連する条件を含む（潜在的に新しい）マッピングを返します。
    パラメーター:
    mapping - 一致を取得するマッピング
    request - 現在の HTTP サーブレットリクエスト
    戻り値:
    一致、またはマッピングが一致しない場合は null
  - getMappingComparator
```
protected abstract ComparatorSE<T> getMappingComparator(HttpServletRequestEE request)
```
    一致するマッピングをソートするためのコンパレータを返します。返されたコンパレータは、「より良い」一致をより高い順に並べ替えます。
    パラメーター:
    request - 現在のリクエスト
    戻り値:
    コンパレータ (非 null)

クラス AbstractHandlerMethodMapping<T>

フィールドのサマリー

クラス org.springframework.context.support.ApplicationObjectSupport から継承されたフィールド

インターフェース org.springframework.web.servlet.HandlerMapping から継承されたフィールド

インターフェース org.springframework.core.Ordered から継承されたフィールド

コンストラクターの概要

メソッドのサマリー

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

クラス org.springframework.web.context.support.WebApplicationObjectSupport から継承されたメソッド

クラス org.springframework.context.support.ApplicationObjectSupport から継承されたメソッド

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

コンストラクターの詳細

AbstractHandlerMethodMapping

メソッドの詳細

setDetectHandlerMethodsInAncestorContexts

setHandlerMethodMappingNamingStrategy

getNamingStrategy

getHandlerMethods

getHandlerMethodsForMappingName

registerMapping

unregisterMapping

afterPropertiesSet

initHandlerMethods

detectHandlerMethods

registerHandlerMethod

createHandlerMethod

initCorsConfiguration

handlerMethodsInitialized

getHandlerInternal

lookupHandlerMethod

handleMatch

handleNoMatch

getCorsConfiguration

isHandler

getMappingForMethod

getMappingPathPatterns

getMatchingMapping

getMappingComparator