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 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 featureId) Get a feature service

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 ManagedChannel managedChannel)
           throws sila_java.library.core.sila.mapping.feature.MalformedSiLAFeature

Create a new SiLA Connection

Parameters:

server - Server Description

managedChannel - gRPC Channel to Server

Throws:

sila_java.library.core.sila.mapping.feature.MalformedSiLAFeature - if one of the features is invalid

Connection

public Connection(@NonNull
                  @NonNull Server server,
                  @NonNull
                  @NonNull AutoCloseable closeable)
           throws sila_java.library.core.sila.mapping.feature.MalformedSiLAFeature

Constructor

Parameters:

server - the server

closeable - the cleanup method to call when closing the connection

Throws:

sila_java.library.core.sila.mapping.feature.MalformedSiLAFeature

Method Detail

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 featureId)
                                                                    throws KeyException

Get a feature service

Parameters:

featureId - The 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