Package ch.hsr.adv.ui.core.logic.events

Class EventManager

java.lang.Object

ch.hsr.adv.ui.core.logic.events.EventManager

public class EventManager
extends java.lang.Object

This class is responsible for the event dispatching of all ADVEvents It uses Java's PropertyChangeSupport internally.

Modules can register PropertyChangeListeners to listen for specific Events which are fired by the ADV framework.

Constructor Summary

Constructors

Constructor	Description
EventManager()

Method Summary

Modifier and Type	Method	Description
void	fire(ADVEvent event, java.lang.Object oldVal, java.lang.Object newVal, java.lang.String... filterArgs)	Executes an ADV event and transmits the old and the new value to all subscribers.
void	subscribe(java.beans.PropertyChangeListener listener, ADVEvent event, java.lang.String... filterArgs)	Registers a listener for a specific event
void	subscribe(java.beans.PropertyChangeListener listener, java.util.List<ADVEvent> events, java.lang.String... filterArgs)	Registers a listener for multiple events
void	unsubscribe(java.beans.PropertyChangeListener listener, ADVEvent event, java.lang.String... filterArgs)	Removes the listener for a specific event
void	unsubscribe(java.beans.PropertyChangeListener listener, java.util.List<ADVEvent> events, java.lang.String... filterArgs)	Removes the listener for multiple events

Methods inherited from class java.lang.Object

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

Constructor Detail

EventManager

public EventManager()

Method Detail

subscribe

public void subscribe(java.beans.PropertyChangeListener listener,
                      ADVEvent event,
                      java.lang.String... filterArgs)

Registers a listener for a specific event

If filter arguments are provided, they are added to the event handle. This can be handy to narrow the context of an event (e.g. only listen for added snapshots in the session with id XY).

usage example: subscribe(listener, ADVEvent.SESSION_REMOVED, sessionId + "")

Parameters:

listener - listener

event - ADV event handle

filterArgs - optional filter arguments

subscribe

public void subscribe(java.beans.PropertyChangeListener listener,
                      java.util.List<ADVEvent> events,
                      java.lang.String... filterArgs)

Registers a listener for multiple events

If filter arguments are provided, they are added to the event handle. This can be handy to narrow the context of an event (e.g. only listen for added snapshots in the session with id XY).

usage example: subscribe(listener, eventlist, sessionId + "")

Parameters:

listener - listener

events - ADV events handle

filterArgs - optional filter arguments

unsubscribe

public void unsubscribe(java.beans.PropertyChangeListener listener,
                        ADVEvent event,
                        java.lang.String... filterArgs)

Removes the listener for a specific event

If filter arguments are provided, they are added to the event handle. This can be handy to narrow the context of an event (e.g. only listen for added snapshots in the session with id XY).

usage example: unsubscribe(listener, ADVEvent.SESSION_REMOVED, sessionId + "")

Parameters:

listener - listener

event - ADV event handle

filterArgs - optional filter arguments

unsubscribe

public void unsubscribe(java.beans.PropertyChangeListener listener,
                        java.util.List<ADVEvent> events,
                        java.lang.String... filterArgs)

Removes the listener for multiple events

usage example: unsubscribe(listener, eventlist, sessionId + "")

Parameters:

listener - listener

events - ADV events

filterArgs - optional filter arguments

fire

public void fire(ADVEvent event,
                 java.lang.Object oldVal,
                 java.lang.Object newVal,
                 java.lang.String... filterArgs)

Executes an ADV event and transmits the old and the new value to all subscribers.

If filter arguments are provided, they are added to the event handle. This can be handy to narrow the context of an event (e.g. only listen for added snapshots in the session with id XY).

usage example: unsubscribe(ADVEvent.SESSION_REMOVED, session, null, sessionId + "")

Parameters:

event - event handle

oldVal - value before change

newVal - value after change

filterArgs - optional filter arguments