sila_java.library.manager

Class ServerManager

java.lang.Object

sila_java.library.manager.ServerManager

All Implemented Interfaces:

AutoCloseable

public class ServerManager
extends Object
implements AutoCloseable

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.

Method Summary

Modifier and Type	Method and Description
void	addServer(@NonNull String host, int port) Deprecated.
void	addServer(@NonNull String host, int port, String certificate) Add a server into the manager
void	addServerListener(@NonNull ServerListener siLAServerListener) Add additional listener to retrieve SiLA Server information in-process
void	clear() Clear any servers from manager
void	close()
ClientInterceptor	getClientInterceptor() Get client interceptor
Map<UUID,Connection>	getConnections() Get server connections
static ServerManager	getInstance() Create a SiLAManager instance if not already present and returns it.
Map<UUID,Server>	getServers() Get the map of servers
void	initialize(@NonNull Map<UUID,Server> silaServers) Initialise SiLA Manager with pre-defined SiLA Servers, e.g.
void	removeServer(@NonNull UUID id) Removing Server manually
void	removeServerListener(@NonNull ServerListener siLAServerListener) Remove server listener
void	setAllowUnsecureConnection(boolean allowUnsecureConnection)
void	setClientInterceptor(ClientInterceptor clientInterceptor) Set client interceptor
void	setServerName(@NonNull UUID id, @NonNull String newServerName) Set the Status of a Server

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static ServerManager getInstance()

Create a SiLAManager instance if not already present and returns it.

Returns:

The single manager instance

Throws:

RuntimeException - if unable to build SslContext during first call

initialize

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

Initialise SiLA Manager with pre-defined SiLA Servers, e.g. from a persistence layer It will also set the servers status in the map to offline

Parameters:

silaServers - Map containing all predefined SiLAServers

clear

public void clear()

Clear any servers from manager

close

public void close()

Specified by:

close in interface AutoCloseable

setAllowUnsecureConnection

public void setAllowUnsecureConnection(boolean allowUnsecureConnection)

removeServer

public void removeServer(@NonNull
                         @NonNull UUID id)

Removing Server manually

Parameters:

id - Server Id used for referencing to the Server

addServer

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

Deprecated.

Add Server to the manager

Parameters:

host - Host on which SiLA Server is exposed

port - Port on which SiLA Server is exposed

Throws:

ServerConnectionException - if unable to add the server

addServer

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

Add a server into the manager

Parameters:

host - the server host

port - the server port

certificate - the server certificate

Throws:

ServerConnectionException - if the server could not be added

setServerName

public void setServerName(@NonNull
                          @NonNull UUID id,
                          @NonNull
                          @NonNull String newServerName)

Set the Status of a Server

Parameters:

id - Server Id

newServerName - String Server Name

Implementation Note:

serverNameResponse has no response at the moment, as such we proceed assuming the setServerName was successful and catching RcpException at application level alternatively, wrap this function call with try {} catch(RpcException e) {}

getServers

public Map<UUID,Server> getServers()

Get the map of servers

Returns:

A read only map of servers

Implementation Note:

Synchronised call because servers might be in removal state

getConnections

public Map<UUID,Connection> getConnections()

Get server connections

Returns:

the server connections

addServerListener

public void addServerListener(@NonNull
                              @NonNull ServerListener siLAServerListener)

Add additional listener to retrieve SiLA Server information in-process

removeServerListener

public void removeServerListener(@NonNull
                                 @NonNull ServerListener siLAServerListener)

Remove server listener

Parameters:

siLAServerListener - the server listener

getClientInterceptor

public ClientInterceptor getClientInterceptor()

Get client interceptor

Returns:

the client interceptor

setClientInterceptor

public void setClientInterceptor(ClientInterceptor clientInterceptor)

Set client interceptor

Parameters:

clientInterceptor - the client interceptor