scalaz.concurrent

Actor

final case class Actor[A](handler: (A) ⇒ Unit, onError: (Throwable) ⇒ Unit, strategy: Strategy) extends Product with Serializable

Processes messages of type A, one at a time. Messages are submitted to the actor with the method !. Processing is typically performed asynchronously, this is controlled by the provided strategy.

Memory consistency guarantee: when each message is processed by the handler, any memory that it mutates is guaranteed to be visible by the handler when it processes the next message, even if the strategy runs the invocations of handler on separate threads. This is achieved because the Actor reads a volatile memory location before entering its event loop, and writes to the same location before suspending.

Implementation based on non-intrusive MPSC node-based queue, described by Dmitriy Vyukov: http://www.1024cores.net/home/lock-free-algorithms/queues/non-intrusive-mpsc-node-based-queue

A

The type of messages accepted by this actor.

handler

The message handler

onError

Exception handler, called if the message handler throws any Throwable.

strategy

Execution strategy, for example, a strategy that is backed by an ExecutorService

Source
Actor.scala
See also

scalaz.concurrent.Promise for a use case.

Linear Supertypes
Serializable, Serializable, Product, Equals, AnyRef, Any
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. Hide All
  2. Show all
  1. Actor
  2. Serializable
  3. Serializable
  4. Product
  5. Equals
  6. AnyRef
  7. Any
Visibility
  1. Public
  2. All

Instance Constructors

  1. new Actor(handler: (A) ⇒ Unit, onError: (Throwable) ⇒ Unit = ActorUtils.rethrowError)(implicit strategy: Strategy)

    handler

    The message handler

    onError

    Exception handler, called if the message handler throws any Throwable.

    strategy

    Execution strategy, for example, a strategy that is backed by an ExecutorService

Value Members

  1. def !(a: A): Unit

    Alias for apply

  2. final def !=(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  3. final def !=(arg0: Any): Boolean

    Definition Classes
    Any
  4. final def ##(): Int

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

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

    Definition Classes
    Any
  7. def apply(a: A): Unit

    Pass the message a to the mailbox of this actor

  8. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  9. def canEqual(arg0: Any): Boolean

    Definition Classes
    Actor → Equals
  10. def clone(): AnyRef

    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws()
  11. def contramap[B](f: (B) ⇒ A): Actor[B]

  12. final def eq(arg0: AnyRef): Boolean

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

    Definition Classes
    Actor → Equals → AnyRef → Any
  14. def finalize(): Unit

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

    Definition Classes
    AnyRef → Any
  16. val handler: (A) ⇒ Unit

    The message handler

  17. def hashCode(): Int

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

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

    Definition Classes
    AnyRef
  20. final def notify(): Unit

    Definition Classes
    AnyRef
  21. final def notifyAll(): Unit

    Definition Classes
    AnyRef
  22. val onError: (Throwable) ⇒ Unit

    Exception handler, called if the message handler throws any Throwable.

  23. def productArity: Int

    Definition Classes
    Actor → Product
  24. def productElement(arg0: Int): Any

    Definition Classes
    Actor → Product
  25. def productIterator: Iterator[Any]

    Definition Classes
    Product
  26. def productPrefix: String

    Definition Classes
    Actor → Product
  27. implicit val strategy: Strategy

    Execution strategy, for example, a strategy that is backed by an ExecutorService

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

    Definition Classes
    AnyRef
  29. val toEffect: Run[A]

  30. def toString(): String

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

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

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

    Definition Classes
    AnyRef
    Annotations
    @throws()

Deprecated Value Members

  1. def productElements: Iterator[Any]

    Definition Classes
    Product
    Annotations
    @deprecated
    Deprecated

    (Since version 2.8.0) use productIterator instead

Inherited from Serializable

Inherited from Serializable

Inherited from Product

Inherited from Equals

Inherited from AnyRef

Inherited from Any