SwingTimer实现流畅动画与并发控制

文章小白一枚，正在不断学习积累知识，现将学习到的知识记录一下，也是将我的所得分享给大家！而今天这篇文章《Swing Timer实现流畅动画与并发操作》带大家来了解一下##content_title##，希望对大家的知识积累有所帮助，从而弥补自己的不足，助力实战开发！

1. Swing并发模型概述与挑战

Java Swing是一个单线程的GUI工具包，这意味着所有与用户界面组件相关的操作（包括创建、更新和绘制）都必须在特定的线程上执行，这个线程被称为事件调度线程（Event Dispatch Thread, EDT）。

直接在EDT上执行耗时操作（如文件I/O、网络请求或复杂的计算）会导致UI冻结，因为它会阻塞EDT，使其无法响应用户输入或处理重绘事件。反之，如果尝试在EDT之外的线程直接修改UI组件的状态或调用其方法，则可能导致不可预测的行为、视觉错误甚至死锁，因为Swing组件并非线程安全的。

因此，在Swing中实现动画或任何需要后台处理的功能时，必须遵循以下两个核心原则：

1. UI更新必须在EDT上进行。
2. 长时间运行或阻塞操作不应在EDT上进行。

2. 为什么不直接使用Thread进行UI动画？

在初学者尝试实现动画时，一个常见的误区是让动画对象（例如本例中的Circle）继承Thread并直接在run方法中更新自身位置，然后期待UI能自动重绘。原始代码中的Circle类继承了Thread，并在其run方法中通过move()更新坐标，然后调用Thread.sleep(100)。这种做法存在以下几个问题：

• UI重绘机制缺失： Circle线程虽然更新了自身坐标，但并没有通知Swing系统需要重绘UI。Swing的paint或paintComponent方法是由EDT调用的，它只会在系统认为需要重绘时才发生（例如窗口被遮挡后重新显示，或者显式调用repaint()）。
• 线程安全问题： 即使Circle线程能够触发repaint()，如果repaint()在Circle更新坐标的同时被调用，就可能存在竞态条件，导致绘制出不一致或损坏的UI。
• 资源管理： 频繁创建和管理自定义线程会增加系统开销，并且容易出现线程生命周期管理不当的问题。

正确的做法是将动画逻辑（即模型状态的更新）与UI绘制逻辑（即视图的呈现）分离。动画模型的状态可以在EDT之外的线程更新（如果耗时），但触发UI重绘和实际的UI绘制必须发生在EDT上。对于周期性、轻量级的动画，javax.swing.Timer是最佳选择。

3. 使用javax.swing.Timer实现流畅动画

javax.swing.Timer是Swing提供的一个轻量级定时器，它专门设计用于在EDT上触发事件。这意味着通过Timer执行的代码将自动在EDT上运行，从而避免了线程安全问题。

以下是如何使用Swing Timer实现圆形动画的详细步骤和代码示例：

3.1 应用程序主入口 (Main类)

首先，确保Swing应用程序的启动代码在EDT上执行。这通过EventQueue.invokeLater()实现。

import java.awt.EventQueue;
import javax.swing.JFrame;

public class Main {
    public static void main(String[] args) {
        // 确保所有UI相关的初始化都在EDT上进行
        EventQueue.invokeLater(new Runnable() {
            @Override
            public void run() {
                JFrame frame = new JFrame("Swing Timer 动画示例");
                frame.add(new TestPane()); // 添加自定义的JPanel
                frame.pack(); // 根据组件的首选大小调整窗口大小
                frame.setLocationRelativeTo(null); // 窗口居中
                frame.setVisible(true); // 显示窗口
                frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); // 设置关闭操作
            }
        });
    }
}

3.2 绘制面板 (TestPane类)

TestPane是一个JPanel的子类，它负责管理动画对象（Circle实例）的集合，并通过Swing Timer驱动动画逻辑和UI重绘。

import java.awt.Color;
import java.awt.Dimension;
import java.awt.Graphics;
import java.awt.Graphics2D;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.util.ArrayList;
import java.util.List;
import javax.swing.JPanel;
import javax.swing.Timer; // 注意是javax.swing.Timer

public class TestPane extends JPanel {

    private List circles = new ArrayList<>();        
    private Timer timer; // Swing Timer实例

    public TestPane() {
        // 初始化圆形对象
        circles.add(new Circle(100, 100, 2, 2, new int[]{50, 50, 250, 250}, Color.blue)); // 修正边界
        circles.add(new Circle(150, 150, -2, 0, new int[]{50, 50, 250, 250}, Color.red));
        circles.add(new Circle(50, 150, 2, -2, new int[]{50, 50, 250, 250}, Color.green));
    }

    @Override
    public Dimension getPreferredSize() {
        // 定义面板的首选大小
        return new Dimension(300, 300);
    }

