WorkManagerTaskExecutor (Spring Framework API)

java.lang.ObjectSE
- org.springframework.jndi.JndiAccessor
- - org.springframework.jndi.JndiLocatorSupport
  - - org.springframework.scheduling.commonj.WorkManagerTaskExecutor

実装されたすべてのインターフェース:
WorkManagerSE, ExecutorSE, InitializingBean, AsyncListenableTaskExecutor, AsyncTaskExecutor, TaskExecutor, SchedulingTaskExecutor
使用すべきではありません。
5.1 以降、EE 7/8 ベースの DefaultManagedTaskExecutor を推奨
```
@DeprecatedSE
public class WorkManagerTaskExecutor
extends JndiLocatorSupport
implements AsyncListenableTaskExecutor, SchedulingTaskExecutor, WorkManagerSE, InitializingBean
```
CommonZ WorkManager に委譲する TaskExecutor 実装。WorkManagerSE インターフェースを実装します。これは、参照として、または JNDI 名を介して指定する必要があります。
これは、Spring コンテキストで CommonJ WorkManager を設定するための中心的な便利なクラスです。
また、CommonJ WorkManager インターフェース自体を実装し、すべての呼び出しをターゲット WorkManager に委譲します。呼び出し元は、Spring TaskExecutor インターフェースまたは CommonJ WorkManager インターフェースを介してこのエグゼキューターと通信するかどうかを選択できます。
CommonJ WorkManager は通常、サーバーの管理コンソールで定義されているように、アプリケーションサーバーの JNDI 環境から取得されます。
メモ: WebLogic および WebSphere の EE7/8 準拠バージョンでは、Java EE 7/8 での JSR-236 サポートに従って、DefaultManagedTaskExecutor を優先する必要があります。
導入:
2.0
作成者:
Juergen Hoeller

フィールドサマリー
- クラス org.springframework.jndi.JndiLocatorSupport から継承されたフィールド
  CONTAINER_PREFIX
- クラス org.springframework.jndi.JndiAccessor から継承されたフィールド
  logger
- インターフェース org.springframework.core.task.AsyncTaskExecutor から継承されたフィールド
  TIMEOUT_IMMEDIATE, TIMEOUT_INDEFINITE
- インターフェース commonj.work.WorkManagerSE から継承されたフィールド
  IMMEDIATESE, INDEFINITESE

コンストラクターのサマリー
コンストラクター
コンストラクターと説明
WorkManagerTaskExecutor()
使用すべきではありません。

コンストラクター
コンストラクターと説明
`WorkManagerTaskExecutor()` 使用すべきではありません。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド非推奨のメソッド
修飾子と型	メソッドと説明
`void`	`afterPropertiesSet()` 使用すべきではありません。すべての Bean プロパティを設定し、`BeanFactoryAware`、`ApplicationContextAware` などを満たした後、包含 `BeanFactory` によって呼び出されます。
`void`	`execute(RunnableSE task)` 使用すべきではありません。指定された `task` を実行します。
`void`	`execute(RunnableSE task, long startTimeout)` 使用すべきではありません。指定された `task` を実行します。
`WorkItemSE`	`schedule(WorkSE work)` 使用すべきではありません。
`WorkItemSE`	`schedule(WorkSE work, WorkListenerSE workListener)` 使用すべきではありません。
`void`	`setTaskDecorator(TaskDecorator taskDecorator)` 使用すべきではありません。実行しようとしている `Runnable`SE に適用するカスタム `TaskDecorator` を指定します。
`void`	`setWorkListener(WorkListenerSE workListener)` 使用すべきではありません。適用する CommonJ WorkListener を指定します（ある場合）。
`void`	`setWorkManager(WorkManagerSE workManager)` 使用すべきではありません。委譲先の CommonJ WorkManager を指定します。
`void`	`setWorkManagerName(StringSE workManagerName)` 使用すべきではありません。 CommonJ WorkManager の JNDI 名を設定します。
`<T> FutureSE<T>`	`submit(CallableSE<T> task)` 使用すべきではありません。 Callable タスクを送信して実行し、そのタスクを表す Future を受け取ります。
`FutureSE<?>`	`submit(RunnableSE task)` 使用すべきではありません。実行可能な Runnable タスクを送信し、そのタスクを表す Future を受け取ります。
`<T> ListenableFuture<T>`	`submitListenable(CallableSE<T> task)` 使用すべきではありません。 `Callable` タスクを実行のために送信し、そのタスクを表す `ListenableFuture` を受け取ります。
`ListenableFuture<?>`	`submitListenable(RunnableSE task)` 使用すべきではありません。 `Runnable` タスクを実行のために送信し、そのタスクを表す `ListenableFuture` を受け取ります。
`boolean`	`waitForAll(CollectionSE workItems, long timeout)` 使用すべきではありません。
`CollectionSE`	`waitForAny(CollectionSE workItems, long timeout)` 使用すべきではありません。

