eu.webtoolkit.jwt
Class Signal2<A1,A2>

java.lang.Object
  eu.webtoolkit.jwt.AbstractSignal
      eu.webtoolkit.jwt.Signal2<A1,A2>

public class Signal2<A1,A2>
extends AbstractSignal

A signal that propagates events to listeners, and is capable of passing 2 argument.

A signal implements the Observer pattern, allowing one or more listeners to listen for events generated on the signal. The event may propagate 2 arguments to the listeners.

A usage example: class MyWidget extends WContainerWidget { public MyWidget(WContainerWidget parent) { super(parent); this.done = new Signal2(); ... WPushButton button = new WPushButton("Okay"); button.clicked().addListener(this, new Signal.Listener() { public void trigger() { process(); } }); } // provide an accessor for the signal Signal2 done() { return done; } private Signal2 done; void process() { ... done.trigger(42, "Totally done"); // trigger the signal } }; This widget could then be used form another class: class GUIClass extends WContainerWidget { ... private void init() { MyWidget widget = new MyWidget(this); widget.done().addListener(this, new Signal2.Listener() { public void trigger(Integer i, String s) { whenDone(i, s); } }); } void whenDone(int result, String description) { ... } };

Nested Class Summary

static interface

Signal2.Listener<A1,A2> The listener interface.

Nested classes/interfaces inherited from class eu.webtoolkit.jwt.AbstractSignal

AbstractSignal.Connection

Constructor Summary

Signal2()
Creates a new signal.

Method Summary

AbstractSignal.Connection	addListener(WObject listenerOwner, Signal.Listener listener) Adds a listener for this signal.
AbstractSignal.Connection	addListener(WObject listenerOwner, Signal2.Listener<A1,A2> listener) Adds a listener for this signal.
void	removeListener(Signal.Listener listener) Removes a listener.
void	removeListener(Signal2.Listener<A1,A2> listener) Removes a listener.
void	trigger(A1 arg1, A2 arg2) Triggers the signal.

Methods inherited from class eu.webtoolkit.jwt.AbstractSignal

getListenerCount, getListeners, isBlocked, isConnected, setBlocked

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Signal2

public Signal2()

Creates a new signal.

Method Detail

addListener

public AbstractSignal.Connection addListener(WObject listenerOwner,
                                             Signal2.Listener<A1,A2> listener)

Adds a listener for this signal.

Each listener will be triggered whenever the signal is triggered.

Parameters:

listenerOwner - the enclosing object for a listener implemented using an (anonymous) inner class

listener - the listener

Returns:

a connection object that may be used to control the connection

See Also:

AbstractSignal.addListener(WObject, eu.webtoolkit.jwt.Signal.Listener)

removeListener

public void removeListener(Signal2.Listener<A1,A2> listener)

Removes a listener.

Parameters:

listener - a listener that was previously added

trigger

public void trigger(A1 arg1,
                    A2 arg2)

Triggers the signal.

The arguments are passed to the listeners.

Parameters:

arg1 - Argument 1.

arg2 - Argument 2.

addListener

public AbstractSignal.Connection addListener(WObject listenerOwner,
                                             Signal.Listener listener)

Description copied from class: AbstractSignal

Adds a listener for this signal.

Each listener will be notified when the signal is triggered.

An owner object may be passed when the listener is implemented using an (anonymous) inner class. In that case the owner object should be the enclosing object of the listener object, and this is used to bind the lifetime of the listener. To avoid the owner object from not being garbage collected when it is no longer used, only the owner object will add a reference to the listener, while the signal will use a weak reference.

This avoids the most common reason for memory leaks in Java implementations of the Observer pattern: the owner object will not get garbage collected because of the (anonymous) listener object having a reference to it, even if the receiver object is no longer referenced from anywhere. When the owner object is not null, the listener is stored using a strong reference in the owner object, and using a weak reference in the signal.

Specified by:

addListener in class AbstractSignal

Parameters:

listenerOwner - if not null, the enclosing object for a listener implemented using an inner class

listener - the listener

Returns:

a connection object that may be used to control the connection

removeListener

public void removeListener(Signal.Listener listener)

Description copied from class: AbstractSignal

Removes a listener.

Specified by:

removeListener in class AbstractSignal

Parameters:

listener - a listener that was previously added.