JAVA不确定的进度条（转）

 

JAVA不确定的进度条

--------------------------------------------------------------------------------

内容：

进度条的基本用法
使用不确定模式
相关文章

sun如何使用进度条http://java.sun.com/docs/books/tutorial/uiswing/components/progress.html

相关内容：

Java 理论与实践：嗨，我的线程到哪里去了？
在 Java 应用程序中计划重复执行的任务
IBM developer kits for Java (downloads)
developerWorks Toolbox 订阅

JProgressBar 的一个细微但是重要的更新
级别：入门

John Zukowski ([e-mail])
总裁， JZ Ventures, Inc.
2003 年 12 月

开发人员用 JProgressBar 组件向用户显示一项任务的进度。针对非常长的任务或者难于精确确定完成进度的任务，Merlin 版本对 JProgressBar 增加了一个不确定模式。本月，专栏作者 John Zukowski 对 JProgressBar 的使用作了重新介绍，并讨论了它的新的不确定模式。您可以在本文的 讨论论坛 中与作者以及其他读者共享您的想法（您也可以单击文章顶部或者底部的讨论进入论坛 ）。
在 Java 2 SDK, Standard Edition，版本 1.4 中，有了一些大的变化，如增加了像 JSpinner 这样的新组件、像 SpringLayout 这样的新布局管理器、或者像 Java Logging API 这样的新 API。而另一些变化则没有这么显著，如小的改进或者对现有 API 的优化。本月关于 SpringLayout 组件的技巧就属于后一种情况。它是细微的，但是很重要。

进度条的基本用法
JProgressBar 是原来的 Swing 组件集中的一个。它提供了一种以图形方式显示进程完成进度的简单方式。当进程进行时，一个长条就会在该组件上逐渐延伸，直到任务完成并且长条全部填满。长条的移动通常是某个多线程任务的一部分，这有助于避免阻塞应用程序其余部分的进度，如常规的屏幕更新。虽然没有哪一条特定的规则说进度条必须进行线性移动，但是如果看到进程从 10% 移动到 35%，然后又回到 27%，然后再增加到 80%，最后以 0% 结束，作为用户我会觉得多少有些古怪。

用五个构造函数中的一个来构造 JProgressBar，如清单 1 所示：

清单 1. JProgressBar 构造函数

public JProgressBar()
public JProgressBar(int orientation)
public JProgressBar(int minimum, int maximum)
public JProgressBar(int orientation, int minimum, int maximum)
public JProgressBar(BoundedRangeModel model)

 

JProgressBar 需要初始化方向和值范围。方向是通过 JProgressBar 的 VERTICAL 或者 HORIZONTAL 常量确定的。默认为 HORIZONTAL。

在创建了这个组件并在屏幕上显示它后，启动第二个线程以执行需要测量其进度的任务。然后定期用 setValue() 方法更新进度条的值以显示任务的当前进展。清单 2 显示了 setValue() 的一个简单例子：

清单 2. 简单的 JProgressBar 使用方法
import javax.swing.*;
import java.awt.*;
import java.awt.event.*;
import java.lang.reflect.*;

public class ProgressSample {
static class BarThread extends Thread {
private static int DELAY = 500;
JProgressBar progressBar;

public BarThread(JProgressBar bar) {
progressBar = bar;
}

public void run() {
int minimum = progressBar.getMinimum();
int maximum = progressBar.getMaximum();
Runnable runner = new Runnable() {
public void run() {
int value = progressBar.getValue();
progressBar.setValue(value+1);
}
};
for (int i=minimum; i<maximum; i++) {
try {
SwingUtilities.invokeAndWait(runner);
// Our task for each step is to just sleep
Thread.sleep(DELAY);
} catch (InterruptedException ignoredException) {
} catch (InvocationTargetException ignoredException) {
}
}
}
}
public static void main(String args[]) {
// Initialize
final JProgressBar aJProgressBar = new JProgressBar(0, 100);

final JButton aJButton = new JButton("Start");

ActionListener actionListener = new ActionListener() {
public void actionPerformed(ActionEvent e) {
aJButton.setEnabled(false);
Thread stepper = new BarThread(aJProgressBar);
stepper.start();
}
};

aJButton.addActionListener(actionListener);

JFrame theFrame = new JFrame("Progress Bars");
theFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
Container contentPane = theFrame.getContentPane();
contentPane.add(aJProgressBar, BorderLayout.NORTH);
contentPane.add(aJButton, BorderLayout.SOUTH);
theFrame.setSize(300, 100);
theFrame.show();
}
}

 

第一次运行这段代码时，您会看到类似于图 1 的屏幕。

图 1. 开始屏幕
 

