io.kurrentdb.protocol.v2.streams

Class StreamsServiceGrpc.StreamsServiceBlockingV2Stub

java.lang.Object

io.grpc.stub.AbstractStub<S>

io.grpc.stub.AbstractBlockingStub<StreamsServiceGrpc.StreamsServiceBlockingV2Stub>

io.kurrentdb.protocol.v2.streams.StreamsServiceGrpc.StreamsServiceBlockingV2Stub

Enclosing class:

StreamsServiceGrpc

public static final class StreamsServiceGrpc.StreamsServiceBlockingV2Stub
extends io.grpc.stub.AbstractBlockingStub<StreamsServiceGrpc.StreamsServiceBlockingV2Stub>

A stub to allow clients to do synchronous rpc calls to service StreamsService.

Nested Class Summary

Nested classes/interfaces inherited from class io.grpc.stub.AbstractStub

io.grpc.stub.AbstractStub.StubFactory<T extends io.grpc.stub.AbstractStub<T>>

Method Summary

Modifier and Type	Method and Description
io.grpc.stub.BlockingClientCall<AppendRequest,AppendSessionResponse>	appendSession() Appends records to multiple streams atomically within a single transaction.
protected StreamsServiceGrpc.StreamsServiceBlockingV2Stub	build(io.grpc.Channel channel, io.grpc.CallOptions callOptions)

Methods inherited from class io.grpc.stub.AbstractBlockingStub

newStub, newStub

Methods inherited from class io.grpc.stub.AbstractStub

getCallOptions, getChannel, withCallCredentials, withChannel, withCompression, withDeadline, withDeadlineAfter, withDeadlineAfter, withExecutor, withInterceptors, withMaxInboundMessageSize, withMaxOutboundMessageSize, withOnReadyThreshold, withOption, withWaitForReady

Methods inherited from class java.lang.Object

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

Method Detail

build

protected StreamsServiceGrpc.StreamsServiceBlockingV2Stub build(io.grpc.Channel channel,
                                                                io.grpc.CallOptions callOptions)

Specified by:

build in class io.grpc.stub.AbstractStub<StreamsServiceGrpc.StreamsServiceBlockingV2Stub>

appendSession

@ExperimentalApi(value="https://github.com/grpc/grpc-java/issues/10918")
public io.grpc.stub.BlockingClientCall<AppendRequest,AppendSessionResponse> appendSession()

 Appends records to multiple streams atomically within a single transaction.
 This is a client-streaming RPC where the client sends multiple AppendRequest messages
 (one per stream) and receives a single AppendSessionResponse upon commit.
 Guarantees:
 - Atomicity: All writes succeed or all fail together
 - Optimistic Concurrency: Expected revisions are validated for all streams before commit
 - Ordering: Records within each stream maintain send order
 Current Limitations:
 - Each stream can only appear once per session (no multiple appends to same stream)
 Example flow:
   1. Client opens stream
   2. Client sends AppendRequest for stream "orders" with 3 records
   3. Client sends AppendRequest for stream "inventory" with 2 records
   4. Client completes the stream
   5. Server validates, commits, returns AppendSessionResponse with positions