Packages

  • package root
    Definition Classes
    root
  • package akka
    Definition Classes
    root
  • package actor
    Definition Classes
    akka
  • package typed
    Definition Classes
    actor
  • package delivery
    Definition Classes
    typed
  • package internal
    Definition Classes
    delivery
  • object ProducerControllerImpl

    INTERNAL API

    INTERNAL API

    Design notes

    The producer will start the flow by sending a ProducerController.Start message to the ProducerController with message adapter reference to convert ProducerController.RequestNext message. The ProducerController sends RequestNext to the producer, which is then allowed to send one message to the ProducerController.

    The producer and ProducerController are supposed to be local so that these messages are fast and not lost.

    The ProducerController sends the first message to the ConsumerController without waiting for a Request from the ConsumerController. The main reason for this is that when used with Cluster Sharding the first message will typically create the ConsumerController. It's also a way to connect the ProducerController and ConsumerController in a dynamic way, for example when the ProducerController is replaced.

    When the first message is received by the ConsumerController it sends back the initial Request, with demand of how many messages it can accept.

    Apart from the first message the ProducerController will not send more messages than requested by the ConsumerController.

    When there is demand from the consumer side the ProducerController sends RequestNext to the actual producer, which is then allowed to send one more message.

    Each message is wrapped by the ProducerController in ConsumerController.SequencedMessage with a monotonically increasing sequence number without gaps, starting at 1.

    In other words, the "request" protocol to the application producer and consumer is one-by-one, but between the ProducerController and ConsumerController it's window of messages in flight.

    The Request message also contains a confirmedSeqNr that is the acknowledgement from the consumer that it has received and processed all messages up to that sequence number.

    The ConsumerController will send ProducerControllerImpl.Resend if a lost message is detected and then the ProducerController will resend all messages from that sequence number. The producer keeps unconfirmed messages in a buffer to be able to resend them. The buffer size is limited by the request window size.

    The resending is optional, and the ConsumerController can be started with resendLost=false to ignore lost messages, and then the ProducerController will not buffer unconfirmed messages. In that mode it provides only flow control but no reliable delivery.

    Definition Classes
    internal
  • Ack
  • InternalCommand
  • Request
  • Resend
  • ResendFirstUnconfirmed
  • UnsealedInternalCommand

final case class Request(confirmedSeqNr: SeqNr, requestUpToSeqNr: SeqNr, supportResend: Boolean, viaTimeout: Boolean) extends InternalCommand with DeliverySerializable with DeadLetterSuppression with Product with Serializable

Source
ProducerControllerImpl.scala
Linear Supertypes
Type Hierarchy
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. Request
  2. Serializable
  3. Product
  4. Equals
  5. DeadLetterSuppression
  6. DeliverySerializable
  7. InternalCommand
  8. AnyRef
  9. Any
Implicitly
  1. by any2stringadd
  2. by StringFormat
  3. by Ensuring
  4. by ArrowAssoc
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Instance Constructors

  1. new Request(confirmedSeqNr: SeqNr, requestUpToSeqNr: SeqNr, supportResend: Boolean, viaTimeout: Boolean)

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##: Int
    Definition Classes
    AnyRef → Any
  3. def +(other: String): String
    Implicit
    This member is added by an implicit conversion from Request toany2stringadd[Request] performed by method any2stringadd in scala.Predef.
    Definition Classes
    any2stringadd
  4. def ->[B](y: B): (Request, B)
    Implicit
    This member is added by an implicit conversion from Request toArrowAssoc[Request] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @inline()
  5. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  6. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  7. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.CloneNotSupportedException]) @HotSpotIntrinsicCandidate() @native()
  8. val confirmedSeqNr: SeqNr
  9. def ensuring(cond: (Request) => Boolean, msg: => Any): Request
    Implicit
    This member is added by an implicit conversion from Request toEnsuring[Request] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  10. def ensuring(cond: (Request) => Boolean): Request
    Implicit
    This member is added by an implicit conversion from Request toEnsuring[Request] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  11. def ensuring(cond: Boolean, msg: => Any): Request
    Implicit
    This member is added by an implicit conversion from Request toEnsuring[Request] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  12. def ensuring(cond: Boolean): Request
    Implicit
    This member is added by an implicit conversion from Request toEnsuring[Request] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  13. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  14. final def getClass(): Class[_ <: AnyRef]
    Definition Classes
    AnyRef → Any
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  15. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  16. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  17. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  18. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  19. def productElementNames: Iterator[String]
    Definition Classes
    Product
  20. val requestUpToSeqNr: SeqNr
  21. val supportResend: Boolean
  22. final def synchronized[T0](arg0: => T0): T0
    Definition Classes
    AnyRef
  23. val viaTimeout: Boolean
  24. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  25. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException]) @native()
  26. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])

Deprecated Value Members

  1. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.Throwable]) @Deprecated
    Deprecated

    (Since version 9)

  2. def formatted(fmtstr: String): String
    Implicit
    This member is added by an implicit conversion from Request toStringFormat[Request] performed by method StringFormat in scala.Predef.
    Definition Classes
    StringFormat
    Annotations
    @deprecated @inline()
    Deprecated

    (Since version 2.12.16) Use formatString.format(value) instead of value.formatted(formatString), or use the f"" string interpolator. In Java 15 and later, formatted resolves to the new method in String which has reversed parameters.

  3. def [B](y: B): (Request, B)
    Implicit
    This member is added by an implicit conversion from Request toArrowAssoc[Request] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @deprecated
    Deprecated

    (Since version 2.13.0) Use -> instead. If you still wish to display it as one character, consider using a font with programming ligatures such as Fira Code.

Inherited from Serializable

Inherited from Product

Inherited from Equals

Inherited from DeadLetterSuppression

Inherited from DeliverySerializable

Inherited from InternalCommand

Inherited from AnyRef

Inherited from Any

Inherited by implicit conversion any2stringadd fromRequest to any2stringadd[Request]

Inherited by implicit conversion StringFormat fromRequest to StringFormat[Request]

Inherited by implicit conversion Ensuring fromRequest to Ensuring[Request]

Inherited by implicit conversion ArrowAssoc fromRequest to ArrowAssoc[Request]

Ungrouped