eu.hgross.blaubot.util

Class KingdomCensusLifecycleListener

java.lang.Object

java.util.Observable

eu.hgross.blaubot.util.KingdomCensusLifecycleListener

All Implemented Interfaces:

ILifecycleListener

public class KingdomCensusLifecycleListener
extends java.util.Observable
implements ILifecycleListener

An utility lifecycle listener that keeps track of the currently connected devices inside the kingdom. It extends Observable so any interest party can attach themselve to changes via addObserver().

Constructor Summary

Constructors

Constructor and Description
KingdomCensusLifecycleListener(IBlaubotDevice ownDevice)

Method Summary

Modifier and Type	Method and Description
java.util.Set<java.lang.String>	getConnectedUniqueIds() Get the unique ids for all connected devices
IBlaubotDevice	getCurrentKing() Get the current king device
IBlaubotDevice	getCurrentPrinceDevice() Get the current prince device.
java.util.Set<IBlaubotDevice>	getDevices() Get the connected devices
void	onConnected() Triggered when the Blaubot instance becomes part of a blaubot kingdom.
void	onDeviceJoined(IBlaubotDevice blaubotDevice) Triggered when another Blaubot instance on another IBlaubotDevice joined the network.
void	onDeviceLeft(IBlaubotDevice blaubotDevice) Triggered when an IBlaubotDevice left the blaubot kingdom.
void	onDisconnected() Triggered when the Blaubot instance is no longer part of a blaubot kingdom.
void	onKingDeviceChanged(IBlaubotDevice oldKing, IBlaubotDevice newKing) Triggered when the king device was changed.
void	onPrinceDeviceChanged(IBlaubotDevice oldPrince, IBlaubotDevice newPrince) Triggered when a prince nomination was completed.

Methods inherited from class java.util.Observable

addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged

Methods inherited from class java.lang.Object

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

Constructor Detail

KingdomCensusLifecycleListener

public KingdomCensusLifecycleListener(IBlaubotDevice ownDevice)

Parameters:

ownDevice - the own device

Method Detail

getDevices

public java.util.Set<IBlaubotDevice> getDevices()

Get the connected devices

Returns:

A set of devices inside the current blaubot network.

getConnectedUniqueIds

public java.util.Set<java.lang.String> getConnectedUniqueIds()

Get the unique ids for all connected devices

Returns:

A set of device unique ids inside the current blaubot network.

getCurrentPrinceDevice

public IBlaubotDevice getCurrentPrinceDevice()

Get the current prince device.

Returns:

the current prince device; may be null

getCurrentKing

public IBlaubotDevice getCurrentKing()

Get the current king device

Returns:

the current king devce - may be null, if no king

onConnected

public void onConnected()

Description copied from interface: ILifecycleListener

Triggered when the Blaubot instance becomes part of a blaubot kingdom.

Specified by:

onConnected in interface ILifecycleListener

onDisconnected

public void onDisconnected()

Description copied from interface: ILifecycleListener

Triggered when the Blaubot instance is no longer part of a blaubot kingdom.

Specified by:

onDisconnected in interface ILifecycleListener

onDeviceJoined

public void onDeviceJoined(IBlaubotDevice blaubotDevice)

Description copied from interface: ILifecycleListener

Triggered when another Blaubot instance on another IBlaubotDevice joined the network. It is guaranteed that for one specific IBlaubotDevice ILifecycleListener.onDeviceJoined(IBlaubotDevice) is never called twice without a triggered ILifecycleListener.onDeviceLeft(IBlaubotDevice) in between.

Specified by:

onDeviceJoined in interface ILifecycleListener

Parameters:

blaubotDevice - the joined device

onDeviceLeft

public void onDeviceLeft(IBlaubotDevice blaubotDevice)

Description copied from interface: ILifecycleListener

Triggered when an IBlaubotDevice left the blaubot kingdom.

Specified by:

onDeviceLeft in interface ILifecycleListener

Parameters:

blaubotDevice - the device that just left

onPrinceDeviceChanged

public void onPrinceDeviceChanged(IBlaubotDevice oldPrince,
                                  IBlaubotDevice newPrince)

Description copied from interface: ILifecycleListener

Triggered when a prince nomination was completed.

Specified by:

onPrinceDeviceChanged in interface ILifecycleListener

Parameters:

oldPrince - the old prince (may be null, in case no prince was nominated previously)

newPrince - the new prince (may be null, in case there is no device to be prince)

onKingDeviceChanged

public void onKingDeviceChanged(IBlaubotDevice oldKing,
                                IBlaubotDevice newKing)

Description copied from interface: ILifecycleListener

Triggered when the king device was changed. Both params may be null, if there was no king before or is no king now.

Specified by:

onKingDeviceChanged in interface ILifecycleListener

Parameters:

oldKing - the old king

newKing - the new king