class CallingThreadDispatcher extends MessageDispatcher

Dispatcher which runs invocations on the current thread only. This dispatcher does not create any new threads, but it can be used from different threads concurrently for the same actor. The dispatch strategy is to run on the current thread unless the target actor is either suspendSwitch or already running on the current thread (if it is running on a different thread, then this thread will block until that other invocation is finished); if the invocation is not run, it is queued in a thread-local queue to be executed once the active invocation further up the call stack finishes. This leads to completely deterministic execution order if only one thread is used.

Suspending and resuming are global actions for one actor, meaning they can affect different threads, which leads to complications. If messages are queued (thread-locally) during the suspendSwitch period, the only thread to run them upon resume is the thread actually calling the resume method. Hence, all thread-local queues which are not currently being drained (possible, since suspend-queue-resume might happen entirely during an invocation on a different thread) are scooped up into the current thread-local queue which is then executed. It is possible to suspend an actor from within its call stack.

Source
CallingThreadDispatcher.scala
Since

1.1

Linear Supertypes
MessageDispatcher, ExecutionContextExecutor, ExecutionContext, BatchingExecutor, Executor, AbstractMessageDispatcher, AnyRef, Any
Type Hierarchy
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. CallingThreadDispatcher
  2. MessageDispatcher
  3. ExecutionContextExecutor
  4. ExecutionContext
  5. BatchingExecutor
  6. Executor
  7. AbstractMessageDispatcher
  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. All

