io.rsocket.loadbalance

Class LoadbalanceRSocketClient

java.lang.Object

io.rsocket.loadbalance.LoadbalanceRSocketClient

All Implemented Interfaces:

RSocketClient, Disposable

public class LoadbalanceRSocketClient
extends Object
implements RSocketClient

An implementation of RSocketClient backed by a pool of {@code RSocket} instances and using a {@link LoadbalanceStrategy} to select the {@code RSocket} to use for a given request.

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 for a LoadbalanceRSocketClient.
static LoadbalanceRSocketClient	create(RSocketConnector connector, org.reactivestreams.Publisher<List<LoadbalanceTarget>> targetPublisher) Shortcut to create an LoadbalanceRSocketClient with round-robin load balancing.
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 Mono that selects an RSocket from the underlying pool.

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()

Return Mono that selects an RSocket from the underlying pool.

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 load balancing. Effectively a shortcut for:

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

Parameters:

connector - a "template" for connecting to load balance targets

targetPublisher - refreshes the list of load balance targets periodically

Returns:

the created client instance

builder

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

Return a builder for a LoadbalanceRSocketClient.

Parameters:

targetPublisher - refreshes the list of load balance targets periodically

Returns:

the created builder