eu.hgross.blaubot.geobeacon

Class GeoLocationBeacon

java.lang.Object

eu.hgross.blaubot.geobeacon.GeoLocationBeacon

All Implemented Interfaces:

IBlaubotBeacon, IBlaubotConnectionAcceptor

Direct Known Subclasses:

GeoLocationBeaconAndroid

public abstract class GeoLocationBeacon
extends java.lang.Object
implements IBlaubotBeacon

A Beacon that commits its current state to a server flavoured with geolocation data to get updates about nearby devices that do the same. Does not commit updates, if in passive mode. GeoLocation data has to be commited to this beacon instance by calling setGeoData(...). This beacon class should be subclassed to integrate the platform specific geo location provider into the subclass' internals. Call setGeoData() to provide this data.

Constructor Summary

Constructors

Constructor and Description
GeoLocationBeacon(IBlaubotBeaconStore beaconStore, IBlaubotConnector... connectors)

Method Summary

Modifier and Type	Method and Description
IBlaubotAdapter	getAdapter() Get the adapter of which this acceptor is part of.
ConnectionMetaDataDTO	getConnectionMetaData() Get the connection meta data needed to connect to this connector This infos can range from mac addresses over ip addresses to port numbers.
boolean	isStarted() Retrieves the started state of this acceptor.
void	onConnectionStateMachineStateChanged(IBlaubotState state) Called when the ConnectionStateMachine's state has changed.
void	setAcceptorListener(IBlaubotIncomingConnectionListener acceptorListener) Sets a listener that receives callbacks whenever a connection was accepted by the acceptor.
void	setBeaconStore(IBlaubotBeaconStore beaconStore) Setter method for the dependency injection of a beacon store.
void	setBlaubot(Blaubot blaubot) Dependency injecton of the blaubot instance the beacon is working for.
void	setDiscoveryActivated(boolean active) Enables and disables the discovery of other (remote) blaubot devices.
void	setDiscoveryEventListener(IBlaubotDiscoveryEventListener discoveryEventListener) Sets the discovery event listener which gets called whenever another remote device's state was discovered by this beacon or the BlaubotBeaconService.
void	setGeoData(GeoData geoData) Sets the current geo data
void	setListeningStateListener(IBlaubotListeningStateListener stateListener) Sets a listener that receives callbacks, when the acceptor started accepting connections (is listening).
void	startListening() Starts the connection acceptor.
void	stopListening() Stops a running acceptor.

Methods inherited from class java.lang.Object

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

Constructor Detail

GeoLocationBeacon

public GeoLocationBeacon(IBlaubotBeaconStore beaconStore,
                         IBlaubotConnector... connectors)

Parameters:

beaconStore - The beacon store holding the connection meta data for the given connectors to connect to the GeoBeaconServer's acceptors.

connectors - connectors to be used to establish a connection to the beacon server

Method Detail

setBlaubot

public void setBlaubot(Blaubot blaubot)

Description copied from interface: IBlaubotBeacon

Dependency injecton of the blaubot instance the beacon is working for. It is guaranteed that this is called before any start/stop calls.

Specified by:

setBlaubot in interface IBlaubotBeacon

Parameters:

blaubot - the blaubot instance

setBeaconStore

public void setBeaconStore(IBlaubotBeaconStore beaconStore)

Description copied from interface: IBlaubotBeacon

Setter method for the dependency injection of a beacon store. It is guaranteed to be called before the beacon is started for the first time.

Specified by:

setBeaconStore in interface IBlaubotBeacon

Specified by:

setBeaconStore in interface IBlaubotConnectionAcceptor

Parameters:

beaconStore - the beacon store implementation

getAdapter

public IBlaubotAdapter getAdapter()

Description copied from interface: IBlaubotConnectionAcceptor

Get the adapter of which this acceptor is part of. TODO: beacons really should not have this method!

Specified by:

getAdapter in interface IBlaubotConnectionAcceptor

Returns:

the adapter

startListening

public void startListening()

Description copied from interface: IBlaubotConnectionAcceptor

Starts the connection acceptor. The start method has to be idempotent.

Specified by:

startListening in interface IBlaubotConnectionAcceptor

stopListening

public void stopListening()

Description copied from interface: IBlaubotConnectionAcceptor

Stops a running acceptor. The stop method has to be idempotent.

Specified by:

stopListening in interface IBlaubotConnectionAcceptor

isStarted

public boolean isStarted()

Description copied from interface: IBlaubotConnectionAcceptor

Retrieves the started state of this acceptor.

Specified by:

isStarted in interface IBlaubotConnectionAcceptor

Returns:

true iff the acceptor is started and now or soon ready to accept incoming connections

setListeningStateListener

public void setListeningStateListener(IBlaubotListeningStateListener stateListener)

Description copied from interface: IBlaubotConnectionAcceptor

Sets a listener that receives callbacks, when the acceptor started accepting connections (is listening). That is if a typically (commonly needed) internal accept thread was started or stopped.

Specified by:

setListeningStateListener in interface IBlaubotConnectionAcceptor

Parameters:

stateListener - the listner to set

setAcceptorListener

public void setAcceptorListener(IBlaubotIncomingConnectionListener acceptorListener)

Description copied from interface: IBlaubotConnectionAcceptor

Sets a listener that receives callbacks whenever a connection was accepted by the acceptor.

Specified by:

setAcceptorListener in interface IBlaubotConnectionAcceptor

Parameters:

acceptorListener - the listener to be set

getConnectionMetaData

public ConnectionMetaDataDTO getConnectionMetaData()

Description copied from interface: IBlaubotConnectionAcceptor

Get the connection meta data needed to connect to this connector This infos can range from mac addresses over ip addresses to port numbers.

Specified by:

getConnectionMetaData in interface IBlaubotConnectionAcceptor

Returns:

the connection meta data

setDiscoveryEventListener

public void setDiscoveryEventListener(IBlaubotDiscoveryEventListener discoveryEventListener)

Description copied from interface: IBlaubotBeacon

Sets the discovery event listener which gets called whenever another remote device's state was discovered by this beacon or the BlaubotBeaconService.

Specified by:

setDiscoveryEventListener in interface IBlaubotBeacon

Parameters:

discoveryEventListener - the listener to be set

onConnectionStateMachineStateChanged

public void onConnectionStateMachineStateChanged(IBlaubotState state)

Description copied from interface: IBlaubotBeacon

Called when the ConnectionStateMachine's state has changed. An implementation has to expose this state as soon as possible to compatible beacons.

Specified by:

onConnectionStateMachineStateChanged in interface IBlaubotBeacon

Parameters:

state - the new state of the ConnectionStateMachine

setDiscoveryActivated

public void setDiscoveryActivated(boolean active)

Description copied from interface: IBlaubotBeacon

Enables and disables the discovery of other (remote) blaubot devices.

Specified by:

setDiscoveryActivated in interface IBlaubotBeacon

Parameters:

active - if set to true, the discovery (if running) will be active - inactive otherwise

setGeoData

public void setGeoData(GeoData geoData)

Sets the current geo data

Parameters:

geoData - the best known location of this device