Package spin

Class Spin

java.lang.Object
spin.Spin

public class Spin extends 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:
  • 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

    • 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
      See Also:
    • 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
      See Also:
    • setDefaultProxyFactory

      public static void setDefaultProxyFactory(ProxyFactory factory)
      Set the default factory of proxies.
      Parameters:
      factory - proxy factore to use as default
    • 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
    • getDefaultProxyFactory

      public static ProxyFactory getDefaultProxyFactory()
      Get the default proxy factory.
      Returns:
      the default factory of proxies
    • 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