RabbitSource

Creates an op-rabbit consumer whose messages are delivered through an AckedSource. Message order guarantees are maintained.

IMPORTANT NOTE ON ACKNOWLEDGED MESSAGES

(if you are seeing unacknowledged messages accumulated, followed by the stream progress halting, you will want to pay special attention to this)

The 'Acked' variety of streams provide type-safe guarantees that acknowledgments aren't dropped on the floor. Filtering a message from the stream (via collect, filter, or mapConcat -> Nil), for example, will cause the incomming RabbitMQ message to be acknowledged.

If you begin constructing your own Acked components and interacting with the AckTup[T] type directly (or, (Promise[Unit], T)), you must take caution that the promise is not dropped on the floor. This means, every time an exception could be thrown, you must catch it and propagate said exception to the Promise by calling promise.fail(ex).

If you integrate with a stream compoment that does not support acknowledged streams, you will probably want to acknowledge the message before sending messages to it (by using the .acked acked-stream operation). If it is important that you acknowledge messages after the flow is complete, and the library doesn't provide a reliable way to propagate element exceptions, you will likely want exception to crash the stream (IE: don't resume the stream on exception). Otherwise, if using a resuming decider, you risk elements being dropped and unacknowledged messages accumulating.

Example:

import com.spingo.op_rabbit.Directives._
RabbitSource(
  rabbitControl,
  channel(qos = 3),
  consume(queue("such-queue", durable = true, exclusive = false, autoDelete = false)),
  body(as[Person])).
  runForeach { person =>
    greet(person)
  } // after each successful iteration the message is acknowledged.

Linear Supertypes

AnyRef, Any

Value Members

final def !=(arg0: Any): Boolean

Definition Classes
AnyRef → Any
final def ##(): Int

Definition Classes
AnyRef → Any
final def ==(arg0: Any): Boolean

Definition Classes
AnyRef → Any
def apply[L <: HList](rabbitControl: ActorRef, channelDirective: ChannelDirective, bindingDirective: BindingDirective, handler: Directive[L])(implicit tupler: HListToValueOrTuple[L], errorReporting: RabbitErrorLogging, recoveryStrategy: RecoveryStrategy): AckedSource[Out, SubscriptionRef]

rabbitControl
Op-rabbit management ActorRef
channelDirective
An unbound ChannelDirective
bindingDirective
An unbound BindingDirective; informs the stream from which queue it should pull messages.
handler
A Directive, either simple or compound, describing how the elements passed into the stream are to be formed.
final def asInstanceOf[T0]: T0

Definition Classes
Any
def clone(): AnyRef

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( ... )
final def eq(arg0: AnyRef): Boolean

Definition Classes
AnyRef
def equals(arg0: Any): Boolean

Definition Classes
AnyRef → Any
def finalize(): Unit

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( classOf[java.lang.Throwable] )
final def getClass(): Class[_]

Definition Classes
AnyRef → Any
def hashCode(): Int

Definition Classes
AnyRef → Any
final def isInstanceOf[T0]: Boolean

Definition Classes
Any
final def ne(arg0: AnyRef): Boolean

Definition Classes
AnyRef
final def notify(): Unit

Definition Classes
AnyRef
final def notifyAll(): Unit

Definition Classes
AnyRef
final def synchronized[T0](arg0: ⇒ T0): T0

Definition Classes
AnyRef
def toString(): String

Definition Classes
AnyRef → Any
final def wait(): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
final def wait(arg0: Long, arg1: Int): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
final def wait(arg0: Long): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )

Related Doc: package stream

object RabbitSource

Value Members

final def !=(arg0: Any): Boolean

final def ##(): Int

final def ==(arg0: Any): Boolean

def apply[L <: HList](rabbitControl: ActorRef, channelDirective: ChannelDirective, bindingDirective: BindingDirective, handler: Directive[L])(implicit tupler: HListToValueOrTuple[L], errorReporting: RabbitErrorLogging, recoveryStrategy: RecoveryStrategy): AckedSource[Out, SubscriptionRef]

final def asInstanceOf[T0]: T0

def clone(): AnyRef

final def eq(arg0: AnyRef): Boolean

def equals(arg0: Any): Boolean

def finalize(): Unit

final def getClass(): Class[_]

def hashCode(): Int

final def isInstanceOf[T0]: Boolean

final def ne(arg0: AnyRef): Boolean

final def notify(): Unit

final def notifyAll(): Unit

final def synchronized[T0](arg0: ⇒ T0): T0

def toString(): String

final def wait(): Unit

final def wait(arg0: Long, arg1: Int): Unit

final def wait(arg0: Long): Unit

Inherited from AnyRef

Inherited from Any

Ungrouped