Foxtrot - Easy API for JFC/Swing - Documentation
Last Updated: $Date: 2005-03-22 05:00:37Z $

The GUI freeze problem

When you write Swing applications, you show a GUI to a user; the user clicks on some components (buttons, menus, etc.) to perform the desired action.
The code that executes the action is written in event listeners methods, and event listeners are always executed in the Event Dispatch Thread.
The Event Dispatch Thread is responsible for taking one event after another and processing it; the processing involves calling the event listeners's method, which are then executed. If an event listener requires a long time to be executed, then the Event Dispatch Thread cannot process the next event, which will then be waiting in the Event Queue.
If the pending event is a repaint event, the GUI cannot be repainted, so it appears to be frozen.
So resizing your window, overlapping it with another window, clicking on other components, all these events are queued but not processed until the time-consuming listener has finished.
The user feels the application has hung.
When the time-consuming listener finishes, all pending events are processed, and if they are quick to execute (like repainting events) it appears they're are executed like a storm.

Take a look at the following code.

Let's concentrate on the button's listener (the actionPerformed() method): the first statement changes the text of the button. This causes the JButton to post a repaint event to the Event Queue, which is not be executed until the method finishes.
But the listener is waiting for 10 seconds, so what happens is that the button remains pressed, and its text doesn't change. After 10 seconds have passed, another button-text-change method is called, thus posting another repaint event to the Event Queue, but still, this listener has not finished so the two events posted by the button-text-change methods are not dequeued and processed.
When the listener finishes, on the way back, Swing can take care of repainting the button according to the two events previously posted, and the other pending events in the Event Queue finally get a chance to be executed, too.
Being repaint events, the two button events are executed quickly. So first the button text is changed to "Sleeping...", and immediately after to "Slept !", too quick for the eye to see.
Before that, during 10 seconds, the GUI was frozen.


public class FreezeExample extends JFrame
{
   public static void main(String[] args)
   {
      FreezeExample example = new FreezeExample();
      example.setVisible(true);
   }

   public FreezeExample()
   {
      super("Freeze Example");

      final JButton button = new JButton("Take a nap !");
      button.addActionListener(new ActionListener()
      {
         public void actionPerformed(ActionEvent e)
         {
            button.setText("Sleeping...");
            try {Thread.sleep(10000);}
            catch (Exception ignored) {}
            button.setText("Slept !");
         }
      });

      setDefaultCloseOperation(EXIT_ON_CLOSE);

      Container c = getContentPane();
      c.setLayout(new GridBagLayout());
      c.add(button);

      setSize(300,200);

      Dimension screen = Toolkit.getDefaultToolkit().getScreenSize();
      Dimension size = getSize();
      int x = (screen.width - size.width) >> 1;
      int y = (screen.height - size.height) >> 1;
      setLocation(x, y);
   }
}
Legend
Main Thread
Event Dispatch Thread