MappedInterceptor (Spring Framework 5.2.5.RELEASE API)

java.lang.ObjectSE
- org.springframework.web.servlet.handler.MappedInterceptor

実装されたすべてのインターフェース:
HandlerInterceptor
```
public final class MappedInterceptor
extends ObjectSE
implements HandlerInterceptor
```
インターセプターが適用されるパスパターンを含む（およびオプションで除外する）と共に、HandlerInterceptor への呼び出しを含み、委譲します。インターセプターが特定のリクエストパスに適用されるかどうかをテストするためのマッチングロジックも提供します。
MappedInterceptor は、任意の AbstractHandlerMethodMapping に直接登録できます。さらに、型 MappedInterceptor の Bean は、AbstractHandlerMethodMapping （祖先 ApplicationContext を含む）によって自動的に検出されます。これは、インターセプターがすべてのハンドラーマッピングで「グローバルに」登録されることを事実上意味します。
導入:
3.0
作成者:
Keith Donald, Rossen Stoyanchev, Brian Clozel

コンストラクターの概要

コンストラクター
コンストラクターと説明
`MappedInterceptor(StringSE[] includePatterns, HandlerInterceptor interceptor)` 新しい MappedInterceptor インスタンスを作成します。
`MappedInterceptor(StringSE[] includePatterns, StringSE[] excludePatterns, HandlerInterceptor interceptor)` 新しい MappedInterceptor インスタンスを作成します。
`MappedInterceptor(StringSE[] includePatterns, StringSE[] excludePatterns, WebRequestInterceptor interceptor)` 新しい MappedInterceptor インスタンスを作成します。
`MappedInterceptor(StringSE[] includePatterns, WebRequestInterceptor interceptor)` 新しい MappedInterceptor インスタンスを作成します。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`afterCompletion(HttpServletRequestEE request, HttpServletResponseEE response, ObjectSE handler, ExceptionSE ex)` リクエスト処理の完了後、つまりビューのレンダリング後のコールバック。
`HandlerInterceptor`	`getInterceptor()` 実際の `HandlerInterceptor` 参照。
`PathMatcher`	`getPathMatcher()` 設定された PathMatcher、または存在しない場合は `null`。
`StringSE[]`	`getPathPatterns()` インターセプターがマップされるアプリケーションへのパス。
`boolean`	`matches(StringSE lookupPath, PathMatcher pathMatcher)` 指定されたルックアップパスの一致を決定します。
`void`	`postHandle(HttpServletRequestEE request, HttpServletResponseEE response, ObjectSE handler, ModelAndView modelAndView)` ハンドラーの実行をインターセプトします。
`boolean`	`preHandle(HttpServletRequestEE request, HttpServletResponseEE response, ObjectSE handler)` ハンドラーの実行をインターセプトします。
`void`	`setPathMatcher(PathMatcher pathMatcher)` `matches(String, org.springframework.util.PathMatcher)` メソッドにデフォルトで渡されるものの代わりに、この MappedInterceptor で使用する PathMatcher を構成します。

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

- コンストラクターの詳細
  - MappedInterceptor
```
public MappedInterceptor(@Nullable
                         StringSE[] includePatterns,
                         HandlerInterceptor interceptor)
```
    新しい MappedInterceptor インスタンスを作成します。
    パラメーター:
    includePatterns - マップするパスパターン (すべてのパスに一致する場合は空)
    interceptor - 指定されたパターンにマッピングする HandlerInterceptor インスタンス
  - MappedInterceptor
```
public MappedInterceptor(@Nullable
                         StringSE[] includePatterns,
                         @Nullable
                         StringSE[] excludePatterns,
                         HandlerInterceptor interceptor)
```
    新しい MappedInterceptor インスタンスを作成します。
    パラメーター:
    includePatterns - マップするパスパターン (すべてのパスに一致する場合は空)
    excludePatterns - 除外するパスパターン (特定の除外がない場合は空)
    interceptor - 指定されたパターンにマッピングする HandlerInterceptor インスタンス
  - MappedInterceptor
```
public MappedInterceptor(@Nullable
                         StringSE[] includePatterns,
                         WebRequestInterceptor interceptor)
```
    新しい MappedInterceptor インスタンスを作成します。
    パラメーター:
    includePatterns - マップするパスパターン (すべてのパスに一致する場合は空)
    interceptor - 指定されたパターンにマッピングする WebRequestInterceptor インスタンス
  - MappedInterceptor
```
public MappedInterceptor(@Nullable
                         StringSE[] includePatterns,
                         @Nullable
                         StringSE[] excludePatterns,
                         WebRequestInterceptor interceptor)
```
    新しい MappedInterceptor インスタンスを作成します。
    パラメーター:
    includePatterns - マップするパスパターン (すべてのパスに一致する場合は空)
    excludePatterns - 除外するパスパターン (特定の除外がない場合は空)
    interceptor - 指定されたパターンにマッピングする WebRequestInterceptor インスタンス
- メソッドの詳細
  - setPathMatcher
```
public void setPathMatcher(@Nullable
                           PathMatcher pathMatcher)
```
    matches(String, org.springframework.util.PathMatcher) メソッドにデフォルトで渡されるものの代わりに、この MappedInterceptor で使用する PathMatcher を構成します。
    これは、デフォルトでサポートされる Ant スタイルのパスパターン以外のメタデータのマッピングをサポートするカスタム PathMatcher 実装を使用する場合にのみ必要となる高度なプロパティです。
  - getPathMatcher
