spin

Class Spin


public class Spin
extends java.lang.Object

Spin offers a transparent threading solution for developing non-freezing Swing applications.

Let bean be a reference to a non-visual (possibly multithreaded) bean implementing the interface Bean whose methods have to be called by a Swing component. You can avoid any freezing by using one line of code:

 bean = (Bean) Spin.off(bean);
 
Now each method call on bean is executed on a separate thread, while the EDT is continuing to dispatch events. All return values or exceptions are handled by Spin and transparently returned to the calling method.

For calls from other threads than the EDT to your Swing component you can use the following (being XYListener any interface your component implements):

     bean.addXYListener((XYListener)Spin.over(component); 
 
Now all required updates to your component (and/or its model) are transparently excuted on the EDT.
See Also:
off(Object), over(Object), ProxyFactory, spin.off.SpinOffEvaluator, spin.over.SpinOverEvaluator

Constructor Summary

Spin(Object object, Evaluator evaluator)
Create a Spin wrapper for the given object.
Spin(Object object, ProxyFactory proxyFactory, Evaluator evaluator)
Create a Spin wrapper for the given object.

Method Summary

static Evaluator
getDefaultOffEvaluator()
Get the default evaluator for spin-off.
static Evaluator
getDefaultOverEvaluator()
Get the default evaluator for spin-over.
static ProxyFactory
getDefaultProxyFactory()
Get the default proxy factory.
Object
getProxy()
Get a proxy for the wrapped object.
static Object
off(Object object)
Convenience method to spin-off the given object from Swing.
static Object
over(Object object)
Convenience method to spin-over the given object with Swing.
static void
setDefaultOffEvaluator(Evaluator evaluator)
Set the default evaluator for spin-off.
static void
setDefaultOverEvaluator(Evaluator evaluator)
Set the default evaluator for spin-over.
static void
setDefaultProxyFactory(ProxyFactory factory)
Set the default factory of proxies.

Constructor Details

Spin

public Spin(Object object,
            Evaluator evaluator)
Create a Spin wrapper for the given object.
Parameters:
object - object to wrap
evaluator - evaluator of invocations on the given object

Spin

public Spin(Object object,
            ProxyFactory proxyFactory,
            Evaluator evaluator)
Create a Spin wrapper for the given object.
Parameters:
object - object to wrap
proxyFactory - factory for a proxy
evaluator - evaluator of invocations on the given object

Method Details

getDefaultOffEvaluator

public static Evaluator getDefaultOffEvaluator()
Get the default evaluator for spin-off.
Returns:
evaluator for spin-off

getDefaultOverEvaluator

public static Evaluator getDefaultOverEvaluator()
Get the default evaluator for spin-over.
Returns:
evaluator for spin-over

getDefaultProxyFactory

public static ProxyFactory getDefaultProxyFactory()
Get the default proxy factory.
Returns:
the default factory of proxies

getProxy

public Object getProxy()
Get a proxy for the wrapped object.
The returned object can safely be casted to any interface the wrapped object implements.
Returns:
the new proxy

off

public static Object off(Object object)
Convenience method to spin-off the given object from Swing.

The returned object can safely be casted to any interface the given object implements.

Parameters:
object - the object to spin-off
Returns:
proxy for the given object

over

public static Object over(Object object)
Convenience method to spin-over the given object with Swing.
The returned object can safely be casted to any interface the given object implements.
Parameters:
object - the object to spin-over
Returns:
proxy for the given object

setDefaultOffEvaluator

public static void setDefaultOffEvaluator(Evaluator evaluator)
Set the default evaluator for spin-off.
Parameters:
evaluator - evaluator to use for spin-off

setDefaultOverEvaluator

public static void setDefaultOverEvaluator(Evaluator evaluator)
Set the default evaluator for spin-over.
Parameters:
evaluator - evaluator for spin-over

setDefaultProxyFactory

public static void setDefaultProxyFactory(ProxyFactory factory)
Set the default factory of proxies.
Parameters:
factory - proxy factore to use as default