sila_java.library.manager.server_management

Class Connection

java.lang.Object

sila_java.library.manager.server_management.Connection

All Implemented Interfaces:

AutoCloseable

public class Connection
extends Object
implements AutoCloseable

Represent a SiLA compliant connection with a server that exposes features callable through a channel

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Connection.ConnectionListener Connection Listener interface

Constructor Summary

Constructors

Constructor and Description
Connection(@NonNull Server server, @NonNull AutoCloseable closeable) Constructor
Connection(@NonNull Server server, @NonNull io.grpc.ManagedChannel managedChannel) Create a new SiLA Connection

Method Summary

Modifier and Type	Method and Description
void	attachAndTriggerListener(@NonNull Connection.ConnectionListener connectionListener)
void	close()
com.google.protobuf.Descriptors.ServiceDescriptor	getFeatureService(@NonNull String fullyQualifiedFeatureId) Get a feature service
void	loadFeaturesFromServer(Server server) Convert and validate the server features into Descriptors.FileDescriptor and save them in fileDescriptorMap and featureMap

Methods inherited from class java.lang.Object

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

Constructor Detail

Connection

public Connection(@NonNull
                  @NonNull Server server,
                  @NonNull
                  @NonNull io.grpc.ManagedChannel managedChannel)
           throws MalformedSiLAFeature

Create a new SiLA Connection

Parameters:

server - Server Description

managedChannel - gRPC Channel to Server

Throws:

MalformedSiLAFeature - if one of the features is invalid

Connection

public Connection(@NonNull
                  @NonNull Server server,
                  @NonNull
                  @NonNull AutoCloseable closeable)
           throws MalformedSiLAFeature

Constructor

Parameters:

server - the server

closeable - the cleanup method to call when closing the connection

Throws:

MalformedSiLAFeature

Method Detail

loadFeaturesFromServer

public void loadFeaturesFromServer(Server server)
                            throws MalformedSiLAFeature

Convert and validate the server features into Descriptors.FileDescriptor and save them in fileDescriptorMap and featureMap

Parameters:

server - the server

Throws:

MalformedSiLAFeature - if a feature is malformed

attachAndTriggerListener

public void attachAndTriggerListener(@NonNull
                                     @NonNull Connection.ConnectionListener connectionListener)

Parameters:

connectionListener - Listeners to changes in the connection

getFeatureService

public com.google.protobuf.Descriptors.ServiceDescriptor getFeatureService(@NonNull
                                                                           @NonNull String fullyQualifiedFeatureId)
                                                                    throws KeyException

Get a feature service

Parameters:

fullyQualifiedFeatureId - The fully qualified feature identifier

Returns:

The matching feature service

Throws:

KeyException - when no identifier does not match any feature

close

public void close()

Specified by:

close in interface AutoCloseable