JFrame窗口关闭空白问题解决方法

来到golang学习网的大家，相信都是编程学习爱好者，希望在这里学习文章相关编程知识。下面本篇文章就来带大家聊聊《Java Swing JFrame空白关闭问题解决教程》，介绍一下，希望对大家的知识积累有所帮助，助力实战开发！

本教程旨在解决Java Swing应用中，通过按钮打开新JFrame时出现空白、无法关闭以及UI阻塞等常见问题。核心解决方案包括：使用`javax.swing.Timer`替代`while(true)`循环进行UI更新以避免阻塞事件调度线程（EDT），规范JFrame的实例化与生命周期管理，并确保所有UI操作都在EDT上执行。通过重构示例代码，演示了如何构建响应式且功能正常的Swing多窗口应用程序。

在Java Swing应用程序开发中，尤其是在涉及多窗口交互时，开发者常会遇到一些棘手的问题，例如点击按钮后新弹出的JFrame显示为空白、无法正常关闭，或者整个应用程序的用户界面（UI）变得无响应。这些问题通常源于对Swing的事件调度线程（Event Dispatch Thread, EDT）理解不足，以及对JFrame生命周期管理不当。本教程将深入分析这些问题的原因，并提供一套健壮的解决方案。

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

Swing是单线程UI框架，所有UI组件的创建、更新和事件处理都必须在EDT上进行。如果长时间运行的任务（如耗时的计算或无限循环）在EDT上执行，就会阻塞EDT，导致UI冻结、无响应，甚至出现空白窗口。

原始代码中的while(true)循环结合Thread.sleep(1000)来更新时间标签，这是一个典型的EDT阻塞案例。Thread.sleep()会暂停当前线程的执行，如果这个线程是EDT，那么整个UI都会停止响应。

规范JFrame的实例化与生命周期管理

在原始代码中，testTime_take_2类继承了JFrame，但在其构造函数内部又声明并实例化了一个static JFrame frame;。这种做法是错误的，因为它创建了一个多余的JFrame实例，并且可能导致对错误窗口的操作。一个类如果继承了JFrame，那么它本身就是一个JFrame，不需要在内部再创建一个。

此外，JFrame的关闭行为也需要正确配置。setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE)会强制在关闭当前JFrame时终止整个Java应用程序。在多窗口应用中，通常我们希望关闭一个窗口而不影响其他窗口或整个程序的运行，这时应该使用JFrame.DISPOSE_ON_CLOSE。

解决方案：使用Swing Timer与正确的JFrame管理

解决上述问题的关键在于以下几点：

1. 使用javax.swing.Timer进行周期性UI更新： Swing Timer专门设计用于在EDT上调度周期性任务，而不会阻塞EDT。它会在指定的延迟后触发一个ActionEvent，并且其监听器方法总是在EDT上执行。
2. 正确的JFrame实例化： 避免在继承JFrame的类中重复创建JFrame实例。
3. 灵活的JFrame关闭策略： 使用JFrame.DISPOSE_ON_CLOSE允许单独关闭窗口。
4. 利用WindowAdapter处理窗口关闭事件： 可以在窗口关闭时执行清理工作（如停止Swing Timer）或触发其他逻辑（如打开另一个窗口）。
5. 确保所有UI操作都在EDT上执行： 对于应用程序的启动或在非EDT线程中触发的UI更新，应使用java.awt.EventQueue.invokeLater()将任务提交到EDT。

重构后的代码示例

以下是根据上述原则重构后的DisplayTimeDate和TestTimeTake2类。

DisplayTimeDate.java (主时钟窗口)

import java.awt.Color;
import java.awt.FlowLayout;
import java.awt.Font;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import java.text.SimpleDateFormat;
import java.util.Calendar;
import javax.swing.JButton;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.swing.Timer; // 导入javax.swing.Timer

public class DisplayTimeDate extends JFrame {

