AbstractExecutorService (Java Platform SE 7)

java.lang.Object
- java.util.concurrent.AbstractExecutorService

すべての実装されたインタフェース:

Executor、ExecutorService

直系の既知のサブクラス:

ForkJoinPool, ThreadPoolExecutor
```
public abstract class AbstractExecutorService
extends Object
implements ExecutorService
```
ExecutorService 実行メソッドのデフォルト実装を提供します。このクラスは、このパッケージで提供される FutureTask クラスがデフォルトである newTaskFor によって返される RunnableFuture を使用して、submit、invokeAny、および invokeAll メソッドを実装します。たとえば、submit(Runnable) の実装によって関連付けられた RunnableFuture が作成され、これが実行されて結果が返されます。サブクラスでは、FutureTask 以外の RunnableFuture 実装を返すように newTaskFor メソッドをオーバーライドできます。
拡張機能の例。ここでは、デフォルトの FutureTask の代わりに CustomTask クラスを使用するために ThreadPoolExecutor をカスタマイズするクラスの概略を示します。
```
 public class CustomThreadPoolExecutor extends ThreadPoolExecutor {

   static class CustomTask<V> implements RunnableFuture<V> {...}

   protected <V> RunnableFuture<V> newTaskFor(Callable<V> c) {
       return new CustomTask<V>(c);
   }
   protected <V> RunnableFuture<V> newTaskFor(Runnable r, V v) {
       return new CustomTask<V>(r, v);
   }
   // ... add constructors, etc.
 }
```
導入されたバージョン:

1.5

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

コンストラクタ
コンストラクタと説明

AbstractExecutorService()

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

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`<T> List<Future<T>>`	`invokeAll(Collection<? extends Callable<T>> tasks)` 指定されたタスクを実行し、すべて完了すると、ステータスと結果を含む Future のリストを返します。
`<T> List<Future<T>>`	`invokeAll(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit)` 指定されたタスクを実行し、すべてが完了するか時間切れになるか、そのいずれかが最初に発生した時点で、ステータスと結果を含む Future のリストを返します。
`<T> T`	`invokeAny(Collection<? extends Callable<T>> tasks)` 指定されたタスクを実行し、例外をスローせずに正常に完了したタスクが存在する場合は、その結果を返します。
`<T> T`	`invokeAny(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit)` 指定されたタスクを実行し、タイムアウトが経過する前に例外をスローせずに正常に完了したタスクが存在する場合は、その結果を返します。
`protected <T> RunnableFuture<T>`	`newTaskFor(Callable<T> callable)` 指定された呼び出し可能タスクの `RunnableFuture` を返します。
`protected <T> RunnableFuture<T>`	`newTaskFor(Runnable runnable, T value)` 指定された実行可能タスクおよびデフォルト値の `RunnableFuture` を返します。
`<T> Future<T>`	`submit(Callable<T> task)` 値を返す実行用タスクを送信して、保留状態のタスク結果を表す Future を返します。
`Future<?>`	`submit(Runnable task)` 実行用の Runnable タスクを送信し、そのタスクを表す Future を返します。
`<T> Future<T>`	`submit(Runnable task, T result)` 実行用の Runnable タスクを送信し、そのタスクを表す Future を返します。

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

インタフェース java.util.concurrent.ExecutorService から継承されるメソッド
awaitTermination, isShutdown, isTerminated, shutdown, shutdownNow

インタフェース java.util.concurrent.Executor から継承されるメソッド
execute

- コンストラクタの詳細
  - AbstractExecutorService
```
public AbstractExecutorService()
```
- メソッドの詳細
  - newTaskFor
```
protected <T> RunnableFuture<T> newTaskFor(Runnable runnable,
                               T value)
```
    指定された実行可能タスクおよびデフォルト値の RunnableFuture を返します。
    
    パラメータ:
    runnable - ラップされる実行可能タスク
    value - 返される Future のデフォルト値
    
    戻り値:
    実行時に基本となる実行可能タスクを実行し、Future として、指定された値をその結果として生成し、基本となるタスクの取り消しを提供する RunnableFuture。
    導入されたバージョン:
    
    1.6
  - newTaskFor
```
protected <T> RunnableFuture<T> newTaskFor(Callable<T> callable)
```
    指定された呼び出し可能タスクの RunnableFuture を返します。
    
    パラメータ:
    callable - ラップされる呼び出し可能タスク
    
    戻り値:
    実行時に基本となる呼び出し可能タスクを呼び出し、Future として、呼び出し可能タスクの結果をその結果として生成し、基本となるタスクの取り消しを提供する RunnableFuture。
    導入されたバージョン:
    
    1.6
  - submit
```
public Future<?> submit(Runnable task)
```
    インタフェースからコピーされた説明: ExecutorService
    
    実行用の Runnable タスクを送信し、そのタスクを表す Future を返します。Future の get メソッドは、正常に完了した時点で null を返します。
    
    定義:
    
    submit、インタフェース: ExecutorService
    
    パラメータ:
    task - 送信するタスク
    
    戻り値:
    タスクの保留完了を表す Future
    
    例外:
    
    RejectedExecutionException - タスクの実行をスケジュールできない場合
    
    NullPointerException - タスクが null の場合
  - submit
```
public <T> Future<T> submit(Runnable task,
                   T result)
```
    インタフェースからコピーされた説明: ExecutorService
    
    実行用の Runnable タスクを送信し、そのタスクを表す Future を返します。Future の get メソッドは、正常に完了した時点で指定された結果を返します。
    
    定義:
    
    submit、インタフェース: ExecutorService
    
    パラメータ:
    task - 送信するタスク
    result - 返す結果
    
    戻り値:
    タスクの保留完了を表す Future
    
    例外:
    
    RejectedExecutionException - タスクの実行をスケジュールできない場合
    
    NullPointerException - タスクが null の場合
  - submit
