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

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

Дополнительные сведения по этой теме можно найти в учебном руководстве по Swing, в частности в разделе Параллельное выполнение в Swing.

Политика Swing в отношении сериализации

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

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

Обзоры, учебные материалы, примеры, руководства и другую документацию см. здесь:

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