    /**
     * 当组件被添加到可显示层次结构时调用。
     * 在这里启动Timer，确保组件可见时动画开始。
     */
    @Override
    public void addNotify() {
        super.addNotify();
        if (timer != null) {
            timer.stop(); // 停止旧的Timer以防万一
        }
        // 创建并启动Timer
        // 5毫秒间隔，ActionListener将在EDT上执行
        timer = new Timer(5, new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                // 遍历所有圆形，更新它们的状态
                for (Circle circle : circles) {
                    circle.tick();
                }
                repaint(); // 请求重绘面板，这也会在EDT上执行
            }
        });
        timer.start(); // 启动Timer
    }

    /**
     * 当组件从可显示层次结构中移除时调用。
     * 在这里停止Timer，释放资源。
     */
    @Override
    public void removeNotify() {
        super.removeNotify();
        if (timer != null) {
            timer.stop(); // 停止Timer
        }
        timer = null; // 清除引用
    }

    /**
     * 自定义绘制方法。
     * 推荐在JComponent子类中使用paintComponent而不是paint。
     */
    @Override
    protected void paintComponent(Graphics g) {
        super.paintComponent(g); // 必须调用父类的paintComponent方法
        Graphics2D g2d = (Graphics2D) g.create(); // 创建Graphics副本，安全操作
        try {
            for (Circle circle : circles) {
                g2d.setColor(circle.getColor());
                g2d.fillOval(circle.getX(), circle.getY(), 10, 10); // 绘制圆形
            }
        } finally {
            g2d.dispose(); // 释放Graphics资源
        }
    }
}

3.3 动画模型 (Circle类)

Circle类现在是一个纯粹的模型类，它不再继承Thread。它只负责维护自身的状态（位置、速度、颜色、边界）以及更新这些状态的逻辑。

import java.awt.Color;

public class Circle {
    private int x, y;
    private int xs, ys; // x和y方向的速度

    private Color color;
    private int[] boundries; // 边界：[minX, minY, maxX, maxY]

    public Circle(int x, int y, int xs, int ys, int[] boundries, Color color) {
        this.x = x;
        this.y = y;
        this.xs = xs;
        this.ys = ys;
        this.boundries = boundries;
        this.color = color;
    }

    /**
     * 更新圆形状态的“一帧”。
     * 由Swing Timer的ActionListener调用。
     */
    public void tick() {
        move();
    }

    /**
     * 更新圆形位置。
     */
    protected void move() {
        updateSpeed(); // 先检查并更新速度方向
        this.x += this.xs;
        this.y += this.ys;
    }

    /**
     * 检查边界碰撞并反转速度方向。
     * 修正了原始代码中的边界判断逻辑。
     */
    protected void updateSpeed() {
        // X轴边界检查
        if (x <= boundries[0]) { // 触及左边界
            xs *= -1;
            x = boundries[0]; // 将位置校正到边界上
        } else if (x >= boundries[2]) { // 触及右边界
            xs *= -1;
            x = boundries[2]; // 将位置校正到边界上
        }

        // Y轴边界检查
        if (y <= boundries[1]) { // 触及上边界
            ys *= -1;
            y = boundries[1]; // 将位置校正到边界上
        } else if (y >= boundries[3]) { // 触及下边界
            ys *= -1;
            y = boundries[3]; // 将位置校正到边界上
        }
    }

    // Getter方法
    public int getX() {
        return x;
    }

    public Color getColor() {
        return color;
    }

    public int getY() {
        return y;
    }
}

4. 关键概念与最佳实践

• EDT（Event Dispatch Thread）： 始终记住所有UI操作都必须在EDT上执行。EventQueue.invokeLater()用于将任务提交到EDT队列。
• javax.swing.Timer： 它是实现Swing动画和周期性任务的首选工具。它的ActionListener回调总是在EDT上执行。不要与java.util.Timer混淆，后者在单独的线程上运行，不适合直接操作UI。
• paintComponent vs paint： 在自定义绘制时，应重写JComponent的paintComponent(Graphics g)方法，而不是paint(Graphics g)。paintComponent是双缓冲友好的，并且负责绘制组件的背景、边框和内容。
• super.paintComponent(g)： 在自定义paintComponent方法中，始终首先调用super.paintComponent(g)，以确保组件的背景被正确清除，避免绘制残影。
• Graphics上下文管理： 当你从paintComponent接收到Graphics对象时，最好创建一个副本（Graphics2D g2d = (Graphics2D) g.create();），并在完成绘制后调用g2d.dispose()来释放资源。这有助于防止意外修改原始Graphics对象的状态，并确保系统资源得到有效管理。
• 组件生命周期方法 (addNotify, removeNotify)： 这些方法在组件被添加到或从其父容器中移除时调用，是管理资源（如Timer）生命周期的好地方。在addNotify中启动Timer，在removeNotify中停止Timer，可以确保动画只在组件可见且需要时运行。
• 边界碰撞逻辑： 原始代码中的边界判断 if(xboundries[2]) 逻辑上是错误的，因为一个值不能同时小于最小值又大于最大值。正确的逻辑应该是检查是否触及或越过任一边界，然后反转速度并校正位置。

5. 总结

在Java Swing中实现动画和并发操作，核心在于理解并遵循Swing的单线程模型。通过利用EventQueue.invokeLater()确保UI初始化在EDT上，并使用javax.swing.Timer安全地驱动动画逻辑和UI重绘，我们可以避免常见的线程问题，构建出响应迅速、视觉流畅的Swing应用程序。将动画模型（如Circle）与UI绘制逻辑（如TestPane的paintComponent）清晰分离，是构建可维护和可扩展Swing应用的关键。

本篇关于《SwingTimer实现流畅动画与并发控制》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！