io.capsisBridgeService

Class CapsisBridgeServiceManager

java.lang.Object

io.capsisBridgeService.CapsisBridgeServiceManager

public class CapsisBridgeServiceManager
extends java.lang.Object

CapsisBridgeServiceManager allows starting and stopping different CapsisBridgeServiceProvider instances as fully independent processes. This is useful when a single client needs sending simulations from different threads to different processes which can be distributed on a single or different hosts. It controls the CapsisBridgeService service exposing its gRPC methods for clients to use.

Since:

2020-12-22

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	version

Constructor Summary

Constructors

Constructor and Description
CapsisBridgeServiceManager(int port, boolean logToFile) Create a CapsisBridge service listening on port.
CapsisBridgeServiceManager(io.grpc.ServerBuilder<?> serverBuilder, int port, boolean logToFile) Create a CapsisBridge server using serverBuilder as a base and features as data.

Method Summary

Modifier and Type	Method and Description
static java.lang.Throwable	GenerateErrorThrowable(java.lang.Exception e) GenerateErrorThrowable method.
static void	main(java.lang.String[] args) Main method.
void	start() Start serving requests.
void	stop() Stop serving requests and shutdown resources.

Methods inherited from class java.lang.Object

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

Field Detail

version

public static final java.lang.String version

See Also:

Constant Field Values

Constructor Detail

CapsisBridgeServiceManager

public CapsisBridgeServiceManager(int port,
                                  boolean logToFile)
                           throws java.lang.Exception

Create a CapsisBridge service listening on port.

Throws:

java.lang.Exception

CapsisBridgeServiceManager

public CapsisBridgeServiceManager(io.grpc.ServerBuilder<?> serverBuilder,
                                  int port,
                                  boolean logToFile)
                           throws java.lang.Exception

Create a CapsisBridge server using serverBuilder as a base and features as data. (used by tests)

Throws:

java.lang.Exception

Method Detail

start

public void start()
           throws java.io.IOException

Start serving requests.

Throws:

java.io.IOException

stop

public void stop()
          throws java.lang.InterruptedException

Stop serving requests and shutdown resources.

Throws:

java.lang.InterruptedException

main

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

Main method. Start with m=xxxx to create a ServiceManager on port xxxx, and with p=xxxx to create a ServiceProvider on port xxxx

Throws:

java.lang.Exception

GenerateErrorThrowable

public static java.lang.Throwable GenerateErrorThrowable(java.lang.Exception e)

GenerateErrorThrowable method. Utility method to encapsulate exception data into a status object to be sent back to the client when an error occurs.