本文详细介绍了在Java Swing GUI中实现实时倒计时或动态时间显示的方法。针对直接使用`Thread.sleep()`或在主线程中进行耗时操作导致GUI卡顿和无法刷新的常见问题，教程阐述了如何利用`javax.swing.Timer`组件，以非阻塞方式周期性地更新GUI元素。通过实例代码，展示了`Timer`如何与`ActionListener`结合，确保在事件调度线程（EDT）上安全高效地刷新时间显示，从而实现流畅的用户界面体验。
Java Swing GUI中实现实时更新的计时器
在Java Swing应用程序中，实现一个能够实时更新的计时器或倒计时功能是一个常见的需求。然而，许多初学者在尝试实现此类功能时，可能会遇到GUI界面卡顿、无法响应用户操作或显示内容无法及时刷新的问题。这通常是由于在不正确的线程中执行了耗时操作，或者错误地使用了阻塞方法（如Thread.sleep()）导致的。本教程将深入探讨这些问题，并提供一个基于javax.swing.Timer的健壮解决方案。
理解GUI更新与线程安全
Java Swing应用程序的界面更新和事件处理都发生在特定的线程上，这个线程被称为事件调度线程（Event Dispatch Thread, EDT）。为了保证GUI的响应性和线程安全，所有对Swing组件的修改都必须在EDT上执行。
当开发者尝试使用Thread.sleep()方法来暂停程序以实现计时效果时，如果sleep()调用发生在EDT上，它会阻塞EDT，导致整个GUI界面冻结，无法重绘，也无法处理任何用户输入。这就是为什么直接在GUI更新循环中使用Thread.sleep()会导致界面无响应的原因。
立即学习“Java免费学习笔记（深入）”；
对于周期性任务，例如每秒更新一次时间，我们需要一个非阻塞的机制，它能够定时触发一个事件，并在EDT上执行更新操作。javax.swing.Timer正是为此目的而设计的。
javax.swing.Timer的核心原理
javax.swing.Timer是一个非常适合Swing应用程序的计时器类。它具有以下关键特性：
- 非阻塞性：Timer在内部使用一个单独的线程来计时，但它会在每次计时结束后，将一个ActionEvent事件发送到EDT上。
- EDT兼容性：Timer确保其ActionListener中的actionPerformed方法总是在EDT上执行，这意味着您可以在这个方法中安全地更新Swing组件，而无需担心线程安全问题。
- 简单易用：Timer的API设计简洁明了，易于集成到Swing应用中。
实时时间显示功能实现
我们将通过一个示例来演示如何使用javax.swing.Timer实现一个实时显示当前系统时间的GUI。
1. 时间获取工具类 CurrentTime
首先，我们需要一个工具类来获取并格式化当前系统时间。
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
public class CurrentTime {
/**
* 获取当前系统时间并格式化为指定字符串。
* @return 格式化后的当前时间字符串，例如 "2023年01月01日 12时30分00秒"。
*/
public String SystemDate(){
// 获取系统默认时区当前时间
LocalDateTime now_time = LocalDateTime.now();
// 对时间进行相应的格式化
DateTimeFormatter ofPattern = DateTimeFormatter.ofPattern("yyyy年MM月dd日 HH时mm分ss秒"); // 注意：hh是12小时制，HH是24小时制
// 返回对应的信息
return now_time.format(ofPattern);
}
}注意：在DateTimeFormatter中，hh表示12小时制，而HH表示24小时制。根据需求选择合适的格式。此处为了更符合中文语境的习惯，使用了HH。
2. GUI界面构建与计时器集成 MainGUI
接下来，我们将构建主GUI界面，并在其中集成javax.swing.Timer来周期性地更新时间显示。
import java.awt.BorderLayout;
import java.awt.Font;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.swing.JPanel;
import javax.swing.SwingUtilities;
import javax.swing.Timer; // 导入Swing Timer类
public class CountdownTimerGUI {
public static void main(String[] args) {
// 使用SwingUtilities.invokeLater确保GUI的创建和更新都在EDT上进行
SwingUtilities.invokeLater(() -> {
// 创建MainGUI实例并显示
new CountdownTimerGUI().new MainGUI().showGUI();
});
}
// MainGUI作为内部类，方便代码组织
public class MainGUI {
private JLabel showLabel; // 定义JLabel为成员变量，以便Timer可以访问和更新它
private CurrentTime currentTime; // 时间工具类实例
public void showGUI(){
// 创建主窗口JFrame
JFrame frame = new JFrame("目标倒计时");
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.setSize(600,400);
frame.setLocationRelativeTo(null); // 窗口居中显示
// 创建面板JPanel
JPanel jpanel = new JPanel();
// 初始化时间工具类
currentTime = new CurrentTime();
// 创建JLabel用于显示时间
showLabel = new JLabel(currentTime.SystemDate()); // 初始显示当前时间
showLabel.setFont(new Font("宋体", Font.BOLD, 28)); // 字体设置更醒目
// 将showLabel放置在jpanel的顶部
jpanel.add(showLabel, BorderLayout.PAGE_START);
frame.add(jpanel);
frame.setVisible(true); // 使窗口可见
// 创建并启动Swing Timer
// 第一个参数是延迟（毫秒），表示Timer触发ActionListener的间隔
// 第二个参数是ActionListener，其中包含每次计时器触发时要执行的代码
Timer timer = new Timer(1000, new ActionListener() { // 每1000毫秒（1秒）触发一次
@Override
public void actionPerformed(ActionEvent event) {
// 在此方法中更新JLabel的文本
// 此方法保证在EDT上执行，因此更新GUI是安全的
String ymd_hms = currentTime.SystemDate();
showLabel.setText(ymd_hms);
}
});
timer.start(); // 启动计时器
}
}
// CurrentTime也作为内部类，方便代码组织
public class CurrentTime {
public String SystemDate(){
LocalDateTime now_time = LocalDateTime.now();
DateTimeFormatter ofPattern = DateTimeFormatter.ofPattern("yyyy年MM月dd日 HH时mm分ss秒");
return now_time.format(ofPattern);
}
}
}代码解析与注意事项
- SwingUtilities.invokeLater(): 在main方法中，我们使用SwingUtilities.invokeLater()来确保所有GUI相关的初始化代码都在EDT上执行。这是Swing编程的最佳实践，可以避免潜在的线程问题。
- JLabel作为成员变量: showLabel被定义为MainGUI类的成员变量，这样在Timer的ActionListener中就可以访问并更新它的文本。
-
Timer实例化:
- new Timer(1000, new ActionListener() { ... })：创建一个新的Timer实例。第一个参数1000表示延迟时间，单位是毫秒，即每1秒触发一次actionPerformed方法。
- ActionListener：这是一个匿名内部类，实现了ActionListener接口。当Timer触发时，其actionPerformed方法会被调用。
- actionPerformed()方法: 这是核心逻辑所在。每次Timer触发时，它会重新获取当前系统时间，并使用showLabel.setText()方法更新JLabel的显示内容。由于Swing Timer保证actionPerformed在EDT上执行，因此这里的GUI更新是完全线程安全的。
- timer.start(): 调用此方法启动计时器。计时器会按照设定的延迟时间周期性地触发事件。
- setLocationRelativeTo(null): 这是一个方便的方法，用于将窗口居中显示在屏幕上。
- 字体大小调整: showLabel.setFont(new Font("宋体", Font.BOLD, 28))将字体设置为宋体、粗体、28号，使得时间显示更清晰。
总结
通过使用javax.swing.Timer，我们能够优雅且高效地在Java Swing GUI中实现实时更新的计时器功能。Swing Timer的优势在于它能够将周期性任务的执行安排在EDT上，从而避免了线程阻塞和GUI无响应的问题，确保了应用程序的流畅性和响应性。在开发任何需要在Swing界面上周期性更新内容的应用程序时，javax.swing.Timer都是一个值得优先考虑的解决方案。
