SwingWorker (Java Platform SE 7)

java.lang.Object
- javax.swing.SwingWorker<T,V>

型パラメータ:
T - この SwingWorker's の doInBackground メソッドおよび get メソッドによって返される結果の型
V - この SwingWorker's の publish メソッドおよび process メソッドを使って中間結果を計算するために使用する型

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

Runnable, Future<T>, RunnableFuture<T>
```
public abstract class SwingWorker<T,V>
extends Object
implements RunnableFuture<T>
```
GUI とやりとりする時間のかかるタスクを、バックグラウンドスレッドで実行するための abstract クラスです。複数のバックグラウンドスレッドを使用してこうしたタスクを実行できます。ただし、特定の SwingWorker のスレッドを選択する厳密な方法は指定されていないため、それに依存してはいけません。
Swing を使ってマルチスレッドアプリケーションを記述する場合は、次の 2 つの制約に注意してください (詳細は「How to Use Threads」を参照)。
- イベントディスパッチスレッドでは時間のかかるタスクを実行しないようにしてください。アプリケーションが応答しなくなります。
- Swing コンポーネントには、イベントディスパッチスレッド上でのみアクセスするようにしてください。
これらの制約があるため、時間のかかる GUI アプリケーションには、1) 時間のかかるタスクを実行するスレッドと、2) GUI 関連のすべての作業を実行するイベントディスパッチスレッド (EDT) の少なくとも 2 つのスレッドが必要になります。このように複数のスレッドを使用する場合はスレッド間通信を行う必要がありますが、この機能は簡単に実装できない場合があります。
SwingWorker は、バックグラウンドスレッドで実行時間の長いタスクを実行する必要があり、その実行中または実行完了後に UI を更新する必要がある場合を想定して設計されています。SwingWorker のサブクラスは、バックグラウンドで計算を行うため、doInBackground() メソッドを実装する必要があります。
ワークフロー
SwingWorker のライフサイクル内には、次の 3 つのスレッドが存在します。
- 現在のスレッド: execute() メソッドはこのスレッド上で呼び出されます。このメソッドは、ワーカースレッドでの SwingWorker の実行スケジュールを立て、その情報をただちに返します。get メソッドを使って SwingWorker の完了を待機することもできます。
- ワーカースレッド: doInBackground() メソッドはこのスレッド上で呼び出されます。ここで、すべてのバックグラウンド作業が発生します。PropertyChangeListeners にバウンドプロパティーの変更を通知するには、firePropertyChange メソッドと getPropertyChangeSupport() メソッドを使用します。デフォルトでは、state と progress の 2 つのバウンドプロパティーを使用できます。
- イベントディスパッチスレッド: Swing 関連のすべての作業は、このスレッド上で発生します。 SwingWorker は process メソッドと done() メソッドを呼び出し、このスレッド上のすべての PropertyChangeListeners に通知します。
現在のスレッドがイベントディスパッチスレッドである場合もあります。
ワーカースレッド上で doInBackground メソッドが呼び出される前に、SwingWorker はすべての PropertyChangeListeners に、state プロパティーの値が StateValue.STARTED に変更されたことを通知します。doInBackground メソッドの実行が完了すると、done メソッドが実行されます。続いて、SwingWorker はすべての PropertyChangeListeners に、state プロパティーの値が StateValue.DONE に変更されたことを通知します。
SwingWorker は 1 回だけ実行されるように設計されています。SwingWorker を複数回実行しても、doInBackground メソッドは 1 回しか呼び出されません。
使用例
次に、もっとも単純な使用例を示します。一部の処理はバックグラウンドで実行されます。実行が完了したら、Swing コンポーネントを更新します。
ここでは、「Meaning of Life」を検索し、結果を JLabel に表示します。
```
   final JLabel label;
   class MeaningOfLifeFinder extends SwingWorker<String, Object> {
       @Override
       public String doInBackground() {
           return findTheMeaningOfLife();
       }

       @Override
       protected void done() {
           try {
               label.setText(get());
           } catch (Exception ignore) {
           }
       }
   }

   (new MeaningOfLifeFinder()).execute();
 
```
次の例は、準備の完了したデータをイベントディスパッチスレッド上で処理する場合に使用できます。
ここでは、最初の N 個の素数を検索し、結果を JTextArea に表示します。これは計算処理なので、JProgressBar で進捗状況を更新する必要があります。また、検索された素数を System.out に出力する必要があります。
```
 class PrimeNumbersTask extends
         SwingWorker<List<Integer>, Integer> {
     PrimeNumbersTask(JTextArea textArea, int numbersToFind) {
         //initialize
     }

     @Override
     public List<Integer> doInBackground() {
         while (! enough && ! isCancelled()) {
                 number = nextPrimeNumber();
                 publish(number);
                 setProgress(100 * numbers.size() / numbersToFind);
             }
         }
         return numbers;
     }

     @Override
     protected void process(List<Integer> chunks) {
         for (int number : chunks) {
             textArea.append(number + "\n");
         }
     }
 }

 JTextArea textArea = new JTextArea();
 final JProgressBar progressBar = new JProgressBar(0, 100);
 PrimeNumbersTask task = new PrimeNumbersTask(textArea, N);
 task.addPropertyChangeListener(
     new PropertyChangeListener() {
         public  void propertyChange(PropertyChangeEvent evt) {
             if ("progress".equals(evt.getPropertyName())) {
                 progressBar.setValue((Integer)evt.getNewValue());
             }
         }
     });

 task.execute();
 System.out.println(task.get()); //prints all prime numbers we have got
 
```
SwingWorker は Runnable を実装するので、SwingWorker を Executor に送信して実行できます。
導入されたバージョン:

1.6

ネストされたクラスのサマリー

ネストされたクラス
修飾子と型クラスと説明

static class SwingWorker.StateValue
state バウンドプロパティーの値です。

ネストされたクラス
修飾子と型	クラスと説明
`static class`	`SwingWorker.StateValue` `state` バウンドプロパティーの値です。

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

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

SwingWorker()
この SwingWorker を構築します。

コンストラクタ
コンストラクタと説明
`SwingWorker()` この `SwingWorker` を構築します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`void`	`addPropertyChangeListener(PropertyChangeListener listener)` リスナーリストに `PropertyChangeListener` を追加します。
`boolean`	`cancel(boolean mayInterruptIfRunning)` このタスクの実行の取り消しを試みます。
`protected abstract T`	`doInBackground()` 結果を計算するか、計算できない場合は例外をスローします。
`protected void`	`done()` `doInBackground` メソッドの実行完了後、イベントディスパッチスレッドで実行されます。
`void`	`execute()` ワーカースレッドでの `SwingWorker` の実行スケジュールを作成します。
`void`	`firePropertyChange(String propertyName, Object oldValue, Object newValue)` すべての登録済みリスナーにバウンドプロパティーが更新されたことを報告します。
`T`	`get()` 必要に応じて計算が完了するまで待機し、その後、計算結果を取得します。
`T`	`get(long timeout, TimeUnit unit)` 必要に応じて、最大で指定された時間、計算が完了するまで待機し、その後、計算結果が利用可能な場合は結果を取得します。
`int`	`getProgress()` `progress` バウンドプロパティーを返します。
`PropertyChangeSupport`	`getPropertyChangeSupport()` この `SwingWorker` の `PropertyChangeSupport` を返します。
`SwingWorker.StateValue`	`getState()` `SwingWorker` 状態バウンドプロパティーを返します。
`boolean`	`isCancelled()` このタスクが正常に完了する前に取り消された場合は `true` を返します。
`boolean`	`isDone()` このタスクが完了した場合は `true` を返します。
`protected void`	`process(List<V> chunks)` イベントディスパッチスレッドで、`publish` メソッドから非同期でデータチャンクを受信します。
`protected void`	`publish(V... chunks)` `process(java.util.List<V>)` メソッドにデータチャンクを送信します。
`void`	`removePropertyChangeListener(PropertyChangeListener listener)` `PropertyChangeListener` をリスナーリストから削除します。
`void`	`run()` 取り消されていなければ、この `Future` に計算結果を設定します。
`protected void`	`setProgress(int progress)` `progress` バウンドプロパティーを設定します。

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