单击这个按钮，启动第二个任务，并在它运行时更新进度条。图 2 显示了运行到一半时的进度条。

图 2. 屏幕显示进度
 

这里没什么特别的。主要代码创建带有一个按钮和进度条的 GUI。当您选择按钮时，它就引发操作以更新进度条。进度条用来对某些任务进行测量。在示例程序中，这个任务就是休眠半秒 100 次。

在默认情况下，除了进度条外，没有其他关于进度的图形指示。添加如下的一行代码，您就可以在任务完成过程中，让进度条显示任务完成的百分比：

aJProgressBar.setStringPainted(true);

 

图 3 显示了我们增加了新代码的屏幕：
 
图 3. 显示完成百分比

使用不确定模式
从 Merlin 版本开始，JProgressBar 还支持另一种模式 ?? 确定。对于非固定步数的长任务，可以使用这种模式。它显示固定的动画以表明有些事情正在发生，但是它不表明完成的百分比。如果您确定了任务所要花费的时间，就可以切换回确定模式。在不确定模式下，JProgressBar 显示一个长条，在显示区域中来回移动。

清单 3 显示了这种模式的一个例子。这个新方法就是 setIndeterminate()。值为 true 意味着不确定，而值为 false 则意味着普通或者确定。

清单 3. 不确定进度条

import javax.swing.*;
import java.awt.*;
import java.awt.event.*;

public class ProgressSample2 {
public static void main(String args[]) {
final JProgressBar aJProgressBar = new JProgressBar(0, 100);
aJProgressBar.setIndeterminate(true);

JButton aJButton = new JButton("Toggle");

ActionListener actionListener = new ActionListener() {
public void actionPerformed(ActionEvent e) {
boolean indeterminate = aJProgressBar.isIndeterminate();
aJProgressBar.setIndeterminate(!indeterminate);
}
};

aJButton.addActionListener(actionListener);

JFrame theFrame = new JFrame("Indeterminate");
theFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
Container contentPane = theFrame.getContentPane();
contentPane.add(aJProgressBar, BorderLayout.NORTH);
contentPane.add(aJButton, BorderLayout.SOUTH);
theFrame.setSize(300, 100);
theFrame.show();
}
}

 

图 4 显示相关的屏幕（您需要想像这个长条是来回移动的）。按钮用于在进度条的不确定和确定模式之间进行切换。
 
图 4. 不确定模式

有两种新的 UI 默认值用于改变重绘时间间隔和循环时间：ProgressBar.repaintInterval 和 ProgressBar.cycleTime。改变这些设置 ?? 如下所示 ?? 会改变显示速度。循环时间必须是重绘时间间隔的偶数倍，所以如果间隔为 100，那么循环时间应该是 200、500 或者 1000 ?? 但不能是 750。

UIManager.put("ProgressBar.repaintInterval", new Integer(150));
UIManager.put("ProgressBar.cycleTime", new Integer(1050));

 

注意您需要在创建进度条之前设置这些值。

结束语
ProgressBar 还有很多内容，但是其他特性在 1.4 版中都没有改变。我们简单回顾了这个组件的原有使用方式，并介绍了在 Merlin 版本中它的新特性。您也可以考虑用 ProgressMonitor 或者 ProgressMonitorInputStream 监视这些长任务的进度。它们都在内部利用了 JProgressBar 的优点。

参考资料

参与有关本文的 讨论论坛（您也可以单击文章顶部或底部的讨论来访问论坛）。

细读 John Zukowski 的 全套 Merlin 的魔力 技巧。

阅读 JProgressBar 类、ProgressMonitor 类和 ProgressMonitorInputStream 类的 Javadocs。

Kelvin Lawrence 的“The Java Foundation Classes: The New Standard for Java GUI Development”（developerWorks，1998 年 5 月），这篇文章对 JFC 类做了很好的介绍，JFC 类是 Swing UI 框架的一部分。

阅读 Tom White 的“在 Java 应用程序中计划重复执行的任务”(developerWorks，2003 年 11 月)，了解关于安排这些不确定 JProgressBar 更新任务的更多信息。

从 Brian Goetz 的“Java 理论与实践：嗨，我的线程到哪里去了？”(developerWorks，2002 年 9 月)中学习更多有关管理线程的内容。

学习 Sun 的 Java Tutorial lesson on JProgressBar。

关于作者
John Zukowski 为 JZ Ventures, Inc. 做战略性 Java 顾问，通过 AnswerSquad.com 提供技术支持，并使用 SavaJe 技术 开发下一代移动电话平台。他最近的著作有 Mastering Java 2, J2SE 1.4 (Sybex，2002 年 4 月) 和 Learn Java with JBuilder 6 (Apress，2002 年 3 月)。可通过 [e-mail] 与 John 联系。  

 

