Package io.camunda.zeebe.broker.transport

Class AsyncApiRequestHandler<R extends AsyncApiRequestHandler.RequestReader<?>,W extends AsyncApiRequestHandler.ResponseWriter>

java.lang.Object

io.camunda.zeebe.scheduler.Actor

io.camunda.zeebe.broker.transport.AsyncApiRequestHandler<R,W>

Type Parameters:

R - a AsyncApiRequestHandler.RequestReader that reads the request

W - a AsyncApiRequestHandler.ResponseWriter that writes the response

All Implemented Interfaces:

AsyncClosable, ConcurrencyControl, RequestHandler, AutoCloseable

Direct Known Subclasses:

AdminApiRequestHandler, BackupApiRequestHandler, QueryApiRequestHandler

public abstract class AsyncApiRequestHandler<R extends AsyncApiRequestHandler.RequestReader<?>,W extends AsyncApiRequestHandler.ResponseWriter>
extends Actor
implements RequestHandler

A RequestHandler that automatically decodes requests and encodes successful and error responses. Handling requests is asynchronous.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	AsyncApiRequestHandler.RequestReader<T extends org.agrona.sbe.MessageDecoderFlyweight>	Extension of BufferReader that provides extra methods used by AsyncApiRequestHandler implementations.
static interface	AsyncApiRequestHandler.ResponseWriter	Extension of BufferWriter that provides extra methods used by AsyncApiRequestHandler implementations

Nested classes/interfaces inherited from class io.camunda.zeebe.scheduler.Actor

Actor.ActorBuilder

Field Summary

Fields

Modifier and Type	Field	Description
static final org.slf4j.Logger	LOG

Fields inherited from class io.camunda.zeebe.scheduler.Actor

actor, ACTOR_PROP_NAME, ACTOR_PROP_PARTITION_ID

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AsyncApiRequestHandler(Supplier<R> requestReaderSupplier, Supplier<W> responseWriterSupplier)

Method Summary

Modifier and Type	Method	Description
protected abstract ActorFuture<Either<ErrorResponseWriter,W>>	handleAsync(int partitionId, long requestId, R requestReader, W responseWriter, ErrorResponseWriter errorWriter)	Handles a request.
final void	onRequest(ServerOutput serverOutput, int partitionId, long requestId, org.agrona.DirectBuffer buffer, int offset, int length)

Methods inherited from class io.camunda.zeebe.scheduler.Actor

buildActorName, close, closeAsync, createContext, getContext, getName, handleFailure, isActorClosed, newActor, onActorClosed, onActorCloseRequested, onActorClosing, onActorFailed, onActorStarted, onActorStarting, run, runOnCompletion, wrap

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.camunda.zeebe.scheduler.ConcurrencyControl

createCompletedFuture, createFuture

Field Details

LOG

public static final org.slf4j.Logger LOG

Constructor Details

AsyncApiRequestHandler

protected AsyncApiRequestHandler(Supplier<R> requestReaderSupplier,
 Supplier<W> responseWriterSupplier)

Method Details

handleAsync

protected abstract ActorFuture<Either<ErrorResponseWriter,W>> handleAsync(int partitionId,
 long requestId,
 R requestReader,
 W responseWriter,
 ErrorResponseWriter errorWriter)

Handles a request. The is populated at this point.

Parameters:

partitionId - the current partition id

requestId - the current request id

requestReader - a reader that is already populated with the request data

responseWriter - a writer that can be used to write successful responses

errorWriter - a ErrorResponseWriter that can be used to write error responses

Returns:

a ErrorResponseWriter when the handling failed, or a ResponseWriter when the handling was successful. Writes to the other writer will be ignored and are not sent as a response.

onRequest

public final void onRequest(ServerOutput serverOutput,
 int partitionId,
 long requestId,
 org.agrona.DirectBuffer buffer,
 int offset,
 int length)

Specified by:

onRequest in interface RequestHandler