ai.grakn.client.rpc

Class Transceiver

java.lang.Object

ai.grakn.client.rpc.Transceiver

All Implemented Interfaces:

AutoCloseable

public class Transceiver
extends Object
implements AutoCloseable

Wrapper making transaction calls to the Grakn RPC Server - handles sending a stream of Transaction.Req and receiving a stream of Transaction.Res. A request is sent with the #send(Transaction.Req)} method, and you can block for a response with the receive() method. try (Transceiver tx = Transceiver.create(stub) { tx.send(openMessage); Transaction.Res doneMessage = tx.receive().ok(); tx.send(commitMessage); StatusRuntimeException validationError = tx.receive.error(); }

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Transceiver.Response A response from the gRPC server, that may be a successful response #ok(Transaction.Res), an error {@link #error(StatusRuntimeException)} or a "completed" message Transceiver.Response.completed().

Method Summary

Modifier and Type	Method and Description
void	close()
static Transceiver	create(SessionServiceGrpc.SessionServiceStub stub)
boolean	isClosed()
Transceiver.Response	receive() Block until a response is returned.
void	send(SessionProto.Transaction.Req request) Send a request and return immediately.

Methods inherited from class java.lang.Object

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

Method Detail

create

public static Transceiver create(SessionServiceGrpc.SessionServiceStub stub)

send

public void send(SessionProto.Transaction.Req request)

Send a request and return immediately. This method is non-blocking - it returns immediately.

receive

public Transceiver.Response receive()
                             throws InterruptedException

Block until a response is returned.

Throws:

InterruptedException

close

public void close()

Specified by:

close in interface AutoCloseable

isClosed

public boolean isClosed()