```
public <T> Future<T> submit(Callable<T> task)
```
    インタフェースからコピーされた説明: ExecutorService
    
    値を返す実行用タスクを送信して、保留状態のタスク結果を表す Future を返します。Future の get メソッドは、正常に完了した時点でタスクの結果を返します。
    タスクの待機をただちにブロックする場合は、result = exec.submit(aCallable).get(); の形式の構築を使用できます。
    注: Executors クラスには、クロージャーに似たほかの一般オブジェクトを変換できるメソッドセットが含まれます。たとえば、PrivilegedAction を Callable 形式に変換して、送信可能にすることができます。
    
    定義:
    
    submit、インタフェース: ExecutorService
    
    パラメータ:
    task - 送信するタスク
    
    戻り値:
    タスクの保留完了を表す Future
    
    例外:
    
    RejectedExecutionException - タスクの実行をスケジュールできない場合
    
    NullPointerException - タスクが null の場合
  - invokeAny
```
public <T> T invokeAny(Collection<? extends Callable<T>> tasks)
            throws InterruptedException,
                   ExecutionException
```
    インタフェースからコピーされた説明: ExecutorService
    
    指定されたタスクを実行し、例外をスローせずに正常に完了したタスクが存在する場合は、その結果を返します。正常に戻った時点、または例外が返された時点で、完了していないタスクは取り消されます。オペレーションの進行中に、指定されたコレクションが変更された場合、このメソッドの結果は定義されていません。
    
    定義:
    
    invokeAny、インタフェース: ExecutorService
    
    パラメータ:
    tasks - タスクのコレクション
    
    戻り値:
    タスクのいずれかによって返される結果
    
    例外:
    
    InterruptedException - 待機中に割り込みが発生した場合
    
    ExecutionException - 正常に完了したタスクがない場合
  - invokeAny
```
public <T> T invokeAny(Collection<? extends Callable<T>> tasks,
              long timeout,
              TimeUnit unit)
            throws InterruptedException,
                   ExecutionException,
                   TimeoutException
```
    インタフェースからコピーされた説明: ExecutorService
    
    指定されたタスクを実行し、タイムアウトが経過する前に例外をスローせずに正常に完了したタスクが存在する場合は、その結果を返します。正常に戻った時点、または例外が返された時点で、完了していないタスクは取り消されます。オペレーションの進行中に、指定されたコレクションが変更された場合、このメソッドの結果は定義されていません。
    
    定義:
    
    invokeAny、インタフェース: ExecutorService
    
    パラメータ:
    tasks - タスクのコレクション
    timeout - 待機する最長時間
    unit - timeout 引数の時間単位
    
    戻り値:
    タスクのいずれかによって返される結果。
    
    例外:
    
    InterruptedException - 待機中に割り込みが発生した場合
    
    ExecutionException - 正常に完了したタスクがない場合
    
    TimeoutException - タスクが正常に完了する前に、指定されたタイムアウトが経過した場合
  - invokeAll
```
public <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks)
                          throws InterruptedException
```
    インタフェースからコピーされた説明: ExecutorService
    
    指定されたタスクを実行し、すべて完了すると、ステータスと結果を含む Future のリストを返します。返されるリストの各要素に対して Future.isDone() は true になります。完了したタスクは、通常どおりか例外をスローすることで終了しています。オペレーションの進行中に、指定されたコレクションが変更された場合、このメソッドの結果は定義されていません。
    
    定義:
    
    invokeAll、インタフェース: ExecutorService
    
    パラメータ:
    tasks - タスクのコレクション
    
    戻り値:
    タスクを表す Future のリスト。リストの順序は、指定されたタスクリストのイテレータにより生成される順序と同じであり、各タスクは完了済みである。
    
    例外:
    
    InterruptedException - 待機中に割り込みが発生した場合。この場合、未完了のタスクは取り消される。
  - invokeAll
```
public <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks,
                            long timeout,
                            TimeUnit unit)
                          throws InterruptedException
```
    インタフェースからコピーされた説明: ExecutorService
    
    指定されたタスクを実行し、すべてが完了するか時間切れになるか、そのいずれかが最初に発生した時点で、ステータスと結果を含む Future のリストを返します。返されるリストの各要素に対して Future.isDone() は true になります。返された時点で、完了していないタスクは取り消されます。完了したタスクは、通常どおりか例外をスローすることで終了しています。オペレーションの進行中に、指定されたコレクションが変更された場合、このメソッドの結果は定義されていません。
    
    定義:
    
    invokeAll、インタフェース: ExecutorService
    
    パラメータ:
    tasks - タスクのコレクション
    timeout - 待機する最長時間
    unit - timeout 引数の時間単位
    
    戻り値:
    タスクを表す Future のリスト。リストの順序は、指定されたタスクリストのイテレータにより生成される順序と同じになる。オペレーションがタイムアウトにならなかった場合、各タスクは完了する。オペレーションがタイムアウトになった場合、タスクの一部は完了しない。
    
    例外:
    
    InterruptedException - 待機中に割り込みが発生した場合。この場合、未完了のタスクは取り消される

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス AbstractExecutorService

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

メソッドのサマリー

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

インタフェース java.util.concurrent.ExecutorService から継承されるメソッド

インタフェース java.util.concurrent.Executor から継承されるメソッド

コンストラクタの詳細

AbstractExecutorService

メソッドの詳細

newTaskFor

newTaskFor

submit

submit

submit

invokeAny

invokeAny

invokeAll

invokeAll