eu.hgross.blaubot.core

Class BlaubotConnectionManager

java.lang.Object

eu.hgross.blaubot.core.BlaubotConnectionManager

public class BlaubotConnectionManager
extends java.lang.Object

Manager to store and retrieve Connections related to IBlaubotDevice instances.

Field Summary

Fields

Modifier and Type	Field and Description
static int	AUTO_MAX_RETRIES Can be used in conjunction with connectToDevice(IBlaubotDevice, int) to let the ConnectionManager decide how much retries to use.

Constructor Summary

Constructors

Constructor and Description
BlaubotConnectionManager(java.util.List<IBlaubotConnectionAcceptor> acceptors, java.util.List<IBlaubotConnector> connectors) Creates a new BlaubotConnectionManager instance managing the given acceptors and connectors for incoming and outgoing connections.

Method Summary

Modifier and Type	Method and Description
protected void	addConnection(IBlaubotConnection connection)
void	addConnectionListener(IBlaubotConnectionManagerListener listener)
IBlaubotConnection	connectToBlaubotDevice(IBlaubotDevice device, int maxRetries) Tries to connect to the given IBlaubotDevice.
IBlaubotConnection	connectToBlaubotDevice(java.lang.String uniqueId, int maxRetries) Tries to connect to the IBlaubotDevice corresponding to the given uniqueId by aksing all connectors if for a device object belonging to this uniqueId and trying to connect to this device.
IBlaubotDevice	createBlaubotDeviceFromUniqueId(java.lang.String uniqueDeviceId) Goes through all connected devices and tries to find an IBlaubotDevice instance with this uniqueId.
java.util.List<IBlaubotConnection>	getAllConnections()
java.util.List<IBlaubotDevice>	getConnectedDevices()
java.util.List<IBlaubotConnector>	getConnectionConnectors()
java.util.List<IBlaubotConnection>	getConnections(IBlaubotDevice blauBotDevice)
IBlaubotConnector	getConnectorForDevice(java.lang.String uniqueDeviceId) Tries to find a connector for the given uniqueDeviceId by determinig the appropriate connectors via the IBlaubotBeaconStores meta data (if a beaconstore was provided).
protected void	removeConnection(IBlaubotConnection connection)
void	removeConnectionListener(IBlaubotConnectionManagerListener listener)
void	setBeaconStore(IBlaubotBeaconStore beaconStore) Sets the beacon store to be used to get the last beacon states and connectivity meta data

Methods inherited from class java.lang.Object

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

Field Detail

AUTO_MAX_RETRIES

public static final int AUTO_MAX_RETRIES

Can be used in conjunction with connectToDevice(IBlaubotDevice, int) to let the ConnectionManager decide how much retries to use.

See Also:

Constant Field Values

Constructor Detail

BlaubotConnectionManager

public BlaubotConnectionManager(java.util.List<IBlaubotConnectionAcceptor> acceptors,
                                java.util.List<IBlaubotConnector> connectors)

Creates a new BlaubotConnectionManager instance managing the given acceptors and connectors for incoming and outgoing connections.

Parameters:

acceptors - the acceptors to handle

connectors - the connectors to be used to connect to other devices

Method Detail

addConnection

protected void addConnection(IBlaubotConnection connection)

removeConnection

protected void removeConnection(IBlaubotConnection connection)

getConnections

public java.util.List<IBlaubotConnection> getConnections(IBlaubotDevice blauBotDevice)

Parameters:

blauBotDevice - the list of IBlaubotDevices of this device.

Returns:

the connection object (a socket, bluetoothsocket ...) or null, if nothing there for blauBotDevice

getConnectedDevices

public java.util.List<IBlaubotDevice> getConnectedDevices()

Returns:

a list of devices with at least one active connection to our device

getAllConnections

public java.util.List<IBlaubotConnection> getAllConnections()

Returns:

list of all active connections

addConnectionListener

public void addConnectionListener(IBlaubotConnectionManagerListener listener)

removeConnectionListener

public void removeConnectionListener(IBlaubotConnectionManagerListener listener)

getConnectionConnectors

public java.util.List<IBlaubotConnector> getConnectionConnectors()

Returns:

list of connectors associated with this manager

getConnectorForDevice

public IBlaubotConnector getConnectorForDevice(java.lang.String uniqueDeviceId)

Tries to find a connector for the given uniqueDeviceId by determinig the appropriate connectors via the IBlaubotBeaconStores meta data (if a beaconstore was provided).

Parameters:

uniqueDeviceId - the unique device id to connect to

Returns:

the connector able to connect to one of the device's acceptors, or null, if no acceptor meta data or connector is available for this device

connectToBlaubotDevice

public IBlaubotConnection connectToBlaubotDevice(IBlaubotDevice device,
                                                 int maxRetries)

Tries to connect to the given IBlaubotDevice. If not successful after maxRetries, null will be returned. The retry mechanism uses the exponential backoff method which waiting time is configured by the BlaubotAdapterConfig for this device's adapter.

Parameters:

device - the IBlaubotDevice to connect to

maxRetries - max number of retries or BlaubotConnectionManager.AUTO_MAX_RETRIES to let the manager decide

Returns:

an IBlaubotConnection or null, if no connection could be established after maxRetries

connectToBlaubotDevice

public IBlaubotConnection connectToBlaubotDevice(java.lang.String uniqueId,
                                                 int maxRetries)

Tries to connect to the IBlaubotDevice corresponding to the given uniqueId by aksing all connectors if for a device object belonging to this uniqueId and trying to connect to this device. If not successful after maxRetries, null will be returned. The retry mechanism uses the exponential backoff method which waiting time is configured by the BlaubotAdapterConfig for this device's adapter.

Parameters:

uniqueId - the device's uniqueId

maxRetries - max number of retries or BlaubotConnectionManager.AUTO_MAX_RETRIES to let the manager decide

Returns:

an IBlaubotConnection or null, if no connection could be established after maxRetries

createBlaubotDeviceFromUniqueId

public IBlaubotDevice createBlaubotDeviceFromUniqueId(java.lang.String uniqueDeviceId)

Goes through all connected devices and tries to find an IBlaubotDevice instance with this uniqueId. If the device was found, it is returned. If not, a generic BlaubotDevice instance is returned.

Parameters:

uniqueDeviceId - the unique device id to create a blaubot device for

Returns:

the corresponding IBlaubotDevice instance

setBeaconStore

public void setBeaconStore(IBlaubotBeaconStore beaconStore)

Sets the beacon store to be used to get the last beacon states and connectivity meta data

Parameters:

beaconStore - the store instance