    private static final long serialVersionUID = 425524L;

    private SimpleDateFormat timeFormat;
    private SimpleDateFormat dayFormat;
    private SimpleDateFormat dateFormat;
    private JLabel timeLabel;
    private JLabel dayLabel;
    private JLabel dateLabel;
    private JButton btnNewButton;

    private Timer clockTimer; // 使用javax.swing.Timer

    public DisplayTimeDate() {
        initializeForm();
    }

    private void initializeForm() {
        // 监听窗口关闭事件，停止Timer
        addWindowListener(new WindowAdapter() {
            @Override
            public void windowClosing(WindowEvent e) {
                if (clockTimer != null && clockTimer.isRunning()) {
                    clockTimer.stop();
                }
            }
        });
        setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE); // 关闭当前窗口而不退出程序
        setTitle("我的时钟程序");
        setAlwaysOnTop(true); // 窗口总在最上层
        setSize(350, 200);
        setResizable(false);

        timeFormat = new SimpleDateFormat("hh:mm:ss a");
        dayFormat = new SimpleDateFormat("EEEE");
        dateFormat = new SimpleDateFormat("MMMMM dd, yyyy");

        timeLabel = new JLabel();
        timeLabel.setFont(new Font("Verdana", Font.PLAIN, 50));
        timeLabel.setForeground(new Color(0x00FF00));
        timeLabel.setBackground(Color.black);
        timeLabel.setOpaque(true);

        dayLabel = new JLabel();
        dayLabel.setFont(new Font("Ink Free", Font.PLAIN, 35));

        dateLabel = new JLabel();
        dateLabel.setFont(new Font("Ink Free", Font.PLAIN, 25));
        getContentPane().setLayout(new FlowLayout(FlowLayout.CENTER, 5, 5));

        btnNewButton = new JButton("打开第二个窗口"); // 按钮文本更明确
        btnNewButton.addActionListener(new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                dispose(); // 关闭当前窗口
                // 在EDT上创建并显示新窗口
                java.awt.EventQueue.invokeLater(() -> {
                    new TestTimeTake2().setVisible(true);
                });
            }
        });
        getContentPane().add(btnNewButton);

        getContentPane().add(timeLabel);
        getContentPane().add(dayLabel);
        getContentPane().add(dateLabel);

        setLocationRelativeTo(null); // 窗口居中
        startClockTimer(); // 启动计时器
    }

    public void startClockTimer() {
        // 创建一个Swing Timer，每1000毫秒触发一次
        clockTimer = new Timer(1000, new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent ae) {
                // 在EDT上更新UI组件
                timeLabel.setText(timeFormat.format(Calendar.getInstance().getTime()));
                dayLabel.setText(dayFormat.format(Calendar.getInstance().getTime()));
                dateLabel.setText(dateFormat.format(Calendar.getInstance().getTime()));
            }
        });
        clockTimer.start(); // 启动Timer
    }

    public static void main(String[] args) {
        // 确保在EDT上创建和显示UI
        java.awt.EventQueue.invokeLater(() -> {
            new DisplayTimeDate().setVisible(true);
       });
    }
}

TestTimeTake2.java (第二个时钟窗口)

import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import java.text.SimpleDateFormat;
import java.util.Calendar;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.swing.JPanel;
import javax.swing.SwingConstants;
import javax.swing.Timer; // 导入javax.swing.Timer
import javax.swing.border.EmptyBorder;

public class TestTimeTake2 extends JFrame {

    private static final long serialVersionUID = 342241L;

    private JPanel contentPane;
    private SimpleDateFormat timeFormat;
    private SimpleDateFormat dayFormat;
    private SimpleDateFormat dateFormat;
    private JLabel timeLabel;
    private JLabel dayLabel;
    private JLabel dateLabel;

    private Timer clockTimer2; // 使用javax.swing.Timer


    public TestTimeTake2() {
        initializeForm();
    }