- コンストラクタの詳細
  - SwingWorker
```
public SwingWorker()
```
    この SwingWorker を構築します。
- メソッドの詳細
  - doInBackground
```
protected abstract T doInBackground()
                             throws Exception
```
    結果を計算するか、計算できない場合は例外をスローします。
    このメソッドは 1 回だけ実行されます。
    注: このメソッドは、バックグラウンドスレッドで実行されます。
    
    戻り値:
    計算結果
    
    例外:
    
    Exception - 結果を計算できなかった場合
  - run
```
public final void run()
```
    取り消されていなければ、この Future に計算結果を設定します。
    
    定義:
    
    run、インタフェース: Runnable
    
    定義:
    
    run、インタフェース: RunnableFuture<T>
    
    関連項目:
    Thread.run()
  - publish
```
@SafeVarargs
protected final void publish(V... chunks)
```
    process(java.util.List<V>) メソッドにデータチャンクを送信します。このメソッドは doInBackground メソッド内部で使用され、イベントディスパッチスレッド上での処理のため process メソッド内部で中間結果を配信します。
    process メソッドはイベントディスパッチスレッド上で非同期で呼び出されるので、process メソッドが実行される前に、publish メソッドが複数回呼び出されることがあります。パフォーマンスの向上のため、これらのすべての呼び出しは 1 回の呼び出しにまとめられます。各呼び出しの引数は連結されます。
    例を示します。
```
 publish("1");
 publish("2", "3");
 publish("4", "5", "6");
 
```
    結果は次のようになります。
```
 process("1", "2", "3", "4", "5", "6")
 
```
    使用例。このコード (抜粋) は、テーブルデータをロードし、このテーブルデータを使って DefaultTableModel を更新します。これはイベントディスパッチスレッド上で呼び出されるので、process メソッド内部で tableModel が変更される危険性はありません。
```
 class TableSwingWorker extends
         SwingWorker<DefaultTableModel, Object[]> {
     private final DefaultTableModel tableModel;

     public TableSwingWorker(DefaultTableModel tableModel) {
         this.tableModel = tableModel;
     }

     @Override
     protected DefaultTableModel doInBackground() throws Exception {
         for (Object[] row = loadData();
                  ! isCancelled() && row != null;
                  row = loadData()) {
             publish((Object[]) row);
         }
         return tableModel;
     }

     @Override
     protected void process(List<Object[]> chunks) {
         for (Object[] row : chunks) {
             tableModel.addRow(row);
         }
     }
 }
 
```
    パラメータ:
    chunks - 処理対象となる中間結果
    関連項目:
    process(java.util.List<V>)
  - process
```
protected void process(List<V> chunks)
```
    イベントディスパッチスレッドで、publish メソッドから非同期でデータチャンクを受信します。
    詳細については、publish(V...) メソッドを参照してください。
    
    パラメータ:
    chunks - 処理対象となる中間結果
    関連項目:
    publish(V...)
  - done
```
protected void done()
```
    doInBackground メソッドの実行完了後、イベントディスパッチスレッドで実行されます。デフォルト実装は何も実行しません。サブクラスは、このメソッドをオーバーライドして、イベントディスパッチスレッド上で完了処理を実行することがあります。このメソッドの実装内部でステータスを照会して、このタスクの結果や、このタスクが取り消されていないかどうかを確認できます。
    
    関連項目:
    doInBackground(), isCancelled(), get()
  - setProgress
```
protected final void setProgress(int progress)
```
    progress バウンドプロパティーを設定します。0 から 100 の値を指定してください。
    PropertyChangeListener メソッドはイベントディスパッチスレッド上で非同期で通知を受け取るので、PropertyChangeListeners が呼び出される前に、setProgress メソッドが複数回呼び出されることがあります。パフォーマンスの向上のため、これらのすべての呼び出しは 1 回の呼び出しにまとめられます。この場合、最後の呼び出しの引数だけが有効になります。
    たとえば、次の呼び出しがあるとします。
