Интерфейс SecondaryLoop

public interface SecondaryLoop

Вспомогательный интерфейс для запуска вложенного цикла событий.

Объекты, реализующие этот интерфейс, создаются с помощью метода EventQueue.createSecondaryLoop(). Интерфейс предоставляет два метода, enter() и exit(), которые можно использовать для запуска и остановки цикла событий.

Когда вызывается метод enter(), текущая нить блокируется до тех пор, пока цикл не будет завершен методом exit(). Также на нити обработки событий запускается новый цикл событий, которая может или не может совпадать с текущей нитью. Цикл можно завершить в любой нити, вызвав его метод exit(). После завершения цикла объект SecondaryLoop можно повторно использовать для запуска нового вложенного цикла событий.

Типичный случай использования этого интерфейса — модальные диалоговые окна AWT и Swing. Когда модальное диалоговое окно отображается в нити обработки событий, оно входит в новый вторичный цикл. Позже, когда диалоговое окно скрывается или удаляется, оно выходит из цикла, и нить продолжает свою работу.

Следующий пример иллюстрирует простой случай использования вторичных циклов:

SecondaryLoop loop;

   JButton jButton = new JButton("Button");
   jButton.addActionListener(new ActionListener() {
       @Override
       public void actionPerformed(ActionEvent e) {
           Toolkit tk = Toolkit.getDefaultToolkit();
           EventQueue eq = tk.getSystemEventQueue();
           loop = eq.createSecondaryLoop();

           // Spawn a new thread to do the work
           Thread worker = new WorkerThread();
           worker.start();

           // Enter the loop to block the current event
           // handler, but leave UI responsive
           if (!loop.enter()) {
               // Report an error
           }
       }
   });

   class WorkerThread extends Thread {
       @Override
       public void run() {
           // Perform calculations
           doSomethingUseful();

           // Exit the loop
           loop.exit();
       }
   }

Подробное описание методов

enter

boolean enter()

Блокирует выполнение текущей нити и входит в новый вторичный цикл событий на нити обработки событий.

Этот метод может вызываться любой нитью, включая нить обработки событий. Эта нить будет заблокирована до тех пор, пока не будет вызван метод exit() или цикл не будет завершен. В любом случае, для обработки событий будет создан новый вторичный цикл на нити обработки событий.

Этот метод может запустить только один новый цикл событий за раз на один объект. Если вторичный цикл событий уже был запущен этим объектом и в настоящее время все еще работает, этот метод возвращает false чтобы указать, что он не смог запустить новый цикл событий. В противном случае этот метод блокирует вызывающую нить и позже возвращает true при завершении нового цикла событий. В этот момент этот объект снова может быть использован для запуска другого нового цикла событий.

Возвращает:

true после завершения вторичного цикла, если вторичный цикл был запущен этим вызовом, false в противном случае

exit

boolean exit()

Разблокирует выполнение нити, заблокированной методом enter(), и выходит из вторичного цикла.

Этот метод возобновляет выполнение нити, которая вызвала метод enter(), и выходит из вторичного цикла, созданного при вызове метода enter().

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

Если этот вторичный цикл не был запущен методом enter(), или этот вторичный цикл уже завершен методом exit(), этот метод возвращает false, в противном случае возвращается true.

Возвращает:

true если этот цикл был ранее запущен и еще не завершен методом exit(), false в противном случае