io.kurrentdb.protocol.v2.streams

Class StreamsServiceGrpc.StreamsServiceStub

java.lang.Object

io.grpc.stub.AbstractStub<S>

io.grpc.stub.AbstractAsyncStub<StreamsServiceGrpc.StreamsServiceStub>

io.kurrentdb.protocol.v2.streams.StreamsServiceGrpc.StreamsServiceStub

Enclosing class:

StreamsServiceGrpc

public static final class StreamsServiceGrpc.StreamsServiceStub
extends io.grpc.stub.AbstractAsyncStub<StreamsServiceGrpc.StreamsServiceStub>

A stub to allow clients to do asynchronous 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.StreamObserver<AppendRequest>	appendSession(io.grpc.stub.StreamObserver<AppendSessionResponse> responseObserver) Appends records to multiple streams atomically within a single transaction.
protected StreamsServiceGrpc.StreamsServiceStub	build(io.grpc.Channel channel, io.grpc.CallOptions callOptions)

Methods inherited from class io.grpc.stub.AbstractAsyncStub

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.StreamsServiceStub build(io.grpc.Channel channel,
                                                      io.grpc.CallOptions callOptions)

Specified by:

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

appendSession

public io.grpc.stub.StreamObserver<AppendRequest> appendSession(io.grpc.stub.StreamObserver<AppendSessionResponse> responseObserver)

 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