Instance Constructors

  1. new CallingThreadDispatcher(_configurator: MessageDispatcherConfigurator)

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 CallingThreadDispatcher to any2stringadd[CallingThreadDispatcher] performed by method any2stringadd in scala.Predef.
    Definition Classes
    any2stringadd
  4. def ->[B](y: B): (CallingThreadDispatcher, B)
    Implicit
    This member is added by an implicit conversion from CallingThreadDispatcher to ArrowAssoc[CallingThreadDispatcher] 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. final def attach(actor: ActorCell): Unit
    Definition Classes
    MessageDispatcher
  8. def batchable(runnable: Runnable): Boolean
    Definition Classes
    BatchingExecutor
  9. def clone(): AnyRef
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @native() @HotSpotIntrinsicCandidate() @throws( ... )
  10. val configurator: MessageDispatcherConfigurator
    Definition Classes
    MessageDispatcher
  11. def createMailbox(actor: Cell, mailboxType: MailboxType): CallingThreadMailbox
    Attributes
    protected[akka]
    Definition Classes
    CallingThreadDispatcher → MessageDispatcher
  12. final def detach(actor: ActorCell): Unit
    Definition Classes
    MessageDispatcher
  13. def dispatch(receiver: ActorCell, handle: Envelope): Unit
    Attributes
    protected[akka]
    Definition Classes
    CallingThreadDispatcher → MessageDispatcher
  14. def ensuring(cond: (CallingThreadDispatcher) ⇒ Boolean, msg: ⇒ Any): CallingThreadDispatcher
    Implicit
    This member is added by an implicit conversion from CallingThreadDispatcher to Ensuring[CallingThreadDispatcher] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  15. def ensuring(cond: (CallingThreadDispatcher) ⇒ Boolean): CallingThreadDispatcher
    Implicit
    This member is added by an implicit conversion from CallingThreadDispatcher to Ensuring[CallingThreadDispatcher] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  16. def ensuring(cond: Boolean, msg: ⇒ Any): CallingThreadDispatcher
    Implicit
    This member is added by an implicit conversion from CallingThreadDispatcher to Ensuring[CallingThreadDispatcher] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  17. def ensuring(cond: Boolean): CallingThreadDispatcher
    Implicit
    This member is added by an implicit conversion from CallingThreadDispatcher to Ensuring[CallingThreadDispatcher] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  18. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  19. def equals(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  20. val eventStream: EventStream
    Definition Classes
    MessageDispatcher
  21. def execute(runnable: Runnable): Unit
    Definition Classes
    BatchingExecutor → Executor
  22. def executeTask(invocation: TaskInvocation): Unit
    Attributes
    protected[akka]
    Definition Classes
    CallingThreadDispatcher → MessageDispatcher
  23. def formatted(fmtstr: String): String
    Implicit
    This member is added by an implicit conversion from CallingThreadDispatcher to StringFormat[CallingThreadDispatcher] performed by method StringFormat in scala.Predef.
    Definition Classes
    StringFormat
    Annotations
    @inline()
  24. final def getClass(): Class[_]
    Definition Classes
    AnyRef → Any
    Annotations
    @native() @HotSpotIntrinsicCandidate()
  25. def hashCode(): Int
    Definition Classes
    AnyRef → Any
    Annotations
    @native() @HotSpotIntrinsicCandidate()
  26. def id: String
    Definition Classes
    CallingThreadDispatcher → MessageDispatcher
  27. final def inhabitants: Long
    Definition Classes
    MessageDispatcher
  28. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  29. final val isThroughputDeadlineTimeDefined: Boolean
    Attributes
    protected[akka]
    Definition Classes
    MessageDispatcher
  30. val log: LoggingAdapter
  31. val mailboxes: Mailboxes
    Definition Classes
    MessageDispatcher
  32. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  33. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native() @HotSpotIntrinsicCandidate()
  34. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native() @HotSpotIntrinsicCandidate()
  35. def register(actor: ActorCell): Unit
    Attributes
    protected[akka]
    Definition Classes
    CallingThreadDispatcher → MessageDispatcher
  36. def registerForExecution(mbox: Mailbox, hasMessageHint: Boolean, hasSystemMessageHint: Boolean): Boolean
    Attributes
    protected[akka]
    Definition Classes
    CallingThreadDispatcher → MessageDispatcher
  37. def reportFailure(t: Throwable): Unit
    Definition Classes
    MessageDispatcher → ExecutionContext
  38. final def resubmitOnBlock: Boolean
    Attributes
    protected
    Definition Classes
    MessageDispatcher → BatchingExecutor
  39. def resume(actor: ActorCell): Unit
    Attributes
    protected[akka]
    Definition Classes
    CallingThreadDispatcher → MessageDispatcher
  40. def shutdown(): Unit
    Attributes
    protected[akka]
    Definition Classes
    CallingThreadDispatcher → MessageDispatcher
  41. def shutdownTimeout: FiniteDuration
    Attributes
    protected[akka]
    Definition Classes
    CallingThreadDispatcher → MessageDispatcher
  42. def suspend(actor: ActorCell): Unit
    Attributes
    protected[akka]
    Definition Classes
    CallingThreadDispatcher → MessageDispatcher
  43. final def synchronized[T0](arg0: ⇒ T0): T0
    Definition Classes
    AnyRef
  44. def systemDispatch(receiver: ActorCell, message: SystemMessage): Unit
    Attributes
    protected[akka]
    Definition Classes
    CallingThreadDispatcher → MessageDispatcher
  45. def throughput: Int
    Attributes
    protected[akka]
    Definition Classes
    CallingThreadDispatcher → MessageDispatcher
  46. def throughputDeadlineTime: FiniteDuration
    Attributes
    protected[akka]
    Definition Classes
    CallingThreadDispatcher → MessageDispatcher
  47. def toString(): String
    Definition Classes
    AnyRef → Any
  48. final def unbatchedExecute(r: Runnable): Unit
    Attributes
    protected
    Definition Classes
    MessageDispatcher → BatchingExecutor
  49. def unregister(actor: ActorCell): Unit
    Attributes
    protected[akka]
    Definition Classes
    CallingThreadDispatcher → MessageDispatcher
  50. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  51. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @native() @throws( ... )
  52. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  53. def →[B](y: B): (CallingThreadDispatcher, B)
    Implicit
    This member is added by an implicit conversion from CallingThreadDispatcher to ArrowAssoc[CallingThreadDispatcher] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc

Deprecated Value Members

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

    (Since version ) see corresponding Javadoc for more information.

  2. def prepare(): ExecutionContext
    Definition Classes
    ExecutionContext
    Annotations
    @deprecated
    Deprecated

    (Since version 2.12.0) preparation of ExecutionContexts will be removed

Inherited from MessageDispatcher

Inherited from ExecutionContextExecutor

Inherited from ExecutionContext

Inherited from BatchingExecutor

Inherited from Executor

Inherited from AbstractMessageDispatcher

Inherited from AnyRef

Inherited from Any

Inherited by implicit conversion any2stringadd from CallingThreadDispatcher to any2stringadd[CallingThreadDispatcher]

Inherited by implicit conversion StringFormat from CallingThreadDispatcher to StringFormat[CallingThreadDispatcher]

Inherited by implicit conversion Ensuring from CallingThreadDispatcher to Ensuring[CallingThreadDispatcher]

Inherited by implicit conversion ArrowAssoc from CallingThreadDispatcher to ArrowAssoc[CallingThreadDispatcher]

Ungrouped