JAVA不确定的进度条

--------------------------------------------------------------------------------

内容：

进度条的基本用法
使用不确定模式
结束语
参考资料
关于作者
对本文的评价

相关内容：

Java 理论与实践：嗨，我的线程到哪里去了？
在 Java 应用程序中计划重复执行的任务
IBM developer kits for Java (downloads)
developerWorks Toolbox 订阅

JProgressBar 的一个细微但是重要的更新
级别：入门

John Zukowski ([e-mail])
总裁， JZ Ventures, Inc.
2003 年 12 月

开发人员用 JProgressBar 组件向用户显示一项任务的进度。针对非常长的任务或者难于精确确定完成进度的任务，Merlin 版本对 JProgressBar 增加了一个不确定模式。本月，专栏作者 John Zukowski 对 JProgressBar 的使用作了重新介绍，并讨论了它的新的不确定模式。您可以在本文的 讨论论坛 中与作者以及其他读者共享您的想法（您也可以单击文章顶部或者底部的讨论进入论坛 ）。
在 Java 2 SDK, Standard Edition，版本 1.4 中，有了一些大的变化，如增加了像 JSpinner 这样的新组件、像 SpringLayout 这样的新布局管理器、或者像 Java Logging API 这样的新 API。而另一些变化则没有这么显著，如小的改进或者对现有 API 的优化。本月关于 SpringLayout 组件的技巧就属于后一种情况。它是细微的，但是很重要。

进度条的基本用法
JProgressBar 是原来的 Swing 组件集中的一个。它提供了一种以图形方式显示进程完成进度的简单方式。当进程进行时，一个长条就会在该组件上逐渐延伸，直到任务完成并且长条全部填满。长条的移动通常是某个多线程任务的一部分，这有助于避免阻塞应用程序其余部分的进度，如常规的屏幕更新。虽然没有哪一条特定的规则说进度条必须进行线性移动，但是如果看到进程从 10% 移动到 35%，然后又回到 27%，然后再增加到 80%，最后以 0% 结束，作为用户我会觉得多少有些古怪。

用五个构造函数中的一个来构造 JProgressBar，如清单 1 所示：

清单 1. JProgressBar 构造函数

public JProgressBar()
public JProgressBar(int orientation)
public JProgressBar(int minimum, int maximum)
public JProgressBar(int orientation, int minimum, int maximum)
public JProgressBar(BoundedRangeModel model)

 

JProgressBar 需要初始化方向和值范围。方向是通过 JProgressBar 的 VERTICAL 或者 HORIZONTAL 常量确定的。默认为 HORIZONTAL。

在创建了这个组件并在屏幕上显示它后，启动第二个线程以执行需要测量其进度的任务。然后定期用 setValue() 方法更新进度条的值以显示任务的当前进展。清单 2 显示了 setValue() 的一个简单例子：

清单 2. 简单的 JProgressBar 使用方法
import javax.swing.*;
import java.awt.*;
import java.awt.event.*;
import java.lang.reflect.*;

public class ProgressSample {
static class BarThread extends Thread {
private static int DELAY = 500;
JProgressBar progressBar;

public BarThread(JProgressBar bar) {
progressBar = bar;
}

public void run() {
int minimum = progressBar.getMinimum();
int maximum = progressBar.getMaximum();
Runnable runner = new Runnable() {
public void run() {
int value = progressBar.getValue();
progressBar.setValue(value+1);
}
};
for (int i=minimum; i<maximum; i++) {
try {
SwingUtilities.invokeAndWait(runner);
// Our task for each step is to just sleep
Thread.sleep(DELAY);
} catch (InterruptedException ignoredException) {
} catch (InvocationTargetException ignoredException) {
}
}
}
}
public static void main(String args[]) {
// Initialize
final JProgressBar aJProgressBar = new JProgressBar(0, 100);

final JButton aJButton = new JButton("Start");

ActionListener actionListener = new ActionListener() {
public void actionPerformed(ActionEvent e) {
aJButton.setEnabled(false);
Thread stepper = new BarThread(aJProgressBar);
stepper.start();
}
};

aJButton.addActionListener(actionListener);

JFrame theFrame = new JFrame("Progress Bars");
theFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
Container contentPane = theFrame.getContentPane();
contentPane.add(aJProgressBar, BorderLayout.NORTH);
contentPane.add(aJButton, BorderLayout.SOUTH);
theFrame.setSize(300, 100);
theFrame.show();
}
}

 

第一次运行这段代码时，您会看到类似于图 1 的屏幕。

图 1. 开始屏幕
 

单击这个按钮，启动第二个任务，并在它运行时更新进度条。图 2 显示了运行到一半时的进度条。

