Пакет javax.swing

Предоставляет набор "лёгких" (все на языке Java) компонентов, которые, насколько это возможно, работают одинаково на всех платформах. Для руководства программиста по использованию этих компонентов см. Создание графического интерфейса с JFC/Swing, траекторию в Учебнике Java. Для других ресурсов см. Связанная документация.

Политика потоков Swing

В общем случае Swing не является потокобезопасным. Ко всем компонентам Swing и связанным классам, если не указано иное в документации, необходимо обращаться в потоке обработки событий.

Типичные приложения Swing выполняют обработку в ответ на событие, сгенерированное пользователем. Например, щелчок по JButton уведомляет все ActionListeners , добавленные в JButton. Поскольку все события, сгенерированные пользователем, обрабатываются в потоке обработки событий, большинство разработчиков не затронуты этим ограничением.

Однако, влияние наблюдается при создании и отображении приложения Swing. Вызовы метода приложения main или методов в Applet не вызываются в потоке обработки событий. Поэтому необходимо позаботиться о передаче управления в поток обработки событий при создании и отображении приложения или апплета. Предпочтительный способ передачи управления и начала работы с Swing – использование invokeLater. Метод invokeLater планирует Runnable для обработки в потоке обработки событий. Следующие два примера одинаково хорошо подходят для передачи управления и запуска приложения Swing:

import javax.swing.SwingUtilities;

 public class MyApp implements Runnable {
     public void run() {
         // Invoked on the event dispatching thread.
         // Construct and show GUI.
     }

     public static void main(String[] args) {
         SwingUtilities.invokeLater(new MyApp());
     }
 }

Или:

import javax.swing.SwingUtilities;

 public class MyApp {
     MyApp(String[] args) {
         // Invoked on the event dispatching thread.
         // Do any initialization here.
     }

     public void show() {
         // Show the UI.
     }

     public static void main(final String[] args) {
         // Schedule a job for the event-dispatching thread:
         // creating and showing this application's GUI.
         SwingUtilities.invokeLater(new Runnable() {
             public void run() {
                 new MyApp(args).show();
             }
         });
     }
 }

Это ограничение также относится к моделям, прикреплённым к компонентам Swing. Например, если TableModel прикреплён к JTable, TableModel должен изменяться только в потоке обработки событий. Если вы изменяете модель в отдельном потоке, существует риск возникновения исключений и возможной порчи отображения.

Хотя обычно безопасно выполнять обновления интерфейса пользователя сразу же при выполнении в потоке обработки событий, есть исключение: если слушатель модели пытается дополнительно изменить интерфейс пользователя до того, как интерфейс пользователя был обновлён для отражения ожидаемого изменения, то интерфейс пользователя может быть отображён неправильно. Это может произойти, если установленный слушателем приложения требует обновления интерфейса пользователя в ответ на событие, которое вызовет изменение структуры модели. Важно сначала разрешить установленным слушателям компонента обработать это изменение, так как нет гарантии порядка вызовов слушателей. Решением является для слушателя приложения выполнить изменение с помощью SwingUtilities.invokeLater, чтобы любые изменения в отображении интерфейса пользователя были выполнены после обработки всех слушателей модели, установленных компонентом.

Поскольку все события доставляются в поток обработки событий, необходимо проявлять осторожность при обработке событий. В частности, длительная задача, такая как сетевое ввод-вывод или вычисления, выполняемая в потоке обработки событий, блокирует этот поток от отправки любых других событий. Пока поток обработки событий заблокирован, приложение полностью не реагирует на пользовательский ввод. См. SwingWorker для предпочтительного способа выполнения таких операций при работе с Swing.

Дополнительную информацию по этой теме можно найти в учебнике по Swing, в частности, в разделе Асинхронность в Swing.

Связанная документация

Для обзоров, учебных пособий, примеров, руководств и другой документации см.:

• Подключение Swing
• Учебник Java
• Онлайн-обучение на Java Developer Connection ^SM
• Главная страница Java Foundation Classes (JFC)