io.rsocket.loadbalance

Class LoadbalanceRSocketClient

java.lang.Object

io.rsocket.loadbalance.LoadbalanceRSocketClient

All Implemented Interfaces:

RSocketClient, Disposable

public class LoadbalanceRSocketClient
extends Object
implements RSocketClient

RSocketClient implementation that uses a LoadbalanceStrategy to select the RSocket to use for a given request from a pool of possible targets.

Since:

1.1

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LoadbalanceRSocketClient.Builder Builder for creating an LoadbalanceRSocketClient.

Nested classes/interfaces inherited from interface reactor.core.Disposable

Disposable.Composite, Disposable.Swap

Method Summary

Modifier and Type	Method and Description
static LoadbalanceRSocketClient.Builder	builder(org.reactivestreams.Publisher<List<LoadbalanceTarget>> targetPublisher) Return a builder to create an LoadbalanceRSocketClient with.
static LoadbalanceRSocketClient	create(RSocketConnector connector, org.reactivestreams.Publisher<List<LoadbalanceTarget>> targetPublisher) Shortcut to create an LoadbalanceRSocketClient with round robin loadalancing.
void	dispose()
Mono<Void>	fireAndForget(Mono<Payload> payloadMono) Perform a Fire-and-Forget interaction via RSocket.fireAndForget(Payload).
Mono<Void>	metadataPush(Mono<Payload> payloadMono) Perform a Metadata Push via RSocket.metadataPush(Payload).
Flux<Payload>	requestChannel(org.reactivestreams.Publisher<Payload> payloads) Perform a Request-Channel interaction via RSocket.requestChannel(Publisher).
Mono<Payload>	requestResponse(Mono<Payload> payloadMono) Perform a Request-Response interaction via RSocket.requestResponse(Payload).
Flux<Payload>	requestStream(Mono<Payload> payloadMono) Perform a Request-Stream interaction via RSocket.requestStream(Payload).
Mono<RSocket>	source() Return the underlying source used to obtain a shared RSocket connection.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.rsocket.core.RSocketClient

from, from

Methods inherited from interface reactor.core.Disposable

isDisposed

Method Detail

source

public Mono<RSocket> source()

Description copied from interface: RSocketClient

Return the underlying source used to obtain a shared RSocket connection.

Specified by:

source in interface RSocketClient

fireAndForget

public Mono<Void> fireAndForget(Mono<Payload> payloadMono)

Description copied from interface: RSocketClient

Perform a Fire-and-Forget interaction via RSocket.fireAndForget(Payload). Allows multiple subscriptions and performs a request per subscriber.

Specified by:

fireAndForget in interface RSocketClient

requestResponse

public Mono<Payload> requestResponse(Mono<Payload> payloadMono)

Description copied from interface: RSocketClient

Perform a Request-Response interaction via RSocket.requestResponse(Payload). Allows multiple subscriptions and performs a request per subscriber.

Specified by:

requestResponse in interface RSocketClient

requestStream

public Flux<Payload> requestStream(Mono<Payload> payloadMono)

Description copied from interface: RSocketClient

Perform a Request-Stream interaction via RSocket.requestStream(Payload). Allows multiple subscriptions and performs a request per subscriber.

Specified by:

requestStream in interface RSocketClient

requestChannel

public Flux<Payload> requestChannel(org.reactivestreams.Publisher<Payload> payloads)

Description copied from interface: RSocketClient

Perform a Request-Channel interaction via RSocket.requestChannel(Publisher). Allows multiple subscriptions and performs a request per subscriber.

Specified by:

requestChannel in interface RSocketClient

metadataPush

public Mono<Void> metadataPush(Mono<Payload> payloadMono)

Description copied from interface: RSocketClient

Perform a Metadata Push via RSocket.metadataPush(Payload). Allows multiple subscriptions and performs a request per subscriber.

Specified by:

metadataPush in interface RSocketClient

dispose

public void dispose()

Specified by:

dispose in interface Disposable

create

public static LoadbalanceRSocketClient create(RSocketConnector connector,
                                              org.reactivestreams.Publisher<List<LoadbalanceTarget>> targetPublisher)

Shortcut to create an LoadbalanceRSocketClient with round robin loadalancing. Effectively a shortcut for:

 LoadbalanceRSocketClient.builder(targetPublisher)
    .connector(RSocketConnector.create())
    .build();
 

Parameters:

connector - the {@link Builder#connector(RSocketConnector) to use

targetPublisher - publisher that periodically refreshes the list of targets to loadbalance across.

Returns:

the created client instance

builder

public static LoadbalanceRSocketClient.Builder builder(org.reactivestreams.Publisher<List<LoadbalanceTarget>> targetPublisher)

Return a builder to create an LoadbalanceRSocketClient with.

Parameters:

targetPublisher - publisher that periodically refreshes the list of targets to loadbalance across.

Returns:

the builder instance