图 2. 屏幕显示进度
 

这里没什么特别的。主要代码创建带有一个按钮和进度条的 GUI。当您选择按钮时，它就引发操作以更新进度条。进度条用来对某些任务进行测量。在示例程序中，这个任务就是休眠半秒 100 次。

在默认情况下，除了进度条外，没有其他关于进度的图形指示。添加如下的一行代码，您就可以在任务完成过程中，让进度条显示任务完成的百分比：

aJProgressBar.setStringPainted(true);

 

图 3 显示了我们增加了新代码的屏幕：
 
图 3. 显示完成百分比

使用不确定模式
从 Merlin 版本开始，JProgressBar 还支持另一种模式 ?? 确定。对于非固定步数的长任务，可以使用这种模式。它显示固定的动画以表明有些事情正在发生，但是它不表明完成的百分比。如果您确定了任务所要花费的时间，就可以切换回确定模式。在不确定模式下，JProgressBar 显示一个长条，在显示区域中来回移动。

清单 3 显示了这种模式的一个例子。这个新方法就是 setIndeterminate()。值为 true 意味着不确定，而值为 false 则意味着普通或者确定。

清单 3. 不确定进度条

import javax.swing.*;
import java.awt.*;
import java.awt.event.*;

public class ProgressSample2 {
public static void main(String args[]) {
final JProgressBar aJProgressBar = new JProgressBar(0, 100);
aJProgressBar.setIndeterminate(true);

JButton aJButton = new JButton("Toggle");

ActionListener actionListener = new ActionListener() {
public void actionPerformed(ActionEvent e) {
boolean indeterminate = aJProgressBar.isIndeterminate();
aJProgressBar.setIndeterminate(!indeterminate);
}
};

aJButton.addActionListener(actionListener);

JFrame theFrame = new JFrame("Indeterminate");
theFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
Container contentPane = theFrame.getContentPane();
contentPane.add(aJProgressBar, BorderLayout.NORTH);
contentPane.add(aJButton, BorderLayout.SOUTH);
theFrame.setSize(300, 100);
theFrame.show();
}
}

 

图 4 显示相关的屏幕（您需要想像这个长条是来回移动的）。按钮用于在进度条的不确定和确定模式之间进行切换。
 
图 4. 不确定模式

有两种新的 UI 默认值用于改变重绘时间间隔和循环时间：ProgressBar.repaintInterval 和 ProgressBar.cycleTime。改变这些设置 ?? 如下所示 ?? 会改变显示速度。循环时间必须是重绘时间间隔的偶数倍，所以如果间隔为 100，那么循环时间应该是 200、500 或者 1000 ?? 但不能是 750。

UIManager.put("ProgressBar.repaintInterval", new Integer(150));
UIManager.put("ProgressBar.cycleTime", new Integer(1050));

 

注意您需要在创建进度条之前设置这些值。

结束语
ProgressBar 还有很多内容，但是其他特性在 1.4 版中都没有改变。我们简单回顾了这个组件的原有使用方式，并介绍了在 Merlin 版本中它的新特性。您也可以考虑用 ProgressMonitor 或者 ProgressMonitorInputStream 监视这些长任务的进度。它们都在内部利用了 JProgressBar 的优点。

参考资料

参与有关本文的 讨论论坛（您也可以单击文章顶部或底部的讨论来访问论坛）。

细读 John Zukowski 的 全套 Merlin 的魔力 技巧。

阅读 JProgressBar 类、ProgressMonitor 类和 ProgressMonitorInputStream 类的 Javadocs。

Kelvin Lawrence 的“The Java Foundation Classes: The New Standard for Java GUI Development”（developerWorks，1998 年 5 月），这篇文章对 JFC 类做了很好的介绍，JFC 类是 Swing UI 框架的一部分。

阅读 Tom White 的“在 Java 应用程序中计划重复执行的任务”(developerWorks，2003 年 11 月)，了解关于安排这些不确定 JProgressBar 更新任务的更多信息。

从 Brian Goetz 的“Java 理论与实践：嗨，我的线程到哪里去了？”(developerWorks，2002 年 9 月)中学习更多有关管理线程的内容。

学习 Sun 的 Java Tutorial lesson on JProgressBar。

关于作者
John Zukowski 为 JZ Ventures, Inc. 做战略性 Java 顾问，通过 AnswerSquad.com 提供技术支持，并使用 SavaJe 技术 开发下一代移动电话平台。他最近的著作有 Mastering Java 2, J2SE 1.4 (Sybex，2002 年 4 月) 和 Learn Java with JBuilder 6 (Apress，2002 年 3 月)。可通过 [e-mail] 与 John 联系。