Packages

abstract class Agent[T] extends AnyRef

The Agent class was inspired by agents in Clojure.

Agents provide asynchronous change of individual locations. Agents are bound to a single storage location for their lifetime, and only allow mutation of that location (to a new state) to occur as a result of an action. Update actions are functions that are asynchronously applied to the Agent's state and whose return value becomes the Agent's new state. The state of an Agent should be immutable.

While updates to Agents are asynchronous, the state of an Agent is always immediately available for reading by any thread (using get or apply) without any messages.

Agents are reactive. The update actions of all Agents get interleaved amongst threads in a thread pool. At any point in time, at most one send action for each Agent is being executed. Actions dispatched to an agent from another thread will occur in the order they were sent, potentially interleaved with actions dispatched to the same agent from other sources.

Example of usage:

val agent = Agent(5)

agent send (_ * 2)

...

val result = agent()
// use result ...

Agent is also monadic, which means that you can compose operations using for-comprehensions. In monadic usage the original agents are not touched but new agents are created. So the old values (agents) are still available as-is. They are so-called 'persistent'.

Example of monadic usage:

val agent1 = Agent(3)
val agent2 = Agent(5)

for (value <- agent1) {
  result = value + 1
}

val agent3 = for (value <- agent1) yield value + 1

val agent4 = for {
  value1 <- agent1
  value2 <- agent2
} yield value1 + value2

DEPRECATED STM SUPPORT

Agents participating in enclosing STM transaction is a deprecated feature in 2.3.

If an Agent is used within an enclosing transaction, then it will participate in that transaction. Agents are integrated with the STM - any dispatches made in a transaction are held until that transaction commits, and are discarded if it is retried or aborted.

Annotations
@deprecated
Deprecated

(Since version 2.5.0) Agents are deprecated and scheduled for removal in the next major version, use Actors instead.

Source
Agent.scala
Linear Supertypes
Type Hierarchy
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. Agent
  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

Instance Constructors

  1. new Agent()

    Deprecated

    Agents are deprecated and scheduled for removal in the next major version, use Actors instead.

Abstract Value Members

  1. abstract def alter(f: (T) ⇒ T): Future[T]

    Dispatch a function to update the internal state, and return a Future where that new state can be obtained.

    Dispatch a function to update the internal state, and return a Future where that new state can be obtained. In Java, pass in an instance of akka.dispatch.Mapper.

  2. abstract def alter(newValue: T): Future[T]

    Dispatch an update to the internal state, and return a Future where that new state can be obtained.

    Dispatch an update to the internal state, and return a Future where that new state can be obtained. In Java, pass in an instance of akka.dispatch.Mapper.

  3. abstract def alterOff(f: (T) ⇒ T)(implicit ec: ExecutionContext): Future[T]

    Dispatch a function to update the internal state but on its own thread, and return a Future where that new state can be obtained.

    Dispatch a function to update the internal state but on its own thread, and return a Future where that new state can be obtained. This does not use the reactive thread pool and can be used for long-running or blocking operations. Dispatches using either alterOff or alter will still be executed in order. In Java, pass in an instance of akka.dispatch.Mapper.

  4. abstract def flatMap[B](f: (T) ⇒ Agent[B]): Agent[B]

    Flatmap this agent to a new agent, applying the function to the internal state.

    Flatmap this agent to a new agent, applying the function to the internal state. Does not change the value of this agent. In Java, pass in an instance of akka.dispatch.Mapper.

  5. abstract def foreach[U](f: (T) ⇒ U): Unit

    Applies the function to the internal state.

    Applies the function to the internal state. Does not change the value of this agent. In Java, pass in an instance of akka.dispatch.Foreach.

  6. abstract def future(): Future[T]

    A future to the current value that will be completed after any currently queued updates.

  7. abstract def get(): T

    Java API: Read the internal state of the agent.

  8. abstract def map[B](f: (T) ⇒ B): Agent[B]

    Map this agent to a new agent, applying the function to the internal state.

    Map this agent to a new agent, applying the function to the internal state. Does not change the value of this agent. In Java, pass in an instance of akka.dispatch.Mapper.

  9. abstract def send(f: (T) ⇒ T): Unit

    Dispatch a function to update the internal state.

    Dispatch a function to update the internal state. In Java, pass in an instance of akka.dispatch.Mapper.

  10. abstract def send(newValue: T): Unit

    Dispatch a new value for the internal state.

    Dispatch a new value for the internal state. Behaves the same as sending a function (x => newValue).

  11. abstract def sendOff(f: (T) ⇒ T)(implicit ec: ExecutionContext): Unit

    Dispatch a function to update the internal state but on its own thread.

    Dispatch a function to update the internal state but on its own thread. This does not use the reactive thread pool and can be used for long-running or blocking operations. Dispatches using either sendOff or send will still be executed in order. In Java, pass in an instance of akka.dispatch.Mapper.

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 Agent[T] to any2stringadd[Agent[T]] performed by method any2stringadd in scala.Predef.
    Definition Classes
    any2stringadd
  4. def ->[B](y: B): (Agent[T], B)
    Implicit
    This member is added by an implicit conversion from Agent[T] to ArrowAssoc[Agent[T]] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @inline()
  5. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  6. def apply(): T

    Read the internal state of the agent.

  7. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  8. def clone(): AnyRef
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @native() @HotSpotIntrinsicCandidate() @throws( ... )
  9. def ensuring(cond: (Agent[T]) ⇒ Boolean, msg: ⇒ Any): Agent[T]
    Implicit
    This member is added by an implicit conversion from Agent[T] to Ensuring[Agent[T]] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  10. def ensuring(cond: (Agent[T]) ⇒ Boolean): Agent[T]
    Implicit
    This member is added by an implicit conversion from Agent[T] to Ensuring[Agent[T]] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  11. def ensuring(cond: Boolean, msg: ⇒ Any): Agent[T]
    Implicit
    This member is added by an implicit conversion from Agent[T] to Ensuring[Agent[T]] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  12. def ensuring(cond: Boolean): Agent[T]
    Implicit
    This member is added by an implicit conversion from Agent[T] to Ensuring[Agent[T]] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  13. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  14. def equals(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  15. def formatted(fmtstr: String): String
    Implicit
    This member is added by an implicit conversion from Agent[T] to StringFormat[Agent[T]] performed by method StringFormat in scala.Predef.
    Definition Classes
    StringFormat
    Annotations
    @inline()
  16. final def getClass(): Class[_]
    Definition Classes
    AnyRef → Any
    Annotations
    @native() @HotSpotIntrinsicCandidate()
  17. def hashCode(): Int
    Definition Classes
    AnyRef → Any
    Annotations
    @native() @HotSpotIntrinsicCandidate()
  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
    Annotations
    @native() @HotSpotIntrinsicCandidate()
  21. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native() @HotSpotIntrinsicCandidate()
  22. final def synchronized[T0](arg0: ⇒ T0): T0
    Definition Classes
    AnyRef
  23. def toString(): String
    Definition Classes
    AnyRef → Any
  24. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  25. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @native() @throws( ... )
  26. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  27. def [B](y: B): (Agent[T], B)
    Implicit
    This member is added by an implicit conversion from Agent[T] to ArrowAssoc[Agent[T]] 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 Agent[T] to any2stringadd[Agent[T]]

Inherited by implicit conversion StringFormat from Agent[T] to StringFormat[Agent[T]]

Inherited by implicit conversion Ensuring from Agent[T] to Ensuring[Agent[T]]

Inherited by implicit conversion ArrowAssoc from Agent[T] to ArrowAssoc[Agent[T]]

Ungrouped