eu.hgross.blaubot.core

Class BlaubotServerConnector

java.lang.Object

eu.hgross.blaubot.core.BlaubotServerConnector

public class BlaubotServerConnector
extends java.lang.Object

This class connects to BlaubotServer instances. It consists of a BeaconStore holding the immutable connection params for the server and a set of connectors to be used to connect to the given connection params. It is designed to be started from a lifecycle listener and should be activated/deactivated by the connect/disconnect events.

Constructor Summary

Constructors

Constructor and Description
BlaubotServerConnector(java.lang.String serverUniqueDeviceId, IBlaubotBeaconStore beaconStore, java.util.List<IBlaubotConnector> connectors)

Method Summary

Modifier and Type	Method and Description
void	activateServerConnector() Activates the connector.
void	deactivateServerConnector() Deactivates the connector and the connectivity polling.
boolean	getDoConnect()
IBlaubotConnection	getServerConnection() Returns the connection to the server, if available
java.lang.String	getServerUniqueDeviceId() The configured server's unique device id
boolean	isConnected() Indicates whether a connection to the server is available or not.
static void	main(java.lang.String[] args)
void	setDoConnect(boolean doConnect) This is the switch which activates or deactivates the server connection.
void	setIncomingConnectionListener(IBlaubotIncomingConnectionListener incomingConnectionListener) Sets the incoming connection listener which is called if a connection to the server was established.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

BlaubotServerConnector

public BlaubotServerConnector(java.lang.String serverUniqueDeviceId,
                              IBlaubotBeaconStore beaconStore,
                              java.util.List<IBlaubotConnector> connectors)

Parameters:

serverUniqueDeviceId - the server's static unqiueDevice id

beaconStore - the beacon store to be used. Should already contain connection meta data to conncet to serverUniqueDeviceId

connectors - the list of connectors to be used to establish a connection to the server device

Method Detail

getServerUniqueDeviceId

public java.lang.String getServerUniqueDeviceId()

The configured server's unique device id

Returns:

server's uniqueDeviceId

isConnected

public boolean isConnected()

Indicates whether a connection to the server is available or not. If true, the connection is retrievable via getServerConnection()

Returns:

true iff a connection to the server is available

getServerConnection

public IBlaubotConnection getServerConnection()

Returns the connection to the server, if available

Returns:

the connection to the server or null, if not connected

activateServerConnector

public void activateServerConnector()

Activates the connector. The connector will poll the connectivity state and initiate a connection to the server if not currently connected.

deactivateServerConnector

public void deactivateServerConnector()

Deactivates the connector and the connectivity polling.

setIncomingConnectionListener

public void setIncomingConnectionListener(IBlaubotIncomingConnectionListener incomingConnectionListener)

Sets the incoming connection listener which is called if a connection to the server was established.

Parameters:

incomingConnectionListener - the listener to be set

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

main

public static void main(java.lang.String[] args)

setDoConnect

public void setDoConnect(boolean doConnect)

This is the switch which activates or deactivates the server connection. If not active, the connection will not be established. If active the connector tries to connect to the server and allows the network to use this connection as the relay to the server. If changing from active to inactive, (doConnect == false), then a possibly established connection will be disconnected.

Parameters:

doConnect - true if the connector should connect, false if not.

getDoConnect

public boolean getDoConnect()

Returns:

true iff the serverConnector is trying to establish a connection