AsyncExecutionInterceptor (Spring Framework API)

java.lang.ObjectSE
- org.springframework.aop.interceptor.AsyncExecutionAspectSupport
- - org.springframework.aop.interceptor.AsyncExecutionInterceptor

実装されたすべてのインターフェース:
Advice, Interceptor, MethodInterceptor, Aware, BeanFactoryAware, Ordered
既知の直属サブクラス
AnnotationAsyncExecutionInterceptor
```
public class AsyncExecutionInterceptor
extends AsyncExecutionAspectSupport
implements MethodInterceptor, Ordered
```
特定の AsyncTaskExecutor を使用して、メソッド呼び出しを非同期に処理する AOP アライアンス MethodInterceptor。通常、Async アノテーションとともに使用されます。
ターゲットメソッドシグネチャーに関しては、すべてのパラメーター型がサポートされます。ただし、戻り値の型は void または java.util.concurrent.Future のいずれかに制限されています。後者の場合、プロキシから返される Future ハンドルは、非同期メソッドの実行結果を追跡するために使用できる実際の非同期 Future になります。ただし、ターゲットメソッドは同じシグネチャーを実装する必要があるため、戻り値を渡すだけの一時的な Future ハンドルを返す必要があります（Spring の AsyncResult または EJB 3.1 の javax.ejb.AsyncResult など）。
戻り値の型が java.util.concurrent.Future の場合、実行中にスローされた例外は、呼び出し元がアクセスして管理できます。ただし、void 戻り値型では、そのような例外を送信することはできません。その場合、そのような例外を処理するために AsyncUncaughtExceptionHandler を登録できます。
Spring 3.1.2 以降では、Spring の @Async アノテーションと併せてエグゼキューター修飾がサポートされるため、AnnotationAsyncExecutionInterceptor サブクラスの使用が推奨されます。
導入:
3.0
作成者:
Juergen Hoeller, Chris Beams, Stephane Nicoll
関連事項:
Async, AsyncAnnotationAdvisor, AnnotationAsyncExecutionInterceptor

フィールドサマリー
- クラス org.springframework.aop.interceptor.AsyncExecutionAspectSupport から継承されたフィールド
  DEFAULT_TASK_EXECUTOR_BEAN_NAME, logger
- インターフェース org.springframework.core.Ordered から継承されたフィールド
  HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

コンストラクターのサマリー

コンストラクター
コンストラクターと説明
`AsyncExecutionInterceptor(ExecutorSE defaultExecutor)` デフォルトの `AsyncUncaughtExceptionHandler` で新しいインスタンスを作成します。
`AsyncExecutionInterceptor(ExecutorSE defaultExecutor, AsyncUncaughtExceptionHandler exceptionHandler)` 新しい `AsyncExecutionInterceptor` を作成します。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`protected ExecutorSE`	`getDefaultExecutor(BeanFactory beanFactory)` この実装は、コンテキスト内で一意の `TaskExecutor` Bean を検索するか、そうでない場合は "taskExecutor" という名前の `Executor`SE Bean を検索します。
`protected StringSE`	`getExecutorQualifier(MethodSE method)` この実装は、Spring 3.1.2 での互換性のための操作ではありません。
`int`	`getOrder()` このオブジェクトの順序値を取得します。
`ObjectSE`	`invoke(MethodInvocation invocation)` 指定されたメソッド呼び出しをインターセプトし、メソッドの実際の呼び出しを正しいタスクエグゼキューターに送信して、呼び出し元にすぐに戻ります。

クラス org.springframework.aop.interceptor.AsyncExecutionAspectSupport から継承されたメソッド
configure, determineAsyncExecutor, doSubmit, findQualifiedExecutor, handleError, setBeanFactory, setExceptionHandler, setExecutor

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

- コンストラクターの詳細
  - AsyncExecutionInterceptor
```
public AsyncExecutionInterceptor(@Nullable
                                 ExecutorSE defaultExecutor)
```
    デフォルトの AsyncUncaughtExceptionHandler で新しいインスタンスを作成します。
    パラメーター:
    defaultExecutor - 委譲先の ExecutorSE（通常は Spring AsyncTaskExecutor または ExecutorServiceSE）。4.2.6 以降では、このインターセプターのローカルエグゼキューターが別の方法で構築されます
  - AsyncExecutionInterceptor
