Jitsi: the OpenSource Java VoIP and Instant Messaging client.

net.java.sip.communicator.util.swing
Class SwingWorker

java.lang.Object
  extended by net.java.sip.communicator.util.swing.SwingWorker
Direct Known Subclasses:
LanguageMenuBar.SetSpellChecker

public abstract class SwingWorker
extends Object

Utility class based on the javax.swing.SwingWorker. SwingWorker is an abstract class that you subclass to perform GUI-related work in a dedicated thread. In addition to the original SwingWorker this class takes care of exceptions occured during the execution of the separate thread. It would call a catchException() method in the Swing thread if an exception occurs.

Author:
Yana Stamcheva

Constructor Summary
SwingWorker()
          Start a thread that will call the construct method and then exit.
 
Method Summary
 void catchException(Throwable exception)
          Called on the event dispatching thread (not on the worker thread) if an exception has occured during the construct method.
abstract  Object construct()
          Compute the value to be returned by the get method.
 void finished()
          Called on the event dispatching thread (not on the worker thread) after the construct method has returned.
 Object get()
          Return the value created by the construct method.
protected  Object getValue()
          Get the value produced by the worker thread, or null if it hasn't been constructed yet.
 void interrupt()
          A new method that interrupts the worker thread.
 void start()
          Start the worker thread.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SwingWorker

public SwingWorker()
Start a thread that will call the construct method and then exit.

Method Detail

getValue

protected Object getValue()
Get the value produced by the worker thread, or null if it hasn't been constructed yet.


construct

public abstract Object construct()
                          throws Exception
Compute the value to be returned by the get method.

Throws:
Exception

finished

public void finished()
Called on the event dispatching thread (not on the worker thread) after the construct method has returned.


catchException

public void catchException(Throwable exception)
Called on the event dispatching thread (not on the worker thread) if an exception has occured during the construct method.

Parameters:
exception - the exception that has occured

interrupt

public void interrupt()
A new method that interrupts the worker thread. Call this method to force the worker to stop what it's doing.


get

public Object get()
Return the value created by the construct method. Returns null if either the constructing thread or the current thread was interrupted before a value was produced.

Returns:
the value created by the construct method

start

public void start()
Start the worker thread.


Jitsi: the OpenSource Java VoIP and Instant Messaging client.

Jitsi, the OpenSource Java VoIP and Instant Messaging client.
Distributable under LGPL license.