Пакет 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(Runnable), чтобы любые изменения в отрисовке пользовательского интерфейса были выполнены после обработки всех слушателей модели, установленных компонентом.

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

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

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

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

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