首页 > Java > java教程 > 正文

使用Swing Timer实现Java GUI中的实时倒计时显示

霞舞
发布: 2025-11-10 18:40:01
原创
130人浏览过

使用swing timer实现java gui中的实时倒计时显示

本文详细介绍了在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应用程序的计时器类。它具有以下关键特性:

ViiTor实时翻译
ViiTor实时翻译

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

ViiTor实时翻译 116
查看详情 ViiTor实时翻译
  1. 非阻塞性:Timer在内部使用一个单独的线程来计时,但它会在每次计时结束后,将一个ActionEvent事件发送到EDT上。
  2. EDT兼容性:Timer确保其ActionListener中的actionPerformed方法总是在EDT上执行,这意味着您可以在这个方法中安全地更新Swing组件,而无需担心线程安全问题。
  3. 简单易用: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);
        }
    }
}
登录后复制

代码解析与注意事项

  1. SwingUtilities.invokeLater(): 在main方法中,我们使用SwingUtilities.invokeLater()来确保所有GUI相关的初始化代码都在EDT上执行。这是Swing编程的最佳实践,可以避免潜在的线程问题。
  2. JLabel作为成员变量: showLabel被定义为MainGUI类的成员变量,这样在Timer的ActionListener中就可以访问并更新它的文本。
  3. Timer实例化:
    • new Timer(1000, new ActionListener() { ... }):创建一个新的Timer实例。第一个参数1000表示延迟时间,单位是毫秒,即每1秒触发一次actionPerformed方法。
    • ActionListener:这是一个匿名内部类,实现了ActionListener接口。当Timer触发时,其actionPerformed方法会被调用。
  4. actionPerformed()方法: 这是核心逻辑所在。每次Timer触发时,它会重新获取当前系统时间,并使用showLabel.setText()方法更新JLabel的显示内容。由于Swing Timer保证actionPerformed在EDT上执行,因此这里的GUI更新是完全线程安全的。
  5. timer.start(): 调用此方法启动计时器。计时器会按照设定的延迟时间周期性地触发事件。
  6. setLocationRelativeTo(null): 这是一个方便的方法,用于将窗口居中显示在屏幕上。
  7. 字体大小调整: showLabel.setFont(new Font("宋体", Font.BOLD, 28))将字体设置为宋体、粗体、28号,使得时间显示更清晰。

总结

通过使用javax.swing.Timer,我们能够优雅且高效地在Java Swing GUI中实现实时更新的计时器功能。Swing Timer的优势在于它能够将周期性任务的执行安排在EDT上,从而避免了线程阻塞和GUI无响应的问题,确保了应用程序的流畅性和响应性。在开发任何需要在Swing界面上周期性更新内容的应用程序时,javax.swing.Timer都是一个值得优先考虑的解决方案。

以上就是使用Swing Timer实现Java GUI中的实时倒计时显示的详细内容,更多请关注php中文网其它相关文章!

Windows激活工具
Windows激活工具

Windows激活工具是正版认证的激活工具,永久激活,一键解决windows许可证即将过期。可激活win7系统、win8.1系统、win10系统、win11系统。下载后先看完视频激活教程,再进行操作,100%激活成功。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号