Java Swing GUI中实现实时更新的计时器与倒计时功能

本教程详细介绍了如何在java swing gui应用程序中实现实时更新的计时器或倒计时功能。针对直接在主线程中使用`thread.sleep()`导致gui冻结的问题，我们推荐使用`javax.swing.timer`。`swing timer`能够安全地在事件调度线程(edt)上周期性执行任务，确保gui的响应性和流畅更新，从而有效解决ui刷新难题。

在Java Swing应用程序中，实现一个能够实时更新的计时器或倒计时功能是一个常见的需求。然而，许多初学者在尝试通过直接在主线程中使用Thread.sleep()来暂停程序以实现周期性更新时，会遇到GUI界面卡顿、无响应的问题。这主要是因为Swing的所有UI操作都必须在事件调度线程（Event Dispatch Thread, 简称EDT）上执行。如果在EDT上执行耗时操作（如Thread.sleep()或长时间计算），就会阻塞EDT，导致GUI无法响应用户输入或刷新界面。

理解Java Swing的事件调度线程（EDT）

Java Swing是一个单线程GUI工具包，这意味着所有与UI组件的创建、修改和事件处理相关的代码都必须在EDT上运行。EDT负责处理所有的用户界面事件，如鼠标点击、键盘输入以及界面的重绘。如果EDT被长时间阻塞，应用程序就会显得“冻结”，用户体验会非常差。

因此，当我们需要在GUI中进行周期性更新时，不能直接在EDT上使用Thread.sleep()。正确的做法是使用一种机制，能够在非EDT线程中执行耗时操作，并将UI更新操作“调度”回EDT，或者使用专门为Swing设计的工具来处理周期性任务。

解决方案：使用javax.swing.Timer

javax.swing.Timer是Swing提供的一个轻量级、线程安全的工具，专门用于在指定延迟后或周期性地在EDT上执行一个或多个动作。它是实现GUI实时更新功能的理想选择，因为它能够确保所有UI更新都在EDT上进行，从而避免阻塞GUI。

立即学习“Java免费学习笔记（深入）”；

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

javax.swing.Timer的工作原理

Swing Timer通过两个主要参数进行配置：

1. 延迟（delay）: 指定每次事件触发之间的时间间隔（毫秒）。
2. 动作监听器（ActionListener）: 一个ActionListener接口的实现，其actionPerformed方法会在每次延迟结束后被调用。重要的是，这个方法总是在EDT上执行。

实现实时更新的计时器

下面我们将通过一个具体的例子，演示如何使用javax.swing.Timer在Java Swing GUI中实现一个实时显示系统时间的计时器。

示例代码结构

为了方便展示，我们将所有相关的类（主程序、GUI构建、时间获取）放在同一个文件中，并使用内部类结构，这与提供的答案一致。

import java.awt.BorderLayout;
import java.awt.Font;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

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 mainGUI = new CountdownTimerGUI().new MainGUI();
            mainGUI.showGUI();
        });
    }

    /**
     * 负责获取当前系统时间并格式化
     */
    public class CurrentTime {
        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);
        }
    }

    /**
     * 负责构建和显示GUI界面
     */
    public class MainGUI {
        private JLabel showLabel; // 将JLabel声明为成员变量，以便在Timer中访问和更新
        private CurrentTime currentTime; // 时间获取工具类实例

        public void showGUI() {
            JFrame frame = new JFrame("目标倒计时");
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            frame.setSize(600, 400);
            frame.setLocationRelativeTo(null); // 窗口居中显示

            JPanel jpanel = new JPanel();

            currentTime = new CurrentTime();
            String initialTime = currentTime.SystemDate();

            showLabel = new JLabel(initialTime);
            showLabel.setFont(new Font("宋体", Font.BOLD, 28)); // 字体调大，加粗

            jpanel.add(showLabel, BorderLayout.CENTER); // 将标签放置在面板中央
            frame.add(jpanel);
            frame.setVisible(true);

            // 创建并启动Swing Timer
            // 每200毫秒（0.2秒）触发一次动作
            Timer timer = new Timer(200, new ActionListener() {
                @Override
                public void actionPerformed(ActionEvent event) {
                    // 在此方法中更新UI组件，此方法总是在EDT上执行
                    String updatedTime = currentTime.SystemDate();
                    showLabel.setText(updatedTime); // 更新JLabel的文本
                }
            });
            timer.start(); // 启动计时器
        }
    }
}

代码解析

1. CurrentTime 类: 这个类保持不变，它的职责是获取当前的系统时间并按照指定格式返回字符串。它是一个纯粹的数据提供者，不涉及任何GUI操作。
2. MainGUI 类:
   • JLabel showLabel: 为了让ActionListener能够访问并更新显示时间的JLabel，我们将其声明为MainGUI类的成员变量。
   • GUI 初始化: 像往常一样设置JFrame、JPanel和JLabel。初始显示的时间通过currentTime.SystemDate()获取。
   • javax.swing.Timer 的使用:
     • new Timer(200, new ActionListener() { ... }): 创建一个Timer实例。
       • 第一个参数200表示延迟，即每200毫秒（0.2秒）触发一次actionPerformed方法。这个间隔足够显示秒级的更新，并且不会过于频繁地消耗CPU资源。
       • 第二个参数是一个匿名内部类实现的ActionListener。当Timer触发时，其actionPerformed方法会被调用。
     • 在actionPerformed方法内部：
       • String updatedTime = currentTime.SystemDate();: 再次获取最新的系统时间。
       • showLabel.setText(updatedTime);: 更新JLabel的文本。由于actionPerformed方法总是在EDT上执行，所以这个UI更新是完全安全的，不会导致GUI卡顿。
     • timer.start(): 启动计时器。一旦启动，它就会按照设定的延迟周期性地触发actionPerformed方法。
3. main 方法:
   • SwingUtilities.invokeLater(() -> { ... });: 这是一个最佳实践，用于确保所有Swing组件的创建和初始化都在EDT上进行。这可以避免潜在的线程问题。

总结与注意事项

• 避免阻塞EDT: 永远不要在事件调度线程（EDT）上执行长时间运行或阻塞性操作，如Thread.sleep()或复杂的计算。
• 使用javax.swing.Timer: 对于需要周期性更新GUI的场景，javax.swing.Timer是首选工具。它能够确保其actionPerformed方法在EDT上执行，从而安全地更新UI。
• java.util.Timer 与 javax.swing.Timer 的区别:
  • java.util.Timer 是一个通用计时器，可以在任何线程中调度任务。它的任务默认在后台线程中执行。如果需要更新Swing UI，则必须手动将更新操作包装在SwingUtilities.invokeLater()或SwingUtilities.invokeAndWait()中。
  • javax.swing.Timer 是专为Swing设计的，它的任务（actionPerformed方法）总是自动在EDT上执行，因此更适合直接更新Swing UI。
• 计时器延迟（Delay）的选择: 选择合适的延迟时间。对于秒级更新，200毫秒或500毫秒的延迟通常足够。过短的延迟可能会导致不必要的CPU消耗，而过长的延迟则会使更新不够流畅。
• 资源管理: 如果计时器不再需要，应该调用timer.stop()来停止它，释放资源。在我们的例子中，计时器通常会伴随窗口的生命周期。

通过以上方法，您可以在Java Swing应用程序中轻松实现响应流畅、实时更新的计时器或倒计时功能，为用户提供更好的体验。

以上就是Java Swing GUI中实现实时更新的计时器与倒计时功能的详细内容，更多请关注php中文网其它相关文章！