```
 setProgress(1);
 setProgress(2);
 setProgress(3);
 
```
    これは、値 3 を持つ 1 回の PropertyChangeListener 通知にまとめられます。
    パラメータ:
    progress - 設定する進捗値
    
    例外:
    
    IllegalArgumentException - 0 から 100 以外の値を指定した場合
  - getProgress
```
public final int getProgress()
```
    progress バウンドプロパティーを返します。
    
    戻り値:
    progress バウンドプロパティー。
  - execute
```
public final void execute()
```
    ワーカースレッドでの SwingWorker の実行スケジュールを作成します。多数のワーカースレッドを使用できます。すべてのワーカースレッドがほかの SwingWorkers の処理でビジー状態になっている場合、この SwingWorker は待機キューに入ります。
    注: SwingWorker は 1 回だけ実行されるように設計されています。SwingWorker を複数回実行しても、doInBackground メソッドは 1 回しか呼び出されません。
  - cancel
```
public final boolean cancel(boolean mayInterruptIfRunning)
```
    このタスクの実行の取り消しを試みます。タスクがすでに完了していた場合、すでに取り消されていた場合、またはその他の理由で取り消しできなかった場合、この試みは失敗します。その試みが成功し、cancel の呼び出し時にこのタスクが起動しなかった場合、このタスクが実行されることはありません。タスクが起動済みの場合は、このタスクの停止を試みる際、このタスクを実行しているスレッドに割り込む必要があるかどうかは、mayInterruptIfRunning パラメータで判断します。
    このメソッドが復帰すると、その後の Future.isDone() の呼び出しは常に true を返します。このメソッドが true を返した場合、後続の Future.isCancelled() の呼び出しは常に true を返します。
    
    定義:
    
    cancel、インタフェース: Future<T>
    
    パラメータ:
    mayInterruptIfRunning - このタスクを実行しているスレッドに割り込む必要がある場合は true、そうでない場合は、実行中のタスクを完了できる
    
    戻り値:
    タスクを取り消せなかった場合は false (通常はタスクがすでに正常に完了していたため)、そうでない場合は true
  - isCancelled
```
public final boolean isCancelled()
```
    このタスクが正常に完了する前に取り消された場合は true を返します。
    
    定義:
    
    isCancelled、インタフェース: Future<T>
    
    戻り値:
    このタスクが完了する前に取り消された場合は true
  - isDone
```
public final boolean isDone()
```
    このタスクが完了した場合は true を返します。完了の理由は、正常終了、例外、取り消しなどがありますが、いずれの場合もこのメソッドは true を返します。
    
    定義:
    
    isDone、インタフェース: Future<T>
    
    戻り値:
    このタスクが完了した場合は true
  - get
```
public final T get()
            throws InterruptedException,
                   ExecutionException
```
    必要に応じて計算が完了するまで待機し、その後、計算結果を取得します。
    注: イベントディスパッチスレッド上で get を呼び出すと、この SwingWorker の実行が完了するまで、すべてのイベント (再ペイントなど) の処理がブロックされます。
    イベントディスパッチスレッド上で SwingWorker をブロックするには、モーダルダイアログを使用することをお勧めします。
    例を示します。
```
 class SwingWorkerCompletionWaiter extends PropertyChangeListener {
     private JDialog dialog;

     public SwingWorkerCompletionWaiter(JDialog dialog) {
         this.dialog = dialog;
     }

     public void propertyChange(PropertyChangeEvent event) {
         if ("state".equals(event.getPropertyName())
                 && SwingWorker.StateValue.DONE == event.getNewValue()) {
             dialog.setVisible(false);
             dialog.dispose();
         }
     }
 }
 JDialog dialog = new JDialog(owner, true);
 swingWorker.addPropertyChangeListener(
     new SwingWorkerCompletionWaiter(dialog));
 swingWorker.execute();
 //the dialog will be visible until the SwingWorker is done
 dialog.setVisible(true);
 
```
    定義:
    
    get、インタフェース: Future<T>
    
    戻り値:
    計算結果
    
    例外:
    
    InterruptedException - 待機中に現在のスレッドで割り込みが発生した場合
    
    ExecutionException - 計算で例外がスローされた場合
  - get
