フィールドの詳細

• DEFAULT_TASK_EXECUTOR_BEAN_NAME

  public static final java.lang.String DEFAULT_TASK_EXECUTOR_BEAN_NAME

  取得する TaskExecutor Bean のデフォルト名: "taskExecutor"。

  最初の検索は型ごとに行われることに注意してください。これは、コンテキストで複数のエグゼキューター Bean が見つかった場合の単なるフォールバックです。

  導入:

  4.2.6

  関連事項:

  定数フィールド値

• logger

  protected final Log logger

コンストラクターの詳細

• AsyncExecutionAspectSupport

  public AsyncExecutionAspectSupport(@Nullable
                                     java.util.concurrent.Executor defaultExecutor)

  デフォルトの AsyncUncaughtExceptionHandler で新しいインスタンスを作成します。

  パラメーター:

  defaultExecutor - 委譲先の Executor （通常は Spring AsyncTaskExecutor または ExecutorService）。ただし、非同期メソッドの修飾子を介してより具体的なエグゼキューターがリクエストされた場合は、エグゼキューターは呼び出し時に、囲んでいる Bean ファクトリに対して検索されます。

• AsyncExecutionAspectSupport

  public AsyncExecutionAspectSupport(@Nullable
                                     java.util.concurrent.Executor defaultExecutor,
                                     AsyncUncaughtExceptionHandler exceptionHandler)

  指定された例外ハンドラーで新しい AsyncExecutionAspectSupport を作成します。

  パラメーター:

  defaultExecutor - 委譲先の Executor （通常は Spring AsyncTaskExecutor または ExecutorService）。ただし、非同期メソッドの修飾子を介してより具体的なエグゼキューターがリクエストされた場合は、エグゼキューターは呼び出し時に、囲んでいる Bean ファクトリに対して検索されます。

  exceptionHandler - 使用する AsyncUncaughtExceptionHandler

メソッドの詳細

• configure

  public void configure(@Nullable
                        java.util.function.Supplier<java.util.concurrent.Executor> defaultExecutor,
                        @Nullable
                        java.util.function.Supplier<AsyncUncaughtExceptionHandler> exceptionHandler)

  指定されたエグゼキューターと例外ハンドラーのサプライヤーでこのアスペクトを設定し、サプライヤーが解決できない場合は対応するデフォルトを適用します。

  導入:

  5.1

• setExecutor

  public void setExecutor(java.util.concurrent.Executor defaultExecutor)

  非同期メソッドの実行時に使用するエグゼキューターを指定します。

  パラメーター:

  defaultExecutor - 委譲先の Executor （通常は Spring AsyncTaskExecutor または ExecutorService）。ただし、非同期メソッドの修飾子を介してより具体的なエグゼキューターがリクエストされた場合は、エグゼキューターは呼び出し時に、囲んでいる Bean ファクトリに対して検索されます。

  関連事項:

  getExecutorQualifier(Method), setBeanFactory(BeanFactory), getDefaultExecutor(BeanFactory)

• setExceptionHandler

  public void setExceptionHandler(AsyncUncaughtExceptionHandler exceptionHandler)

  void 戻り値型で非同期メソッドを呼び出すことによってスローされた例外を処理するために使用する AsyncUncaughtExceptionHandler を提供します。

• setBeanFactory

  public void setBeanFactory(BeanFactory beanFactory)

  修飾子でエグゼキューターを検索するとき、またはデフォルトのエグゼキュータールックアップアルゴリズムに依存するときに使用する BeanFactory を設定します。

  次で指定:

  インターフェース BeanFactoryAware 内の setBeanFactory 

  パラメーター:

  beanFactory - 所有 BeanFactory（非 null）。Bean は、ファクトリのメソッドをすぐに呼び出すことができます。

  関連事項:

  findQualifiedExecutor(BeanFactory, String), getDefaultExecutor(BeanFactory)

