Package io.smallrye.reactive.messaging.rabbitmq

Class RabbitMQMessageSender

java.lang.Object

io.smallrye.reactive.messaging.rabbitmq.RabbitMQMessageSender

All Implemented Interfaces:

Flow.Processor<org.eclipse.microprofile.reactive.messaging.Message<?>,org.eclipse.microprofile.reactive.messaging.Message<?>>, Flow.Publisher<org.eclipse.microprofile.reactive.messaging.Message<?>>, Flow.Subscriber<org.eclipse.microprofile.reactive.messaging.Message<?>>, Flow.Subscription

public class RabbitMQMessageSender
extends Object
implements Flow.Processor<org.eclipse.microprofile.reactive.messaging.Message<?>,org.eclipse.microprofile.reactive.messaging.Message<?>>, Flow.Subscription

An implementation of Flow.Processor and Flow.Subscription that is responsible for sending RabbitMQ messages to an external broker.

Constructor Summary

Constructors

Constructor	Description
RabbitMQMessageSender(RabbitMQConnectorOutgoingConfiguration oc, io.smallrye.mutiny.Uni<io.vertx.mutiny.rabbitmq.RabbitMQPublisher> retrieveSender)	Constructor.

Method Summary

Modifier and Type	Method	Description
void	cancel()	Request the Flow.Publisher to stop sending data and clean up resources.
void	onComplete()	Successful terminal state.
void	onError(Throwable t)	Failed terminal state.
void	onNext(org.eclipse.microprofile.reactive.messaging.Message<?> message)	Data notification sent by the Flow.Publisher in response to requests to Flow.Subscription.request(long).
void	onSubscribe(Flow.Subscription subscription)	Invoked after calling Flow.Publisher.subscribe(Subscriber).
void	request(long l)	No events will be sent by a Flow.Publisher until demand is signaled via this method.
void	subscribe(Flow.Subscriber<? super org.eclipse.microprofile.reactive.messaging.Message<?>> subscriber)	Request Flow.Publisher to start streaming data.

Methods inherited from class java.lang.Object

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

Constructor Details

RabbitMQMessageSender

public RabbitMQMessageSender(RabbitMQConnectorOutgoingConfiguration oc,
 io.smallrye.mutiny.Uni<io.vertx.mutiny.rabbitmq.RabbitMQPublisher> retrieveSender)

Constructor.

Parameters:

oc - the configuration parameters for outgoing messages

retrieveSender - the underlying Vert.x RabbitMQPublisher

Method Details

subscribe

public void subscribe(Flow.Subscriber<? super org.eclipse.microprofile.reactive.messaging.Message<?>> subscriber)

Request Flow.Publisher to start streaming data.

This is a "factory method" and can be called multiple times, each time starting a new Flow.Subscription.

Each Flow.Subscription will work for only a single Flow.Subscriber.

A Flow.Subscriber should only subscribe once to a single Flow.Publisher.

If the Flow.Publisher rejects the subscription attempt or otherwise fails it will signal the error via Flow.Subscriber.onError(java.lang.Throwable).

Specified by:

subscribe in interface Flow.Publisher<org.eclipse.microprofile.reactive.messaging.Message<?>>

Parameters:

subscriber - the Flow.Subscriber that will consume signals from this Flow.Publisher

onSubscribe

public void onSubscribe(Flow.Subscription subscription)

Invoked after calling Flow.Publisher.subscribe(Subscriber).

No data will start flowing until Flow.Subscription.request(long) is invoked.

It is the responsibility of this Flow.Subscriber instance to call Flow.Subscription.request(long) whenever more data is wanted.

The Flow.Publisher will send notifications only in response to Flow.Subscription.request(long).

Specified by:

onSubscribe in interface Flow.Subscriber<org.eclipse.microprofile.reactive.messaging.Message<?>>

Parameters:

subscription - Flow.Subscription that allows requesting data via Flow.Subscription.request(long)

onNext

public void onNext(org.eclipse.microprofile.reactive.messaging.Message<?> message)

Data notification sent by the Flow.Publisher in response to requests to Flow.Subscription.request(long).

Specified by:

onNext in interface Flow.Subscriber<org.eclipse.microprofile.reactive.messaging.Message<?>>

Parameters:

message - the element signaled

onError

public void onError(Throwable t)

Failed terminal state.

No further events will be sent even if Flow.Subscription.request(long) is invoked again.

Specified by:

onError in interface Flow.Subscriber<org.eclipse.microprofile.reactive.messaging.Message<?>>

Parameters:

t - the throwable signaled

onComplete

public void onComplete()

Successful terminal state.

No further events will be sent even if Flow.Subscription.request(long) is invoked again.

Specified by:

onComplete in interface Flow.Subscriber<org.eclipse.microprofile.reactive.messaging.Message<?>>

request

public void request(long l)

No events will be sent by a Flow.Publisher until demand is signaled via this method.

It can be called however often and whenever needed—but if the outstanding cumulative demand ever becomes Long.MAX_VALUE or more, it may be treated by the Flow.Publisher as "effectively unbounded".

Whatever has been requested can be sent by the Flow.Publisher so only signal demand for what can be safely handled.

A Flow.Publisher can send less than is requested if the stream ends but then must emit either Flow.Subscriber.onError(Throwable) or Flow.Subscriber.onComplete().

Note that this method is expected to be called only once on a given sender.

Specified by:

request in interface Flow.Subscription

Parameters:

l - the strictly positive number of elements to requests to the upstream Flow.Publisher

cancel

public void cancel()

Request the Flow.Publisher to stop sending data and clean up resources.

Data may still be sent to meet previously signalled demand after calling cancel.

Specified by:

cancel in interface Flow.Subscription