```
public final T get(long timeout,
    TimeUnit unit)
            throws InterruptedException,
                   ExecutionException,
                   TimeoutException
```
    必要に応じて、最大で指定された時間、計算が完了するまで待機し、その後、計算結果が利用可能な場合は結果を取得します。
    詳細については、get() を参照してください。
    
    定義:
    
    get、インタフェース: Future<T>
    
    パラメータ:
    timeout - 待機する最長時間
    unit - timeout 引数の時間単位
    
    戻り値:
    計算結果
    
    例外:
    
    InterruptedException - 待機中に現在のスレッドで割り込みが発生した場合
    
    ExecutionException - 計算で例外がスローされた場合
    
    TimeoutException - 待機がタイムアウトになった場合
  - addPropertyChangeListener
```
public final void addPropertyChangeListener(PropertyChangeListener listener)
```
    リスナーリストに PropertyChangeListener を追加します。リスナーは、すべてのプロパティーに対して登録されます。同じリスナーオブジェクトを複数回追加でき、追加した回数だけリスナーオブジェクトが呼び出されます。listener が null の場合、例外はスローされず、何も処理は行われません。
    注: これは簡易ラッパーです。すべての処理は、getPropertyChangeSupport() から PropertyChangeSupport に委譲されます。
    
    パラメータ:
    listener - 追加される PropertyChangeListener
  - removePropertyChangeListener
```
public final void removePropertyChangeListener(PropertyChangeListener listener)
```
    PropertyChangeListener をリスナーリストから削除します。すべてのプロパティーに登録された PropertyChangeListener を削除します。同じイベントソースに listener が 2 回以上追加された場合は、削除されたあとに 1 回少ない通知が行われます。listener が null の場合、または追加されなかった場合、例外はスローされず、何も処理は行われません。
    注: これは簡易ラッパーです。すべての処理は、getPropertyChangeSupport() から PropertyChangeSupport に委譲されます。
    
    パラメータ:
    listener - 削除する PropertyChangeListener
  - firePropertyChange
```
public final void firePropertyChange(String propertyName,
                      Object oldValue,
                      Object newValue)
```
    すべての登録済みリスナーにバウンドプロパティーが更新されたことを報告します。old 値と new 値が等しく、null でない場合、イベントはトリガーされません。
    この SwingWorker は、生成されるすべてのイベントのソースになります。
    イベントディスパッチスレッドを取り消した場合、PropertyChangeListeners はイベントディスパッチ上で非同期で通知を受信します。
    注: これは簡易ラッパーです。すべての処理は、getPropertyChangeSupport() から PropertyChangeSupport に委譲されます。
    
    パラメータ:
    propertyName - 変更されたプロパティーのプログラム名
    oldValue - プロパティーの古い値
    newValue - プロパティーの新しい値
  - getPropertyChangeSupport
```
public final PropertyChangeSupport getPropertyChangeSupport()
```
    この SwingWorker の PropertyChangeSupport を返します。このメソッドは、バウンドプロパティーに頻繁にアクセスする必要がある場合に使用します。
    この SwingWorker は、生成されるすべてのイベントのソースになります。
    注: firePropertyChange または fireIndexedPropertyChange がイベントディスパッチスレッドを取り消した場合、返される PropertyChangeSupport は、イベントディスパッチスレッド上のすべての PropertyChangeListener に非同期で通知を送信します。
    
    戻り値:
    この SwingWorker の PropertyChangeSupport
  - getState
```
public final SwingWorker.StateValue getState()
```
    SwingWorker 状態バウンドプロパティーを返します。
    
    戻り値:
    現在の状態

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

クラス SwingWorker<T,V>

ネストされたクラスのサマリー

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

メソッドのサマリー

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

コンストラクタの詳細

SwingWorker

メソッドの詳細

doInBackground

run

publish

process

done

setProgress

getProgress

execute

cancel

isCancelled

isDone

get

get

addPropertyChangeListener

removePropertyChangeListener

firePropertyChange

getPropertyChangeSupport

getState