sila_java.library.manager

Class SiLAManager

java.lang.Object

sila_java.library.manager.SiLAManager

public class SiLAManager
extends Object

Singleton Manager to manage SiLA Servers This Manager will keep a cache of all servers added either through discovery or via invoking the add function by other means (e.g. manually). It will also keep track of their Status with a Heartbeat.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SiLAManager.SiLAServerListener Listener for 3rd Party Applications

Method Summary

Modifier and Type	Method and Description
void	addServer(String host, int port) Add Server manually to cache
void	addServer(String host, int port, UUID discoveryId) Add Server to Cache with Discovery Id
void	addSiLAServerListener(SiLAManager.SiLAServerListener siLAServerListener) Add additional listener to retrieve SiLA Server information in-process
void	blockUntilServerFound(String serverName, int timeOut) Blocking call until online server is found in cache
static SiLAManager	getInstance()
Map<UUID,SiLAConnection>	getSilaConnections() Get Map of managed SiLA Connections
Map<UUID,Server>	getSiLAServers() Get Map of managed SiLA Servers
List<Server>	getSiLAServersByName(String serverName) Get a List of Servers with Server Name
void	initialize(Map<UUID,Server> silaServers) Initialise SiLA Manager with pre-defined SiLA Servers, e.g.
ServerCallExecutor	newCallExecutor(SiLACall siLACall) Getting SiLA Call Executor from a SiLA Call defining it
void	removeServer(UUID id) Removing Server manually
void	removeSiLAServerListener(SiLAManager.SiLAServerListener siLAServerListener)
void	setServerStatus(UUID id, Server.Status status) Set the Status of a Server
void	startDiscovery() Enable SiLA Discovery
void	startHeartbeat() Start Heartbeat to check Status of Servers
void	stopDiscovery() Disable SiLA Discovery
void	stopHeartbeat() Stop Heartbeat

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static SiLAManager getInstance()

initialize

public void initialize(@NonNull
                       Map<UUID,Server> silaServers)

Initialise SiLA Manager with pre-defined SiLA Servers, e.g. from a persistence layer

Parameters:

silaServers - Map containing all predefined SiLAServers

startDiscovery

public void startDiscovery()

Enable SiLA Discovery

stopDiscovery

public void stopDiscovery()

Disable SiLA Discovery

startHeartbeat

public void startHeartbeat()

Start Heartbeat to check Status of Servers

stopHeartbeat

public void stopHeartbeat()

Stop Heartbeat

addServer

public void addServer(@NonNull
                      String host,
                      int port)

Add Server manually to cache

Parameters:

host - Host on which SiLA Server is exposed

port - Port on which SiLA Server is exposed

removeServer

public void removeServer(@NonNull
                         UUID id)

Removing Server manually

Parameters:

id - Server Id used for referencing to the Server

addServer

public void addServer(@NonNull
                      String host,
                      int port,
                      @Nullable
                      UUID discoveryId)

Add Server to Cache with Discovery Id

Parameters:

host - Host on which SiLA Server is exposed

port - Port on which SiLA Server is exposed

discoveryId - Discovery ID (provided by mDNS)

setServerStatus

public void setServerStatus(@NonNull
                            UUID id,
                            @NonNull
                            Server.Status status)

Set the Status of a Server

Parameters:

id - Server Id

status - Server Status

getSiLAServers

public Map<UUID,Server> getSiLAServers()

Get Map of managed SiLA Servers

getSilaConnections

public Map<UUID,SiLAConnection> getSilaConnections()

Get Map of managed SiLA Connections

getSiLAServersByName

public List<Server> getSiLAServersByName(@NonNull
                                         String serverName)

Get a List of Servers with Server Name

Parameters:

serverName - SiLA Server Name (configurable)

Returns:

List of Servers found

addSiLAServerListener

public void addSiLAServerListener(@Nonnull
                                  SiLAManager.SiLAServerListener siLAServerListener)

Add additional listener to retrieve SiLA Server information in-process

removeSiLAServerListener

public void removeSiLAServerListener(@Nonnull
                                     SiLAManager.SiLAServerListener siLAServerListener)

newCallExecutor

public ServerCallExecutor newCallExecutor(@NonNull
                                          SiLACall siLACall)
                                   throws KeyException

Getting SiLA Call Executor from a SiLA Call defining it

Throws:

KeyException

blockUntilServerFound

public void blockUntilServerFound(@NonNull
                                  String serverName,
                                  int timeOut)
                           throws TimeoutException

Blocking call until online server is found in cache

Parameters:

serverName - SiLA Server Name (configurable)

timeOut - in ms

Throws:

TimeoutException - when the server could not be found within the timeOut period