Java Swing中的并发：使用SwingWorker线程模式

前言

本文介绍Java SE 6中的SwingWorker线程工作模式，讨论并发机制在Swing编程中的应用。
本文翻译自英文原作：http://java.sun.com/docs/books/tutorial/uiswing/concurrency/index.html。
SwingWorker的API：http://cngeeker.com/extend/docs/api/javase-8u51/javax/swing/SwingWorker.html。

基本知识

谨慎地使用并发机制对Swing开发人员来说非常重要。一个好的Swing程序使用并发机制来创建不会失去响应的用户接口-不管是什么样的用户交互，程序总能够对其给出响应。创建一个有响应的程序，开发人员必须学会如何在Swing框架中使用多线程。

一个Swing开发人员将会与下面几类线程打交道：

1）Initial threads（初始线程），此类线程将执行初始化应用代码；
2）The event dispatch thread（事件派发线程）,所有的事件处理代码在这里执行。大多数与Swing框架交互的代码也必须执行这个线程；
3）Worker threads（工作线程）,也称作background threads（后台线程）,此类线程将执行所有消耗时间的任务。

开发人员不需要在代码中显式的创建这些线程：它们是由runtime或Swing框架提供的。开发人员的工作就是利用这些线程来创建具有响应的，持久的Swing程序。

如同所有其他在Java平台上运行的程序，一个Swing程序可以创建额外的线程和线程池，这需要使用本文即将介绍的方法。本文将介绍以上这三种线程。工作线程的讨论将涉及到使用javax.swing.SwingWorker类。这个类有许多有用的特性，包括在工作线程任务与其他线程任务之间的通信与协作。

Chapter 1：初始线程

每个程序都会在应用逻辑开始时生成一系列的线程。在标准的程序中，只有一个这样的线程：这个线程将调用程序主类中的main方法。在applet中初始线程是applet对象的构造子，它将调用init方法；这些actions可能在一个单一的线程中执行，或在两个或三个不同的线程中，这些都依据Java平台的具体实现。在本文中，我们称这类线程为初始线程（initial threads）。

在Swing程序中，初始线程没有很多事情要做。它们最基本的任务是创建一个Runnable对象，用于初始化GUI以及为那些用于执行事件派发线程中的事件的对象编排顺序。一旦GUI被创建，程序将主要由GUI事件驱动，其中的每个事件驱动将引起一个在事件派发线程中事件的执行。程序代码可以编排额外的任务给事件驱动线程（前提是它们会被很快的执行，这样才不会干扰事件的处理）或创建工作线程（用于执行消耗时间的任务）。

一个初始线程编排GUI创建任务是通过调用javax.swing.SwingUtilities.invokeLater或javax.swing.SwingUtilities.invokeAndWait。这两个方法都带有一个唯一的参数：Runnable用于定义新的任务。它们唯一的区别是：invokerLater仅仅编排任务并返回；invokeAndWait将等待任务执行完毕才返回。

看下面示例：

SwingUtilities.invokeLater(new Runnable()) {
    public void run() {
        createAndShowGUI();
    }
}

在applet中，创建GUI的任务必须被放入init方法中并且使用invokeAndWait；否则，初始过程将有可能在GUI创建完之前完成，这样将有可能出现问题。在其他的情况下，编排GUI创建任务通常是初始线程中最后一个被执行的，所以使用invokeLater或invokeAndWait都可以。

为什么初始线程不直接创建GUI？因为几乎所有的用于创建和交互Swing组件的代码必须在事件派发线程中执行。这个约束将在下文中讨论。

Chapter 2：事件派发线程

Swing事件的处理代码在一个特殊的线程中执行，这个线程被称为事件派发线程。大部分调用Swing方法的代码都在这个线程中被执行。这样做是必要的，因为大部分Swing对象是“非线程安全的”。

可以将代码的执行想象成在事件派发线程中执行一系列短小的任务。大部分任务被事件处理方法调用，诸如ActionListener.actionPerformed。其余的任务将被程序代码编排，使用invokeLater或invokeAndWait。在事件派发线程中的任务必须能够被快速执行完成，如若不然，未经处理的事件被积压，用户界面将变得“响应迟钝”。

如果你需要确定你的代码是否是在事件派发线程中执行，可调用javax.swing.SwingUtilities.isEventDispatchThread。

Chapter 3：工作线程与SwingWorker

当一个Swing程序需要执行一个长时间的任务，通常将使用一个工作线程来完成。每个任务在一个工作线程中执行，它是一个javax.swing.SwingWorker类的实例。SwingWorker类是抽象类；你必须定义它的子类来创建一个SwingWorker对象；通常使用匿名内部类来这做这些。

