10.27AWT, Swing und die Threads
Swing nutzt für Zeichenoperationen und das Abarbeiten von Ereignis-Programmcode einen eigenen Thread. Die folgenden Abschnitte erklären, warum Swing einen eigenen Thread nutzt und welche Konsequenzen das für den Entwickler hat.
10.27.1Ereignisschlange (EventQueue) und AWT-Event-Thread
Der Benutzer erzeugt bei seiner Arbeit mit der Oberfläche Ereignisse. Diese werden entweder von den Peer-Objekten oder von Klassen der Applikation erzeugt. Bevor sie vom eigenen Programm bearbeitet werden, gelangen sie in eine Ereignisschlange (engl. event queue). Jedem Fenster ist eine eigene Event-Queue zugeordnet. Diese Event-Queue ist für Programmierer zugänglich und in einer plattformunabhängigen Klasse EventQueue implementiert. Elemente der Klasse sind Objekte vom Typ AWTEvent. Ein eigener Thread, der AWT-Event-Thread, läuft parallel zur Anwendung und arbeitet die angesammelten Ereignisse dieser Warteschlange ab.
Der AWT-Thread führt auch den Programmcode in den Listenern aus. Aus diesem Grund ist es ungünstig, in einen Event-Handler lang dauernden Programmcode zu legen, denn dann »steht« die grafische Applikation und lässt sich nicht fortsetzen, weil der AWT-Thread blockiert ist. Bei einer längeren Aktion in einem Event-Handler sollten wir einen separaten Thread starten, damit die grafische Oberfläche sofort wieder reaktionsfähig ist.
[zB]Beispiel
Wenn eine Schaltfläche angeklickt wird, soll ein langer Text in den Puffer eingelesen werden:
@Override public void actionPerformed( ActionEvent e ) {
new Thread( new ReaderThread(e.getActionCommand()) ).start();
}
};
In einer externen Klasse lesen wir zum Beispiel einen Text:
ReaderThread( String actionCommand ) {
// ...
}
public void run() {
// ...
}
}
Eine Alternative ist der SwingWorker, den wir später in Abschnitt 10.27.4, »SwingWorker«,
vorstellen.
Unter dem AWT ist es kein Problem, wenn zwei Threads auf ein und dasselbe Oberflächenelement zugreifen. Bei Swing ist dies jedoch etwas anders, wie wir im nächsten Abschnitt sehen werden.
10.27.2Swing ist nicht threadsicher
Die Tatsache, dass das Swing-Toolkit nicht threadsicher ist, erstaunt vielleicht auf den ersten Blick. Das AWT ist threadsicher, da AWT auf Plattform-Peer-Elemente vertraut. In einer List-Box unter dem AWT ist es problemlos möglich, ein Element einzufügen und parallel zu löschen. Doch auf die Synchronisation bei Swing wurde aus zwei Gründen verzichtet:
Operationen können in Threads zu ärgerlichen Deadlock-Situationen führen.
Der Verzicht auf Synchronisation kann die Ausführungsgeschwindigkeit erhöhen.
[»]Hinweis
Gibt es konkurrierende Zugriffe auf Swing-Komponenten, kann es zu Exceptions der Art »Exception in thread "AWT-EventQueue-0"« kommen.
Swing weiß mit konkurrierenden Zugriffen nicht allzu viel anzufangen
In einem kleinen Beispiel wollen wir genau einen Fehler provozieren, in dem zwei Threads gleichzeitig eine Datenstruktur modifizieren und somit Swing aus dem Takt werfen. Es ist ein mahnendes Beispiel, Operationen an GUI-Komponenten nur über den AWT-Event-Thread vorzunehmen:
Listing 10.90com/tutego/insel/ui/swing/SwingNoSyncDemo.java, main()
JFrame frame = new JFrame();
frame.add( new JList<>( model ) );
frame.setSize( 200, 100 );
frame.setVisible( true );
new Thread() {
@Override public void run() {
setPriority( Thread.MIN_PRIORITY );
while ( true )
model.addElement( "Dumm gelaufen" );
}
}.start();
new Thread() {
@Override public void run() {
setPriority( Thread.MIN_PRIORITY );
while ( true )
model.removeElement( "Dumm gelaufen" );
}
}.start();
Werfen wir einen Blick auf die Ausgabe, die erscheint, wenn das Programm nur kurz läuft:
at javax.swing.plaf.basic.BasicListUI.updateLayoutState(BasicListUI.java:1368)
...
at java.awt.EventDispatchThread.run(EventDispatchThread.java:90)
Exception in thread "AWT-EventQueue-0" java.lang.ArrayIndexOutOfBoundsException
Exception in thread "AWT-EventQueue-0" java.lang.ArrayIndexOutOfBoundsException
Obwohl das DefaultListModel als unterliegende Datenstruktur den Vector nimmt und dieser nur synchronisierte Methoden besitzt, die beim nebenläufigen Zugriff den Vector nicht irritieren, ist er nicht der Übeltäter. Es liegt an Swing, wie mit den Daten umgegangen wird. Wenn der erste Thread Daten in das Model einfügt, muss die Visualisierung aktualisiert werden. Wir wissen von DefaultListModel, dass es über ListDataEvent das Darstellungsobjekt informiert, wenn es den Inhalt neu zeichnen muss. Merken wir uns die Stelle. Das Darstellungsobjekt wird sich nun vom Model die Daten besorgen. Bis dahin läuft alles ganz gut. Doch der zweite Thread löscht parallel die Daten aus dem Model. Springen wir jetzt zur Markierung zurück. Irgendwann passiert es, dass zwischen der Benachrichtigung der Darstellungskomponente und dem wirklichen Zeichnen sowie der Anfrage an das Model etwas gelöscht wird. Die Visualisierung weiß davon aber nichts und versucht, alle Werte zu zeichnen; es fehlt jedoch mindestens ein Wert. Daher folgt eine ArrayIndexOutOfBoundsException in der Methode elementAt(…) vom Vector. Die Visualisierung fragt mit einem Index im Vector nach, doch der Vector hat vom Lösch-Thread schon ein Element abgeben müssen. Daher ist die interne Größe des Vektors kleiner als der von Swing erfragte Index.
Erlaubte Methoden
Einige der Methoden sind threadsicher und dürfen von beliebigen anderen Threads aufgerufen werden:
der Aufruf zum Neuzeichnen mit repaint() oder revalidate() für die Größenänderung einer Komponente im Container
alle Aufrufe auf neuen Komponenten, die noch nicht etwa mit setVisible(boolean) (früher show()) bzw. pack() veröffentlicht wurden
Die Eintragung von Listenern, etwa bei JComponent mit den Methoden addPropertyChangeListener(…), removePropertyChangeListener(…) und addVetoableChangeListener(…), removeVetoableChangeListener(…) ist sicher.
Bei JCheckBoxMenuItem ist es dann die einsame Methode setState(boolean), die synchronisiert ist. Es findet sich intern mal hier, mal da ein synchronisierter Block.
Ansonsten ist jedoch nicht viel dabei, und wir müssen unsere Teile synchronisiert ausführen. Um Programmstücke konform ausführen zu lassen, definiert Swing einige Methoden und Klassen. Dazu gehören:
invokeLater(Runnable)
invokeAndWait(Runnable)
JProgressBar
ProgressMonitor
ProgressMonitorInputStream
SwingWorker
10.27.3invokeLater(…) und invokeAndWait(…)
Da Swing nicht threadsicher ist, bietet der AWT-Thread die einzige Möglichkeit zur Manipulation von Oberflächenelementen. Wenn wir es schaffen, dort die Aufträge einzureihen, dann wird nichts schiefgehen. Genau für diese Aufgabe gibt es in der Klasse EventQueue zwei statische Methoden: invokeLater(Runnable) und invokeAndWait(Runnable). Damit lassen sich beliebige Programmstücke in die Warteschlange einführen. In der Warteschlange für das AWT liegen Aufträge und Ereignisse, die an die Oberflächenelemente verteilt werden. Alles spielt sich dabei neben dem Haupt-Thread ab, sodass Parallelität herrscht. Hat die Warteschlange alle Ereignisbehandler aufgerufen, kann der Programmcode von invokeLater(…) und invokeAndWait(…) durchlaufen werden.
Die beiden Methoden erfüllen unterschiedliche Bedürfnisse:
invokeLater(…) legt einen Runnable in die Warteschlange und kehrt sofort zurück. Die Funktion ist somit asynchron. Der Aufrufer weiß nicht, wann der Programmcode abgearbeitet wird.
invokeAndWait(…) legt ebenfalls einen Runnable in die Warteschlange, verharrt aber so lange in der Funktion, bis der Programmcode in run() aufgerufen wurde. Die Funktion ist also synchron.
Mit diesen statischen Methoden lassen sich jetzt alle Manipulationen an der Oberfläche durchführen. Den statischen Methoden wird ein Runnable-Objekt übergeben, das den Programmcode repräsentiert, der im AWT-Event-Thread auszuführen ist.
[zB]Beispiel
Ein Fortschrittsbalken JProgressBar mit dem Namen bar soll aus einem Nicht-AWT-Event-Thread einen Wert gesetzt bekommen:
@Override public void run() {
bar.setValue( i );
}
} );
Bei der Auswahl der beiden Methoden haben wir uns für den Fortschrittsbalken für invokeLater(…) entschieden. Es ist in der Regel wenig sinnvoll, die Methode so lange stehen zu lassen, bis die Anzeige auch wirklich gezeichnet wurde.
Ein Problem stellt für sehr viele Applikationen leider die Tatsache dar, dass das Objekt zur Manipulation immer irgendwie sichtbar sein muss. Hier soll bar einfach direkt für die innere Klasse sichtbar sein.
Die Methoden invokeLater(…) und invokeAndWait(…) befinden sich nicht nur in der Klasse EventQueue, sondern sind noch einmal in der Klasse SwingUtilities untergebracht. Daher ist es gleichgültig, ob wir EventQueue.invokeXXX(…) oder SwingUtilities.invokeXXX(…) schreiben. SwingUtilities hat vielleicht den Vorteil, dass das Paket java.awt für die EventQueue nicht importiert werden muss, sonst gibt es aber keinen Unterschied.
[»]Hinweis
Einige Entwickler setzen den Programmcode der main(String[])-Methode zum Aufbau eines JFrames ebenfalls in einen invokeLater(…)-Block, etwa so:
@Override public void run() {
JFrame f = new JFrame( "Uhrzeit" );
f.setDefaultCloseOperation( JFrame.EXIT_ON_CLOSE );
f.add( new JLabel( String.format( "%tT", new Date() ) ) );
f.setSize( 250, 100 );
f.setVisible( true );
}
} );
Obwohl ein new JFrame() schon den AWT-Event-Thread startet, muss erst ab der Programmzeile mit setVisible(…) alles abgesichert werden. Die Beispiele in diesem Buch sind also vom Standpunkt des AWT-Threadings aus völlig in Ordnung.
Implementierung *
Genehmigen wir uns abschließend noch einen kurzen Blick auf die Implementierung. Es lässt sich schon erahnen, dass invokeLater(…) einfacher ist:
Toolkit.getEventQueue().postEvent(
new InvocationEvent(Toolkit.getDefaultToolkit(), runnable) );
}
Das Ereignis, das in die Event-Queue kommt, ist vom Typ InvocationEvent und damit ein AWTEvent. Wir übergeben unser Runnable-Objekt, damit der AWT-Thread später die run()-Methode aufrufen kann.
Die statische Methode invokeAndWait(…) ist etwas komplizierter; wir wollen von der Implementierung nur wenige Zeilen betrachten. Im Prinzip leistet die Methode das Gleiche wie invokeLater(…); auch sie muss das InvocationEvent in die Warteschlange legen. Hinzu kommt jedoch, dass invokeAndWait(…) auf das Ende des Threads warten muss:
Toolkit.getDefaultToolkit(), runnable, lock, true);
synchronized (lock) {
Toolkit.getEventQueue().postEvent(event);
lock.wait();
}
Das konstruierte InvocationEvent bekommt als Argument wieder das runnable. Jetzt erhält es aber zusätzlich ein Lock-Objekt. Wenn der AWT-Thread durch die Ereignis-Warteschlange geht und das InvocationEvent sieht, führt er wieder die run()-Methode aus. Anschließend informiert er über notify() das wartende Objekt. Dann steigt invokeAndWait(…) aus dem synchronized-Block aus, und es geht weiter.
10.27.4SwingWorker
Mit der Klasse SwingWorker ist es einfach möglich, längere Programmteile im Hintergrund von einem Nicht-AWT-Thread abarbeiten zu lassen und dann später die Ergebnisse über den AWT-Thread wieder in das GUI einfließen zu lassen.
Für einen eigenen SwingWorker ist zunächst eine Unterklasse von javax.swing.SwingWorker zu bilden. Wir wollen eine Klasse ClockPrecision angeben, die zwei Sekunden wartet und dabei die Zeit misst – das Ergebnis ist durch Ungenauigkeit nicht wirklich zwei Sekunden. Wir interessieren uns hier für die Ungenauigkeit. Nach Ablauf der Zeit soll der SwingWorker das Ergebnis auf die Schaltfläche schreiben, die auch der Auslöser für die Warterei ist:
Listing 10.91com/tutego/insel/ui/event/SwingWorkerDemo.java
import java.awt.event.*;
import javax.swing.*;
public class SwingWorkerDemo extends JFrame {
private JButton button = new JButton( "Change my mind!" );
SwingWorkerDemo() {
setDefaultCloseOperation( JFrame.EXIT_ON_CLOSE );
add( button );
ActionListener al = new ActionListener() {
@Override public void actionPerformed( ActionEvent e ) {
new ClockPrecision().execute();
}
};
button.addActionListener( al );
pack();
}
class ClockPrecision extends SwingWorker<Long,Object> {
@Override public Long doInBackground() {
long startNano = System.nanoTime();
try { TimeUnit.SECONDS.sleep( 2 ); } catch ( InterruptedException e ) { }
return (System.nanoTime() – startNano ) / (1000*1000);
}
@Override protected void done() {
try {
button.setText( "" + get() );
}
catch ( InterruptedException | ExecutionException e ) { e.printStackTrace(); }
}
}
public static void main( String[] args ) {
new SwingWorkerDemo().setVisible( true );
}
}
Die Methode done() bekommt die Rückgabe von doInBackground() über die get()-Methode. Unser SwingWorker durchläuft mehrere Phasen, an denen wir uns durch Überschreiben einiger Methoden aktiv beteiligen:
Es beginnt mit execute(), was den SwingWorker dazu bewegt, einen so genannten Worker-Thread aufzubauen.
Der Worker-Thread ruft doInBackground() auf, in den wir unseren im Hintergrund auszuführenden Programmteil setzen. Der Rückgabetyp ist durch die generische Verwendung frei wählbar. Da SwingWorker auch vom Typ Future ist, kann das Ergebnis einer Berechnung get() liefern. Sind mit addPropertyChangeListener(…) neue PropertyChangeListeners angemeldet, können wir sie mit firePropertyChange(…) aufrufen und während der Verarbeitung Statusereignisse schicken. publish(V...) erlaubt das Absenden von Zwischenergebnissen, die sich unter dem AWT-Event in process(List<V>) verarbeiten lassen. Dieser Typ kann ein anderer als der von get() sein, und so bestimmt die zweite Typvariable der generischen Klasse diesen Typ.
Am Ende des Worker-Threads kommt es im AWT-Event-Thread zu einem Aufruf von done(), wo wir unsere Swing-Operationen vornehmen können.
Weiteres ist der API-Dokumentation zu entnehmen.
10.27.5Eigene Ereignisse in die Queue setzen *
Es ist ohne großen Umweg möglich, eigene Ereignisse zu erzeugen und in der EventQueue zu platzieren. Damit lassen sich beispielsweise Eingaben des Benutzers emulieren. Da alle Ereignisse von Komponenten von AWTEvent erben, lässt sich ein ActionEvent erzeugen, das dann wiederum von einem interessierten Listener entgegengenommen wird. Jetzt fehlt uns nur noch eine Methode, die Ereignisse in die Schlange setzt. Dazu bietet die Klasse EventQueue die Methode postEvent(AWTEvent) an. Im Beispiel sehen wir die notwendigen Aufrufe, um beginnend bei Toolkit an die SystemEventQueue zu kommen:
postEvent(
new ActionEvent( /* Object source, int id, String command */ )
);
final EventQueue getSystemEventQueue()
Liefert ein Exemplar der EventQueue für eine Applikation oder ein Applet. Eine SecurityException wird ausgelöst, falls der Security-Manager den Zugriff auf EventQueue verbietet.
void postEvent(AWTEvent theEvent)
Legt ein Ereignis in die EventQueue. Danach werden vorhandene EventQueueListener und notifyEventQueueListener aufgerufen.
Einer Komponente ein Ereignis schicken
Ist die Komponente bekannt, der ein Ereignis geschickt werden soll, lässt sich die Component-Methode dispatchEvent(AWTEvent e) verwenden. Sie sendet ein AWTEvent – die Basisklasse aller AWT-Ereignisse – an die Komponente, womit alle Listener aufgerufen werden. Für die Aktivierung einer Schaltfläche b lautet es dann:
10.27.6Auf alle Ereignisse hören *
Um keine Ereignisse zu versäumen, lässt sich über das Toolkit ein Super-Listener anmelden. Dieser Listener ist vom Typ AWTEventListener, der über addAWTEventListener(…) mit dem Toolkit verbunden wird:
@Override public void eventDispatched( AWTEvent event ) { (…)
}
};
Toolkit.getDefaultToolkit().addAWTEventListener( ael, mask );
Die mask bestimmt den Typ eines jeden gemeldeten AWTEvent. Hier kann für Mausbewegungen etwa AWTEvent.MOUSE_MOTION_EVENT_MASK stehen.