• determineAsyncExecutor

  @Nullable
  protected AsyncTaskExecutor determineAsyncExecutor(java.lang.reflect.Method method)

  指定されたメソッドを実行するときに使用する特定のエグゼキューターを決定します。できれば AsyncListenableTaskExecutor 実装を返す必要があります。

  戻り値:

  使用するエグゼキュータ (または null、ただしデフォルトのエグゼキュータが利用できない場合)

• getExecutorQualifier

  @Nullable
  protected abstract java.lang.String getExecutorQualifier(java.lang.reflect.Method method)

  指定された非同期メソッドの実行時に使用されるエグゼキューターの修飾子または Bean 名を返します。通常、これはアノテーション属性の形式で指定されます。空の文字列または null を返すことは、特定の実行プログラムが指定されておらず、デフォルトの実行プログラムを使用する必要があることを示しています。

  パラメーター:

  method - エグゼキューター修飾子メタデータをインスペクションするメソッド

  戻り値:

  指定されている場合は修飾子、それ以外の場合は空の文字列または null

  関連事項:

  determineAsyncExecutor(Method), findQualifiedExecutor(BeanFactory, String)

• findQualifiedExecutor

  @Nullable
  protected java.util.concurrent.Executor findQualifiedExecutor(@Nullable
                                                                          BeanFactory beanFactory,
                                                                          java.lang.String qualifier)

  指定された修飾子のターゲットエグゼキューターを取得します。

  パラメーター:

  qualifier - 解決する修飾子

  戻り値:

  ターゲットエグゼキューター、または使用可能な null がない場合

  導入:

  4.2.6

  関連事項:

  getExecutorQualifier(Method)

• getDefaultExecutor

  @Nullable
  protected java.util.concurrent.Executor getDefaultExecutor(@Nullable
                                                                       BeanFactory beanFactory)

  このアドバイスインスタンスのデフォルトエグゼキュータを取得またはビルドします。ここから返されたエグゼキュータは、さらに使用するためにキャッシュされます。

  デフォルトの実装では、コンテキスト内で一意の TaskExecutor Bean を検索するか、それ以外の場合は "taskExecutor" という名前の Executor Bean を検索します。どちらも解決できない場合、この実装は null を返します。

  パラメーター:

  beanFactory - デフォルトのエグゼキューター検索に使用する BeanFactory

  戻り値:

  デフォルトのエグゼキューター、または使用可能なものがなければ null 

  導入:

  4.2.6

  関連事項:

  findQualifiedExecutor(BeanFactory, String), DEFAULT_TASK_EXECUTOR_BEAN_NAME

• doSubmit

  @Nullable
  protected java.lang.Object doSubmit(java.util.concurrent.Callable<java.lang.Object> task,
                                                AsyncTaskExecutor executor,
                                                java.lang.Class<?> returnType)

  選択したエグゼキューターで特定のタスクを実際に実行するためのデリゲート。

  パラメーター:

  task - 実行するタスク

  executor - 選ばれた執行者

  returnType - 宣言された戻り型 (潜在的に Future バリアント)

  戻り値:

  実行結果 (潜在的に対応する Future ハンドル)

• handleError

  protected void handleError(java.lang.Throwable ex,
                             java.lang.reflect.Method method,
                             java.lang.Object... params)
                      throws java.lang.Exception

  指定された Method を非同期で呼び出している間にスローされた致命的なエラーを処理します。

  メソッドの戻り値の型が Future オブジェクトの場合、元の例外を上位レベルにスローするだけで伝播できます。ただし、他のすべての場合、例外はクライアントに返送されません。後者の場合、現在の AsyncUncaughtExceptionHandler がそのような例外を管理するために使用されます。

  パラメーター:

  ex - 処理する例外

  method - 呼び出されたメソッド

  params - メソッドの呼び出しに使用されるパラメーター

  例外:

  java.lang.Exception