クラス org.springframework.jndi.JndiLocatorSupport から継承されたメソッド
convertJndiName, isResourceRef, lookup, lookup, setResourceRef

クラス org.springframework.jndi.JndiAccessor から継承されたメソッド
getJndiEnvironment, getJndiTemplate, setJndiEnvironment, setJndiTemplate

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

インターフェース org.springframework.scheduling.SchedulingTaskExecutor から継承されたメソッド
prefersShortLivedTasks

- コンストラクターの詳細
  - WorkManagerTaskExecutor
```
public WorkManagerTaskExecutor()
```
    使用すべきではありません。
- メソッドの詳細
  - setWorkManager
```
public void setWorkManager(WorkManagerSE workManager)
```
    使用すべきではありません。
    委譲先の CommonJ WorkManager を指定します。
    または、ターゲット WorkManager の JNDI 名を指定することもできます。
    関連事項:
    setWorkManagerName(java.lang.String)
  - setWorkManagerName
```
public void setWorkManagerName(StringSE workManagerName)
```
    使用すべきではありません。
    CommonJ WorkManager の JNDI 名を設定します。
    これは完全修飾 JNDI 名、または "resourceRef" が "true" に設定されている場合は現在の環境のネーミングコンテキストに関連する JNDI 名のいずれかです。
    関連事項:
    setWorkManager(commonj.work.WorkManager), JndiLocatorSupport.setResourceRef(boolean)
  - setWorkListener
```
public void setWorkListener(WorkListenerSE workListener)
```
    使用すべきではありません。
    適用する CommonJ WorkListener を指定します（ある場合）。
    この共有 WorkListener インスタンスは、この TaskExecutor のすべての execute(java.lang.Runnable) 呼び出しによって WorkManager に渡されます。
  - setTaskDecorator
```
public void setTaskDecorator(TaskDecorator taskDecorator)
```
    使用すべきではありません。
    実行しようとしている RunnableSE に適用するカスタム TaskDecorator を指定します。
    このようなデコレータは、必ずしもユーザー提供の Runnable/Callable に適用されるのではなく、実際の実行コールバック（ユーザー提供のタスクのラッパーである可能性があります）に適用されることに注意してください。
    主な使用例は、タスクの呼び出しの周囲に実行コンテキストを設定するか、タスク実行の監視 / 統計を提供することです。
    注意 : TaskDecorator 実装での例外処理は、execute 呼び出しによる単純な Runnable 実行に制限されています。#submit 呼び出しの場合、公開された Runnable は、例外を伝搬しない FutureTask になります。例外を評価するには、キャストして Future#get を呼び出す必要がある場合があります。
    導入:
    4.3
  - afterPropertiesSet
```
public void afterPropertiesSet()
                        throws NamingExceptionSE
```
    使用すべきではありません。
    インターフェースからコピーされた説明: InitializingBean
    すべての Bean プロパティを設定し、BeanFactoryAware、ApplicationContextAware などを満たした後、包含 BeanFactory によって呼び出されます。
    このメソッドにより、Bean インスタンスは、すべての Bean プロパティが設定されたときに、その全体的な構成の検証と最終的な初期化を実行できます。
    次で指定:
    インターフェース InitializingBean の afterPropertiesSet
    例外:
    NamingExceptionSE
  - execute
```
public void execute(RunnableSE task)
```
    使用すべきではありません。
    インターフェースからコピーされた説明: TaskExecutor
    指定された task を実行します。
    実装が非同期実行戦略を使用している場合、呼び出しはすぐに戻るか、同期実行の場合はブロックする可能性があります。
    次で指定:
    インターフェース ExecutorSE の executeSE
    次で指定:
    インターフェース TaskExecutor の execute
    パラメーター:
    task - 実行する Runnable (非 null)
  - execute
```
public void execute(RunnableSE task,
                    long startTimeout)
```
    使用すべきではありません。
    インターフェースからコピーされた説明: AsyncTaskExecutor
    指定された task を実行します。
    次で指定:
    インターフェース AsyncTaskExecutor の execute
    パラメーター:
    task - 実行する Runnable (非 null)
    startTimeout - タスクが開始される予定の期間（ミリ秒）。これはエグゼキューターへのヒントとして意図されており、即時タスクの優先処理を可能にします。一般的な値は AsyncTaskExecutor.TIMEOUT_IMMEDIATE または AsyncTaskExecutor.TIMEOUT_INDEFINITE（TaskExecutor.execute(Runnable) で使用されるデフォルト）です。
  - submit