```
@Nullable
public PathMatcher getPathMatcher()
```
    設定された PathMatcher、または存在しない場合は null。
  - getPathPatterns
```
@Nullable
public StringSE[] getPathPatterns()
```
    インターセプターがマップされるアプリケーションへのパス。
  - getInterceptor
```
public HandlerInterceptor getInterceptor()
```
    実際の HandlerInterceptor 参照。
  - matches
```
public boolean matches(StringSE lookupPath,
                       PathMatcher pathMatcher)
```
    指定されたルックアップパスの一致を決定します。
    パラメーター:
    lookupPath - 現在のリクエストパス
    pathMatcher - パスパターンマッチング用のパスマッチャー
    戻り値:
    インターセプターが特定のリクエストパスに適用される場合は true
  - preHandle
```
public boolean preHandle(HttpServletRequestEE request,
                         HttpServletResponseEE response,
                         ObjectSE handler)
                  throws ExceptionSE
```
    インターフェースからコピーされた説明: HandlerInterceptor
    ハンドラーの実行をインターセプトします。HandlerMapping が適切なハンドラーオブジェクトを決定した後、HandlerAdapter がハンドラーを呼び出す前に呼び出されます。
    DispatcherServlet は、任意の数のインターセプターで構成される実行チェーンでハンドラーを処理し、ハンドラー自体を最後に処理します。このメソッドを使用すると、各インターセプターはチェーンの実行を中止することを決定でき、通常は HTTP エラーを送信するか、カスタムレスポンスを作成します。
    注意 : 非同期リクエスト処理には特別な考慮事項が適用されます。詳細については、AsyncHandlerInterceptor を参照してください。
    デフォルトの実装は true を返します。
    次で指定:
    インターフェース HandlerInterceptor の preHandle
    パラメーター:
    request - 現在の HTTP リクエスト
    response - 現在の HTTP レスポンス
    handler - 型および / またはインスタンス評価のために、実行するために選択されたハンドラー
    戻り値:
    実行チェーンが次のインターセプターまたはハンドラー自体を続行する必要がある場合は、true。そうでない場合、DispatcherServlet は、このインターセプターがすでにレスポンス自体を処理していると想定します。
    例外:
    ExceptionSE - エラーの場合
  - postHandle
```
public void postHandle(HttpServletRequestEE request,
                       HttpServletResponseEE response,
                       ObjectSE handler,
                       @Nullable
                       ModelAndView modelAndView)
                throws ExceptionSE
```
    インターフェースからコピーされた説明: HandlerInterceptor
    ハンドラーの実行をインターセプトします。HandlerAdapter が実際にハンドラーを呼び出した後で、DispatcherServlet がビューをレンダリングする前に呼び出されます。指定された ModelAndView を介して、追加のモデルオブジェクトをビューに公開できます。
    DispatcherServlet は、任意の数のインターセプターで構成される実行チェーンのハンドラーを処理します。ハンドラー自体は最後にあります。このメソッドを使用すると、各インターセプターは実行を後処理でき、実行チェーンの逆順で適用されます。
    注意 : 非同期リクエスト処理には特別な考慮事項が適用されます。詳細については、AsyncHandlerInterceptor を参照してください。
    デフォルトの実装は空です。
    次で指定:
    インターフェース HandlerInterceptor の postHandle
    パラメーター:
    request - 現在の HTTP リクエスト
    response - 現在の HTTP レスポンス
    handler - 型および / またはインスタンスの検査のために、非同期実行を開始したハンドラー（または HandlerMethod）
    modelAndView - ハンドラーが返した ModelAndView (null にすることもできます)
    例外:
    ExceptionSE - エラーの場合
  - afterCompletion
```
public void afterCompletion(HttpServletRequestEE request,
                            HttpServletResponseEE response,
                            ObjectSE handler,
                            @Nullable
                            ExceptionSE ex)
                     throws ExceptionSE
```
    インターフェースからコピーされた説明: HandlerInterceptor
    リクエスト処理の完了後、つまりビューのレンダリング後のコールバック。ハンドラー実行の結果で呼び出されるため、適切なリソースのクリーンアップが可能になります。
    メモ: このインターセプターの preHandle メソッドが正常に完了し、true を返した場合にのみ呼び出されます！
    postHandle メソッドと同様に、このメソッドはチェーンの各インターセプターで逆の順序で呼び出されるため、最初のインターセプターが最後に呼び出されます。
    注意 : 非同期リクエスト処理には特別な考慮事項が適用されます。詳細については、AsyncHandlerInterceptor を参照してください。
    デフォルトの実装は空です。
    次で指定:
    インターフェース HandlerInterceptor の afterCompletion
    パラメーター:
    request - 現在の HTTP リクエスト
    response - 現在の HTTP レスポンス
    handler - 型および / またはインスタンスの検査のために、非同期実行を開始したハンドラー（または HandlerMethod）
    ex - ハンドラーの実行時にスローされる例外（ある場合）。これには、例外リゾルバーを介して処理された例外は含まれません
    例外:
    ExceptionSE - エラーの場合

クラス MappedInterceptor

コンストラクターの概要

メソッドのサマリー

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

コンストラクターの詳細

MappedInterceptor

MappedInterceptor

MappedInterceptor

MappedInterceptor

メソッドの詳細

setPathMatcher

getPathMatcher

getPathPatterns

getInterceptor

matches

preHandle

postHandle

afterCompletion