    private void initializeForm() {
        // 监听窗口关闭事件，停止Timer并重新打开主窗口
        addWindowListener(new WindowAdapter() {
            @Override
            public void windowClosing(WindowEvent e) {
                if (clockTimer2 != null && clockTimer2.isRunning()) {
                    clockTimer2.stop();
                }
                // 在EDT上重新打开主窗口
                java.awt.EventQueue.invokeLater(() -> {
                    new DisplayTimeDate().setVisible(true);
                });
            }
        });
        setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE);
        setBounds(100, 100, 450, 300);
        contentPane = new JPanel();
        contentPane.setBorder(new EmptyBorder(5, 5, 5, 5));

        setContentPane(contentPane);

        timeFormat = new SimpleDateFormat("hh:mm:ss a");
        dayFormat = new SimpleDateFormat("EEEE");
        dateFormat = new SimpleDateFormat("dd-MMMMM-yyyy");
        contentPane.setLayout(null); // 使用绝对布局

        timeLabel = new JLabel();
        timeLabel.setHorizontalAlignment(SwingConstants.CENTER);
        timeLabel.setBounds(151, 45, 112, 14);

        dayLabel = new JLabel();
        dayLabel.setHorizontalAlignment(SwingConstants.CENTER);
        dayLabel.setBounds(151, 100, 112, 14);

        dateLabel = new JLabel();
        dateLabel.setHorizontalAlignment(SwingConstants.CENTER);
        dateLabel.setBounds(151, 151, 112, 14);

        // 将标签添加到内容面板
        contentPane.add(timeLabel);
        contentPane.add(dayLabel);
        contentPane.add(dateLabel);

        setLocationRelativeTo(null); // 窗口居中
        startClockTimer(); // 启动计时器
    }

    public void startClockTimer() {
        // 创建一个Swing Timer，每1000毫秒触发一次
        clockTimer2 = new Timer(1000, new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent ae) {
                // 在EDT上更新UI组件
                timeLabel.setText(timeFormat.format(Calendar.getInstance().getTime()));
                dayLabel.setText(dayFormat.format(Calendar.getInstance().getTime()));
                dateLabel.setText(dateFormat.format(Calendar.getInstance().getTime()));
            }
        });
        clockTimer2.start(); // 启动Timer
    }
}

关键注意事项与最佳实践

• 避免阻塞EDT： 这是Swing编程中最重要的原则。任何可能耗时的操作都应该在单独的线程中执行，并通过SwingUtilities.invokeLater()或SwingWorker将结果更新到UI。
• 使用javax.swing.Timer： 对于周期性UI更新，始终优先使用javax.swing.Timer，而不是java.util.Timer或手动创建Thread并使用Thread.sleep()。
• 正确的窗口关闭操作： 根据应用程序需求选择合适的setDefaultCloseOperation。对于多窗口应用，JFrame.DISPOSE_ON_CLOSE是更常见的选择。
• 资源清理： 在窗口关闭时，确保停止所有正在运行的Swing Timer或其他线程，以避免资源泄露或程序行为异常。WindowAdapter是一个很好的地方来处理这些清理工作。
• 统一UI操作： 始终通过java.awt.EventQueue.invokeLater()来创建和更新UI组件，确保它们都在EDT上执行。
• 命名规范： 遵循Java的命名约定，例如类名使用驼峰命名法（TestTimeTake2而不是testTime_take_2）。
• 布局管理器： 尽量使用Swing提供的布局管理器（如FlowLayout, BorderLayout, GridLayout, GridBagLayout等），而不是绝对布局（setLayout(null)），因为布局管理器可以更好地适应不同屏幕尺寸和字体设置，使界面更具弹性。

通过遵循这些原则和实践，您可以构建出响应迅速、功能稳定且用户体验良好的Java Swing应用程序。

终于介绍完啦！小伙伴们，这篇关于《JFrame窗口关闭空白问题解决方法》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！