```
public FutureSE<?> submit(RunnableSE task)
```
    使用すべきではありません。
    インターフェースからコピーされた説明: AsyncTaskExecutor
    実行可能な Runnable タスクを送信し、そのタスクを表す Future を受け取ります。Future は完了時に null の結果を返します。
    次で指定:
    インターフェース AsyncTaskExecutor の submit
    パラメーター:
    task - 実行する Runnable (非 null)
    戻り値:
    タスクの保留中の補完を表す Future
  - submit
```
public <T> FutureSE<T> submit(CallableSE<T> task)
```
    使用すべきではありません。
    インターフェースからコピーされた説明: AsyncTaskExecutor
    Callable タスクを送信して実行し、そのタスクを表す Future を受け取ります。Future は、完了時に Callable の結果を返します。
    次で指定:
    インターフェース AsyncTaskExecutor の submit
    パラメーター:
    task - 実行する Callable (非 null)
    戻り値:
    タスクの保留中の補完を表す Future
  - submitListenable
```
public ListenableFuture<?> submitListenable(RunnableSE task)
```
    使用すべきではありません。
    インターフェースからコピーされた説明: AsyncListenableTaskExecutor
    Runnable タスクを実行のために送信し、そのタスクを表す ListenableFuture を受け取ります。Future は完了時に null の結果を返します。
    次で指定:
    インターフェース AsyncListenableTaskExecutor の submitListenable
    パラメーター:
    task - 実行する Runnable (非 null)
    戻り値:
    保留中のタスクの補完を表す ListenableFuture
  - submitListenable
```
public <T> ListenableFuture<T> submitListenable(CallableSE<T> task)
```
    使用すべきではありません。
    インターフェースからコピーされた説明: AsyncListenableTaskExecutor
    Callable タスクを実行のために送信し、そのタスクを表す ListenableFuture を受け取ります。Future は、完了時に Callable の結果を返します。
    次で指定:
    インターフェース AsyncListenableTaskExecutor の submitListenable
    パラメーター:
    task - 実行する Callable (非 null)
    戻り値:
    保留中のタスクの補完を表す ListenableFuture
  - schedule
```
public WorkItemSE schedule(WorkSE work)
                  throws WorkExceptionSE,
                         IllegalArgumentExceptionSE
```
    使用すべきではありません。
    次で指定:
    インターフェース WorkManagerSE の scheduleSE
    例外:
    WorkExceptionSE
    IllegalArgumentExceptionSE
  - schedule
```
public WorkItemSE schedule(WorkSE work,
                         WorkListenerSE workListener)
                  throws WorkExceptionSE
```
    使用すべきではありません。
    次で指定:
    インターフェース WorkManagerSE の scheduleSE
    例外:
    WorkExceptionSE
  - waitForAll
```
public boolean waitForAll(CollectionSE workItems,
                          long timeout)
                   throws InterruptedExceptionSE
```
    使用すべきではありません。
    次で指定:
    インターフェース WorkManagerSE の waitForAllSE
    例外:
    InterruptedExceptionSE
  - waitForAny
```
public CollectionSE waitForAny(CollectionSE workItems,
                             long timeout)
                      throws InterruptedExceptionSE
```
    使用すべきではありません。
    次で指定:
    インターフェース WorkManagerSE の waitForAnySE
    例外:
    InterruptedExceptionSE

クラス WorkManagerTaskExecutor

フィールドサマリー

クラス org.springframework.jndi.JndiLocatorSupport から継承されたフィールド

クラス org.springframework.jndi.JndiAccessor から継承されたフィールド

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

インターフェース commonj.work.WorkManagerSE から継承されたフィールド

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

メソッドのサマリー

クラス org.springframework.jndi.JndiLocatorSupport から継承されたメソッド

クラス org.springframework.jndi.JndiAccessor から継承されたメソッド

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

インターフェース org.springframework.scheduling.SchedulingTaskExecutor から継承されたメソッド

コンストラクターの詳細

WorkManagerTaskExecutor

メソッドの詳細

setWorkManager

setWorkManagerName

setWorkListener

setTaskDecorator

afterPropertiesSet

execute

execute

submit

submit

submitListenable

submitListenable

schedule

schedule

waitForAll

waitForAny