Packages

t

akka.actor

Scheduler

trait Scheduler extends AnyRef

An Akka scheduler service. This one needs one special behavior: if Closeable, it MUST execute all outstanding tasks upon .close() in order to properly shutdown all dispatchers.

Furthermore, this timer service MUST throw IllegalStateException if it cannot schedule a task. Once scheduled, the task MUST be executed. If executed upon close(), the task may execute before its timeout.

Scheduler implementation are loaded reflectively at ActorSystem start-up with the following constructor arguments: 1) the system’s com.typesafe.config.Config (from system.settings.config) 2) a akka.event.LoggingAdapter 3) a java.util.concurrent.ThreadFactory

Please note that this scheduler implementation is higly optimised for high-throughput and high-frequency events. It is not to be confused with long-term schedulers such as Quartz. The scheduler will throw an exception if attempts are made to schedule too far into the future (which by default is around 8 months (Int.MaxValue seconds).

Source
Scheduler.scala
Linear Supertypes
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. Scheduler
  2. AnyRef
  3. 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

Abstract Value Members

  1. abstract 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.

  2. abstract 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.

    Exceptions thrown

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

  3. abstract 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.

    Exceptions thrown

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

Concrete 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 Scheduler to any2stringadd[Scheduler] performed by method any2stringadd in scala.Predef.
    Definition Classes
    any2stringadd
  4. def ->[B](y: B): (Scheduler, B)
    Implicit
    This member is added by an implicit conversion from Scheduler to ArrowAssoc[Scheduler] 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[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @native() @HotSpotIntrinsicCandidate() @throws( ... )
  8. def ensuring(cond: (Scheduler) ⇒ Boolean, msg: ⇒ Any): Scheduler
    Implicit
    This member is added by an implicit conversion from Scheduler to Ensuring[Scheduler] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  9. def ensuring(cond: (Scheduler) ⇒ Boolean): Scheduler
    Implicit
    This member is added by an implicit conversion from Scheduler to Ensuring[Scheduler] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  10. def ensuring(cond: Boolean, msg: ⇒ Any): Scheduler
    Implicit
    This member is added by an implicit conversion from Scheduler to Ensuring[Scheduler] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  11. def ensuring(cond: Boolean): Scheduler
    Implicit
    This member is added by an implicit conversion from Scheduler to Ensuring[Scheduler] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  12. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  13. def equals(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  14. def formatted(fmtstr: String): String
    Implicit
    This member is added by an implicit conversion from Scheduler to StringFormat[Scheduler] performed by method StringFormat in scala.Predef.
    Definition Classes
    StringFormat
    Annotations
    @inline()
  15. final def getClass(): Class[_]
    Definition Classes
    AnyRef → Any
    Annotations
    @native() @HotSpotIntrinsicCandidate()
  16. def hashCode(): Int
    Definition Classes
    AnyRef → Any
    Annotations
    @native() @HotSpotIntrinsicCandidate()
  17. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  18. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  19. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native() @HotSpotIntrinsicCandidate()
  20. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native() @HotSpotIntrinsicCandidate()
  21. 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.

    Exceptions thrown

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

  22. 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

  23. 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

  24. 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

    Annotations
    @silent()
  25. 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.

    Exceptions thrown

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

  26. 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.

    Exceptions thrown

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

  27. 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.

    Exceptions thrown

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

  28. 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.

    Exceptions thrown

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

  29. final def synchronized[T0](arg0: ⇒ T0): T0
    Definition Classes
    AnyRef
  30. def toString(): String
    Definition Classes
    AnyRef → Any
  31. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  32. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @native() @throws( ... )
  33. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  34. def [B](y: B): (Scheduler, B)
    Implicit
    This member is added by an implicit conversion from Scheduler to ArrowAssoc[Scheduler] 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.

Inherited from AnyRef

Inherited from Any

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

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

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

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

Ungrouped