Пакет 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

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

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

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

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