SwingWorker提供一些通信与控制的特征：

1）SwingWorker的子类可以定义一个方法，done。当后台任务完成的时候，它将自动的被事件派发线程调用。
2）SwingWorker类实现java.util.concurrent.Future。这个接口允许后台任务提供一个返回值给其他线程。该接口中的方法还提供允许撤销后台任务以及确定后台任务是被完成了还是被撤销的功能。
3）后台任务可以通过调用SwingWorker.publish来提供中间结果，事件派发线程将会调用该方法。
4）后台任务可以定义绑定属性。绑定属性的变化将触发事件，事件派发线程将调用事件处理程序来处理这些被触发的事件。

Chapter 4：简单的后台任务

下面介绍一个示例，这个任务非常简单，但它是潜在地消耗时间的任务。TumbleItem applet导入一系列的图片文件。如果这些图片文件是通过初始线程导入的，那么将在GUI出现之前有一段延迟。如果这些图片文件是在事件派发线程中导入的，那么GUI将有可能出现临时无法响应的情况。

为了解决这些问题，TumbleItem类在它初始化时创建并执行了一个StringWorker类的实例。这个对象的doInBackground方法，在一个工作线程中执行，将图片导入一个ImageIcon数组，并且返回它的一个引用。接着done方法，在事件派发线程中执行，得到返回的引用，将其放在applet类的成员变量imgs中。这样做可以允许TumbleItem类立刻创建GUI，而不必等待图片导入完成。

下面的示例代码定义和实现了一个SwingWorker对象：

SwingWorker worker = new SwingWorker<ImageIcon[], Void>() {
    @Override
    public ImageIcon[] doInBackground() {
        final ImageIcon[] innerImgs = new ImageIcon[nimgs];
        for (int i = 0; i < nimgs; i++) {
            innerImgs = loadImage(i+1);
        }
        return innerImgs;
    }
 
    @Override
    public void done() {
        //Remove the "Loading images" label.
        animator.removeAll();
        loopslot = -1;
        try {
            imgs = get();
        } catch (InterruptedException ignore) {}
        catch (java.util.concurrent.ExecutionException e) {
            String why = null;
            Throwable cause = e.getCause();
            if (cause != null) {
                why = cause.getMessage();
            } else {
                why = e.getMessage();
            }
            System.err.println("Error retrieving file: " + why);
        }
    }
};

所有的继承自SwingWorker的子类都必须实现doInBackground实现done方法是可选的。

注意，SwingWorker是一个范型类，有两个参数。第一个类型参数指定doInBackground的返回类型。同时也是get方法的类型，它可以被其他线程调用以获得来自于doInBackground的返回值。第二个类型参数指定中间结果的类型，这个例子没有返回中间结果，所以设为void。

使用get方法，可以使对象imgs的引用（在工作线程中创建）在事件派发线程中得到使用。这样就可以在线程之间共享对象。

实际上有两个方法来得到doInBackground类返回的对象：

1）调用SwingWorker.get没有参数。如果后台任务没有完成，get方法将阻塞直到它完成；
2）调用SwingWorker.get带参数指定timeout。如果后台任务没有完成，阻塞直到它完成-除非timeout期满，在这种情况下，get将抛出java.util.concurrent.TimeoutException。

Chapter 5：具有中间结果的任务

让一个正在工作的后台任务提供中间结果是很有用处的。后台任务可以调用SwingWorker.publish方法来做到这个。这个方法接受许多参数。每个参数必须是由SwingWorker的第二个类型参数指定的一种。

可以覆盖（override）SwingWorker.process来保存由publish方法提供的结果。这个方法是由事件派发线程调用的。来自publish方法的结果集通常是由一个process方法收集的。

我们看一下Filpper.java提供的实例。这个程序通过一个后台任务产生一系列的随机布尔值测试java.util.Random。就好比是一个投硬币试验。为了报告它的结果，后台任务使用了一个对象FlipPair：

private static class FlipPair {
    private final long heads, total;
    FlipPair(long heads, long total) {
        this.heads = heads;
        this.total = total;
    }
}

heads表示true的结果；total表示总的投掷次数。

后台程序是一个FilpTask的实例：

