eu.hgross.blaubot.core

Class LifeCycleEventDispatcher

java.lang.Object

eu.hgross.blaubot.core.LifeCycleEventDispatcher

All Implemented Interfaces:

IBlaubotConnectionStateMachineListener, IBlaubotAdminMessageListener

public class LifeCycleEventDispatcher
extends java.lang.Object
implements IBlaubotAdminMessageListener, IBlaubotConnectionStateMachineListener

Listens for CensusMessages, calculates the diff (left or joined devices and prince changes) and communicates them through the ILifecycleListeners attached to this Blaubot instance. If attached to a ConnectionStateMachine, dispatches the corresponding events to it's listeners when a kingdom merge takes place, the king dies, the prince takes over and so on.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	LOG_TAG

Constructor Summary

Constructors

Constructor and Description
LifeCycleEventDispatcher(IBlaubotDevice ownDevice)

Method Summary

Modifier and Type	Method and Description
void	addLifecycleListener(ILifecycleListener lifecycleListener) Adds an ILifecycleListener
void	notifyConnectedToNetwork() Simply calls onConnected() on all registered listeners
void	notifyDisconnectedFromNetwork(java.lang.String oldKingUniqueId) Triggers onDeviceLeft(..) for all of the known devices from the old network (except the own devices) followed by a onDisconnected() on the ILifecycleListener added to this Blaubot instance.
void	onAdminMessage(AbstractAdminMessage adminMessage) Called when an admin message was received
void	onStateChanged(IBlaubotState oldState, IBlaubotState newState) Gets called when the ConnectionStateMachine's state changed to state.
void	onStateMachineStarted() Gets called when the ConnectionStateMachine changes it's IBlaubotState from the StoppedState to another IBlaubotState.
void	onStateMachineStopped() Gets called when the ConnectionStateMachine stopped.
void	removeLifecycleListener(ILifecycleListener lifecycleListener) Removes an ILifecycleListener

Methods inherited from class java.lang.Object

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

Field Detail

LOG_TAG

public static final java.lang.String LOG_TAG

See Also:

Constant Field Values

Constructor Detail

LifeCycleEventDispatcher

public LifeCycleEventDispatcher(IBlaubotDevice ownDevice)

Method Detail

onAdminMessage

public void onAdminMessage(AbstractAdminMessage adminMessage)

Description copied from interface: IBlaubotAdminMessageListener

Called when an admin message was received

Specified by:

onAdminMessage in interface IBlaubotAdminMessageListener

Parameters:

adminMessage - the received admin message

onStateChanged

public void onStateChanged(IBlaubotState oldState,
                           IBlaubotState newState)

Description copied from interface: IBlaubotConnectionStateMachineListener

Gets called when the ConnectionStateMachine's state changed to state.

Specified by:

onStateChanged in interface IBlaubotConnectionStateMachineListener

Parameters:

oldState - the former state (can be null)

newState - the new state

notifyConnectedToNetwork

public void notifyConnectedToNetwork()

Simply calls onConnected() on all registered listeners

notifyDisconnectedFromNetwork

public void notifyDisconnectedFromNetwork(java.lang.String oldKingUniqueId)

Triggers onDeviceLeft(..) for all of the known devices from the old network (except the own devices) followed by a onDisconnected() on the ILifecycleListener added to this Blaubot instance.

Parameters:

oldKingUniqueId - the uniqueDeviceId of the former network's king device.

onStateMachineStopped

public void onStateMachineStopped()

Description copied from interface: IBlaubotConnectionStateMachineListener

Gets called when the ConnectionStateMachine stopped. This means a state change to StoppedState and is a shorthand for public void onStateChange(IBlaubotState state) { if(state instanceof StoppedState) { // code } }

Specified by:

onStateMachineStopped in interface IBlaubotConnectionStateMachineListener

onStateMachineStarted

public void onStateMachineStarted()

Description copied from interface: IBlaubotConnectionStateMachineListener

Gets called when the ConnectionStateMachine changes it's IBlaubotState from the StoppedState to another IBlaubotState.

Specified by:

onStateMachineStarted in interface IBlaubotConnectionStateMachineListener

addLifecycleListener

public void addLifecycleListener(ILifecycleListener lifecycleListener)

Adds an ILifecycleListener

Parameters:

lifecycleListener - the listener to add

removeLifecycleListener

public void removeLifecycleListener(ILifecycleListener lifecycleListener)

Removes an ILifecycleListener

Parameters:

lifecycleListener - the listener to remove