Пакет javax.swing

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

Политика потоков 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

Предупреждение: Сериализованные объекты любого класса Swing не будут совместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4, поддержка долгосрочного хранения всех JavaBeans была добавлена в пакет java.beans.

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

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

• Обзор архитектуры Swing
• Учебник Java
• Обучение и сертификация Java SE