io.rsocket

Interface SocketAcceptor

public interface SocketAcceptor

RSocket is a full duplex protocol where a client and server are identical in terms of both having the capability to initiate requests to their peer. This interface provides the contract where a client or server handles the setup for a new connection and creates a responder RSocket for accepting requests from the remote peer.

Method Summary

Modifier and Type	Method and Description
Mono<RSocket>	accept(ConnectionSetupPayload setup, RSocket sendingSocket) Handle the SETUP frame for a new connection and create a responder RSocket for handling requests from the remote peer.
static SocketAcceptor	forFireAndForget(Function<Payload,Mono<Void>> handler) Create a SocketAcceptor for fire-and-forget interactions with the given handler.
static SocketAcceptor	forRequestChannel(Function<org.reactivestreams.Publisher<Payload>,Flux<Payload>> handler) Create a SocketAcceptor for request-channel interactions with the given handler.
static SocketAcceptor	forRequestResponse(Function<Payload,Mono<Payload>> handler) Create a SocketAcceptor for request-response interactions with the given handler.
static SocketAcceptor	forRequestStream(Function<Payload,Flux<Payload>> handler) Create a SocketAcceptor for request-stream interactions with the given handler.
static SocketAcceptor	with(RSocket rsocket) Create a SocketAcceptor that handles requests with the given RSocket.

Method Detail

accept

Mono<RSocket> accept(ConnectionSetupPayload setup,
                     RSocket sendingSocket)

Handle the SETUP frame for a new connection and create a responder RSocket for handling requests from the remote peer.

Parameters:

setup - the setup received from a client in a server scenario, or in a client scenario this is the setup about to be sent to the server.

sendingSocket - socket for sending requests to the remote peer.

Returns:

RSocket to accept requests with.

Throws:

SetupException - If the acceptor needs to reject the setup of this socket.

with

static SocketAcceptor with(RSocket rsocket)

Create a SocketAcceptor that handles requests with the given RSocket.

forFireAndForget

static SocketAcceptor forFireAndForget(Function<Payload,Mono<Void>> handler)

Create a SocketAcceptor for fire-and-forget interactions with the given handler.

forRequestResponse

static SocketAcceptor forRequestResponse(Function<Payload,Mono<Payload>> handler)

Create a SocketAcceptor for request-response interactions with the given handler.

forRequestStream

static SocketAcceptor forRequestStream(Function<Payload,Flux<Payload>> handler)

Create a SocketAcceptor for request-stream interactions with the given handler.

forRequestChannel

static SocketAcceptor forRequestChannel(Function<org.reactivestreams.Publisher<Payload>,Flux<Payload>> handler)

Create a SocketAcceptor for request-channel interactions with the given handler.