```
public AsyncExecutionInterceptor(@Nullable
                                 ExecutorSE defaultExecutor,
                                 AsyncUncaughtExceptionHandler exceptionHandler)
```
    新しい AsyncExecutionInterceptor を作成します。
    パラメーター:
    defaultExecutor - 委譲先の ExecutorSE（通常は Spring AsyncTaskExecutor または ExecutorServiceSE）。4.2.6 以降では、このインターセプターのローカルエグゼキューターが別の方法で構築されます
    exceptionHandler - 使用する AsyncUncaughtExceptionHandler
- メソッドの詳細
  - invoke
```
@Nullable
public ObjectSE invoke(MethodInvocation invocation)
                        throws ThrowableSE
```
    指定されたメソッド呼び出しをインターセプトし、メソッドの実際の呼び出しを正しいタスクエグゼキューターに送信して、呼び出し元にすぐに戻ります。
    次で指定:
    インターフェース MethodInterceptor の invoke
    パラメーター:
    invocation - インターセプトして非同期にするメソッド
    戻り値:
    元のメソッドが Future を返す場合は FutureSE。それ以外の場合は null。
    例外:
    ThrowableSE - インターセプターまたはターゲットオブジェクトが例外をスローする場合
  - getExecutorQualifier
```
@Nullable
protected StringSE getExecutorQualifier(MethodSE method)
```
    この実装は、Spring 3.1.2 での互換性のための操作ではありません。サブクラスは、修飾子情報を抽出するためのサポートを提供するためにオーバーライドできます。指定されたメソッドのアノテーションを介して。
    次で指定:
    クラス AsyncExecutionAspectSupport の getExecutorQualifier
    パラメーター:
    method - エグゼキューター修飾子メタデータをインスペクションするメソッド
    戻り値:
    常に null
    導入:
    3.1.2
    関連事項:
    AsyncExecutionAspectSupport.determineAsyncExecutor(Method)
  - getDefaultExecutor
```
@Nullable
protected ExecutorSE getDefaultExecutor(@Nullable
                                                BeanFactory beanFactory)
```
    この実装は、コンテキストで一意の TaskExecutor Bean を検索するか、それ以外の場合は "taskExecutor" という名前の ExecutorSE Bean を検索します。2 つとも解決できない場合（BeanFactory がまったく構成されていない場合など）、この実装は、デフォルトが見つからない場合、ローカルで使用するために新しく作成された SimpleAsyncTaskExecutor インスタンスにフォールバックします。
    オーバーライド:
    クラス AsyncExecutionAspectSupport の getDefaultExecutor
    パラメーター:
    beanFactory - デフォルトのエグゼキューター検索に使用する BeanFactory
    戻り値:
    デフォルトのエグゼキューター、または使用可能なものがなければ null
    関連事項:
    AsyncExecutionAspectSupport.DEFAULT_TASK_EXECUTOR_BEAN_NAME
  - getOrder
```
public int getOrder()
```
    インターフェースからコピーされた説明: Ordered
    このオブジェクトの順序値を取得します。
    値が高いほど、優先度は低くなります。結果として、最も低い値を持つオブジェクトが最高の優先度を持ちます（サーブレット load-on-startup の値に多少似ています）。
    同じ順序の値は、影響を受けるオブジェクトの任意のソート位置になります。
    次で指定:
    インターフェース Ordered の getOrder
    戻り値:
    オーダー額
    関連事項:
    Ordered.HIGHEST_PRECEDENCE, Ordered.LOWEST_PRECEDENCE

クラス AsyncExecutionInterceptor

フィールドサマリー

クラス org.springframework.aop.interceptor.AsyncExecutionAspectSupport から継承されたフィールド

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

コンストラクターのサマリー

メソッドのサマリー

クラス org.springframework.aop.interceptor.AsyncExecutionAspectSupport から継承されたメソッド

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

コンストラクターの詳細

AsyncExecutionInterceptor

AsyncExecutionInterceptor

メソッドの詳細

invoke

getExecutorQualifier

getDefaultExecutor

getOrder