private class FlipTask extends SwingWorker<Void, FlipPair> {

因为任务没有返回一个最终结果，这里不需要指定第一个类型参数是什么，使用Void。在每次“投掷”后任务调用publish：

@Override
protected Void doInBackground() {
    long heads = 0;
    long total = 0;
    Random random = new Random();
    while (!isCancelled()) {
        total++;
        if (random.nextBoolean()) {
            heads++;
        }
        publish(new FlipPair(heads, total));
    }
    return null;
}

由于publish时常被调用，许多的FlipPair值将在process方法被事件派发线程调用之前被收集；process仅仅关注每次返回的最后一组值，使用它来更新GUI:

protected void process(List pairs) {
    FlipPair pair = pairs.get(pairs.size() - 1);
    headsText.setText(String.format("%d", pair.heads));
    totalText.setText(String.format("%d", pair.total));
    devText.setText(String.format("%.10g",
            ((double) pair.heads)/((double) pair.total) - 0.5));
}

Chapter 6：取消后台任务

调用SwingWorker.cancel来取消一个正在执行的后台任务。任务必须与它自己的撤销机制一致。
有两个方法来做到这一点：

1）当收到一个interrupt时，将被终止；
2）调用SwingWorker.isCanceled，如果SwingWorker调用cancel，该方法将返回true。

Chapter 7：绑定属性和状态方法

SwingWorker支持bound properties，这个在与其他线程通信时很有作用。提供两个绑定属性：progress和state。progress和state可以用于触发在事件派发线程中的事件处理任务。

通过实现一个property change listener，程序可以捕捉到progress,state或其他绑定属性的变化。

7.1 The progress Bound Variable

Progress绑定变量是一个整型变量，变化范围由0到100。它预定义了setter (the protected SwingWorker.setProgress和getter (the public SwingWorker.getProgress)方法。

7.2 The state Bound Variable
State绑定变量的变化反映了SwingWorker对象在它的生命周期中的变化过程。该变量中包含一个SwingWorker.StateValue的枚举类型。可能的值有：

1） PENDING 这个状态持续的时间为从对象的建立知道doInBackground方法被调用；
2） STARTED 这个状态持续的时间为doInBackground方法被调用前一刻直到done方法被调用前一刻；
3） DONE 对象存在的剩余时间将保持这个状态。 需要返回当前state的值可调用SwingWorker.getState。

7.3 Status Methods

两个由Future接口提供的方法，同样可以报告后台任务的状态。如果任务被取消，isCancelled返回true。此外，如果任务完成，即要么正常的完成，要么被取消，isDone返回true。

Flipper.java (3.22 KB , 下载次数: 0 , 售价: 2 金币)

10 年前 上传

请点击文件名下载附件！
售价: 2 金币  [记录]  [如何获取金钱？]  [购买]

ProgressBarDemo.java (3.94 KB , 下载次数: 1 , 售价: 2 金币)

10 年前 上传

请点击文件名下载附件！
售价: 2 金币  [记录]  [如何获取金钱？]  [购买]

TumbleItem.java (7.65 KB , 下载次数: 3 , 售价: 2 金币)

10 年前 上传

请点击文件名下载附件！
售价: 2 金币  [记录]  [如何获取金钱？]  [购买]

总结的太好了。好好看一看。

引用：潴頭鎶鎶 发表于 2015-8-28 17:29
总结的太好了。好好看一看。

猪哥相当好学

学习了

学习了

前段时间刚好出现这样的 问题

引用：shengwei729 发表于 2016-04-23 15:56
前段时间刚好出现这样的 问题

通常当Swing程序员关注到SwingWorker了，则表示已经比较资深了。。

swingworker与Android中的 AsyncTask很相似

引用：zjj7188 发表于 2016-04-26 17:43
swingworker与Android中的 AsyncTask很相似

Google 的Android 那边有不少SUN公司原来Java团队的人过去的。去查查 《Effective Java》这本书的作者，它现在是Google 的首席Java架构师。AsyncTash几乎是从SwingWokker原样搬过去的。

引用：JackJiang 发表于 2016-04-26 18:09
Google 的Android 那边有不少SUN公司原来Java团队的人过去的。去查查 《Effective Java》这本书的作者， ...

是的，android UI的设计很多都是挪用了swing的思想

对了，我还想问，对于一个初学者而言，学Java UI的设计是学swing好还是javaFx好呢。关于这个，我有点困惑

引用：zjj7188 发表于 2016-04-26 18:52
对了，我还想问，对于一个初学者而言，学Java UI的设计是学swing好还是javaFx好呢。关于这个，我有点困惑

你就当JavaFX不存在吧

引用：JackJiang 发表于 2016-04-26 21:06
你就当JavaFX不存在吧

为什么呢

引用：zjj7188 发表于 2016-04-27 18:26
为什么呢

因为没人用

学习了

很不错的说