c

akka.testkit

ExplicitlyTriggeredScheduler

class ExplicitlyTriggeredScheduler extends Scheduler

For testing: scheduler that does not look at the clock, but must be progressed manually by calling timePasses.

This allows for faster and less timing-sensitive specs, as jobs will be executed on the test thread instead of using the original {ExecutionContext}. This means recreating specific scenario's becomes easier, but these tests might fail to catch race conditions that only happen when tasks are scheduled in parallel in 'real time'.

Source
ExplicitlyTriggeredScheduler.scala
Linear Supertypes
Scheduler, AnyRef, Any
Type Hierarchy
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. ExplicitlyTriggeredScheduler
  2. Scheduler
  3. AnyRef
  4. 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 ExplicitlyTriggeredScheduler(config: Config, log: LoggingAdapter, tf: ThreadFactory)

Value Members

  1. def maxFrequency: Double

    The maximum supported task frequency of this scheduler, i.e.

    The maximum supported task frequency of this scheduler, i.e. the inverse of the minimum time interval between executions of a recurring task, in Hz.

    Definition Classes
    ExplicitlyTriggeredScheduler → Scheduler
  2. def schedule(initialDelay: FiniteDuration, interval: FiniteDuration, runnable: Runnable)(implicit executor: ExecutionContext): Cancellable

    Schedules a Runnable to be run repeatedly with an initial delay and a frequency.

    Schedules a Runnable to be run repeatedly with an initial delay and a frequency. E.g. if you would like the function to be run after 2 seconds and thereafter every 100ms you would set delay = Duration(2, TimeUnit.SECONDS) and interval = Duration(100, TimeUnit.MILLISECONDS). If the execution of the runnable takes longer than the interval, the subsequent execution will start immediately after the prior one completes (there will be no overlap of executions of the runnable). In such cases, the actual execution interval will differ from the interval passed to this method.

    If the Runnable throws an exception the repeated scheduling is aborted, i.e. the function will not be invoked any more.

    Definition Classes
    ExplicitlyTriggeredScheduler → Scheduler
    Exceptions thrown

    IllegalArgumentException if the given delays exceed the maximum reach (calculated as: delay / tickNanos > Int.MaxValue). Java API

  3. def schedule(initialDelay: Duration, interval: Duration, runnable: Runnable)(implicit executor: ExecutionContext): Cancellable

    Schedules a Runnable to be run repeatedly with an initial delay and a frequency.

    Schedules a Runnable to be run repeatedly with an initial delay and a frequency. E.g. if you would like the function to be run after 2 seconds and thereafter every 100ms you would set delay = Duration(2, TimeUnit.SECONDS) and interval = Duration(100, TimeUnit.MILLISECONDS). If the execution of the runnable takes longer than the interval, the subsequent execution will start immediately after the prior one completes (there will be no overlap of executions of the runnable). In such cases, the actual execution interval will differ from the interval passed to this method.

    If the Runnable throws an exception the repeated scheduling is aborted, i.e. the function will not be invoked any more.

    Definition Classes
    Scheduler
    Exceptions thrown

    IllegalArgumentException if the given delays exceed the maximum reach (calculated as: delay / tickNanos > Int.MaxValue). Java API

  4. final def schedule(initialDelay: FiniteDuration, interval: FiniteDuration)(f: ⇒ Unit)(implicit executor: ExecutionContext): Cancellable

    Schedules a function to be run repeatedly with an initial delay and a frequency.

    Schedules a function to be run repeatedly with an initial delay and a frequency. E.g. if you would like the function to be run after 2 seconds and thereafter every 100ms you would set delay = Duration(2, TimeUnit.SECONDS) and interval = Duration(100, TimeUnit.MILLISECONDS). If the execution of the function takes longer than the interval, the subsequent execution will start immediately after the prior one completes (there will be no overlap of the function executions). In such cases, the actual execution interval will differ from the interval passed to this method.

    If the function throws an exception the repeated scheduling is aborted, i.e. the function will not be invoked any more.

    Scala API

    Definition Classes
    Scheduler
  5. final def schedule(initialDelay: Duration, interval: Duration, receiver: ActorRef, message: Any, executor: ExecutionContext, sender: ActorRef): Cancellable

    Schedules a message to be sent repeatedly with an initial delay and frequency.

    Schedules a message to be sent repeatedly with an initial delay and frequency. E.g. if you would like a message to be sent immediately and thereafter every 500ms you would set delay=Duration.Zero and interval=Duration(500, TimeUnit.MILLISECONDS)

    Java API

    Definition Classes
    Scheduler
  6. final def schedule(initialDelay: FiniteDuration, interval: FiniteDuration, receiver: ActorRef, message: Any)(implicit executor: ExecutionContext, sender: ActorRef = Actor.noSender): Cancellable

    Schedules a message to be sent repeatedly with an initial delay and frequency.

    Schedules a message to be sent repeatedly with an initial delay and frequency. E.g. if you would like a message to be sent immediately and thereafter every 500ms you would set delay=Duration.Zero and interval=Duration(500, TimeUnit.MILLISECONDS)

    Java & Scala API

    Definition Classes
    Scheduler
    Annotations
    @silent()
  7. def scheduleOnce(delay: FiniteDuration, runnable: Runnable)(implicit executor: ExecutionContext): Cancellable

    Schedules a Runnable to be run once with a delay, i.e.

    Schedules a Runnable to be run once with a delay, i.e. a time period that has to pass before the runnable is executed.

    Definition Classes
    ExplicitlyTriggeredScheduler → Scheduler
    Exceptions thrown

    IllegalArgumentException if the given delays exceed the maximum reach (calculated as: delay / tickNanos > Int.MaxValue). Java & Scala API

  8. def scheduleOnce(delay: Duration, runnable: Runnable)(implicit executor: ExecutionContext): Cancellable

    Schedules a Runnable to be run once with a delay, i.e.

    Schedules a Runnable to be run once with a delay, i.e. a time period that has to pass before the runnable is executed.

    Definition Classes
    Scheduler
    Exceptions thrown

    IllegalArgumentException if the given delays exceed the maximum reach (calculated as: delay / tickNanos > Int.MaxValue). Java & Scala API

  9. final def scheduleOnce(delay: FiniteDuration)(f: ⇒ Unit)(implicit executor: ExecutionContext): Cancellable

    Schedules a function to be run once with a delay, i.e.

    Schedules a function to be run once with a delay, i.e. a time period that has to pass before the function is run.

    Definition Classes
    Scheduler
    Exceptions thrown

    IllegalArgumentException if the given delays exceed the maximum reach (calculated as: delay / tickNanos > Int.MaxValue). Scala API

  10. final def scheduleOnce(delay: Duration, receiver: ActorRef, message: Any, executor: ExecutionContext, sender: ActorRef): Cancellable

    Schedules a message to be sent once with a delay, i.e.

    Schedules a message to be sent once with a delay, i.e. a time period that has to pass before the message is sent.

    Definition Classes
    Scheduler
    Exceptions thrown

    IllegalArgumentException if the given delays exceed the maximum reach (calculated as: delay / tickNanos > Int.MaxValue). Java API

  11. final def scheduleOnce(delay: FiniteDuration, receiver: ActorRef, message: Any)(implicit executor: ExecutionContext, sender: ActorRef = Actor.noSender): Cancellable

    Schedules a message to be sent once with a delay, i.e.

    Schedules a message to be sent once with a delay, i.e. a time period that has to pass before the message is sent.

    Definition Classes
    Scheduler
    Exceptions thrown

    IllegalArgumentException if the given delays exceed the maximum reach (calculated as: delay / tickNanos > Int.MaxValue). Java & Scala API

  12. def timePasses(amount: FiniteDuration): Unit

    Advance the clock by the specified duration, executing all outstanding jobs on the calling thread before returning.

    Advance the clock by the specified duration, executing all outstanding jobs on the calling thread before returning.

    We will not add a dilation factor to this amount, since the scheduler API also does not apply dilation. If you want the amount of time passed to be dilated, apply the dilation before passing the delay to this method.