Reactor

A reactor is a basic unit of concurrency.

A concurrent program in the Reactors framework is composed of multiple reactors, which execute concurrently, and in isolation. The only way they can communicate is by exchanging events using entities called *channels*.

A Reactor[T] object accepts events of type T on its input channel. One reactor can propagate events concurrently to other reactors. Event streams cannot be shared between reactors -- it is an error to use an event stream originating in one reactor in some different reactor.

Reactors are defined by extending the Reactor trait. The events passed to reactors can be subscribed to using their main.events stream. Here is an example:

class MyPrinter extends Reactor[String] {
  main.events onEvent {
    e => println(e)
  }
}

Separate reactor instances that exist at runtime are created using reactor systems. Each reactor belongs to a specific reactor system. Usually there is a single reactor system within a single program instance. Here is an example:

val reactorSystem = ReactorSystem.default("MyReactorSystem")
val channel = reactorSystem.spawn(Proto[MyPrinter])

Creating a reactor returns its channel. Events can be sent to a channel using the ! method:

channel ! "Hi!" // eventually, this is printed by `MyPrinter`

To stop, a reactor must seal its main channel. The following reactor seals its main channel after receiving the first event:

class MyPrinter extends Reactor[String] {
  main.events onEvent {
    e =>
    println(e)
    main.seal()
  }
}

Reactors also receive special SysEvent events on the sysEvents stream.

T: the type of events, which this reactor produces

Linear Supertypes

Reflectable, AnyRef, Any

Known Subclasses

AnonymousReactor, NameAwaiterReactor, NameResolverReactor

Value Members

final def !=(arg0: Any): Boolean

Definition Classes
AnyRef → Any
final def ##(): Int

Definition Classes
AnyRef → Any
def +(other: String): String

Implicit information
This member is added by an implicit conversion from Reactor[T] to any2stringadd[Reactor[T]] performed by method any2stringadd in scala.Predef.
Definition Classes
any2stringadd
def ->[B](y: B): (Reactor[T], B)

Implicit information
This member is added by an implicit conversion from Reactor[T] to ArrowAssoc[Reactor[T]] performed by method ArrowAssoc in scala.Predef.
Definition Classes
ArrowAssoc
Annotations
@inline()
final def ==(arg0: Any): Boolean

Definition Classes
AnyRef → Any
final def asInstanceOf[T0]: T0

Definition Classes
Any
def clone(): AnyRef

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( ... )
def ensuring(cond: (Reactor[T]) ⇒ Boolean, msg: ⇒ Any): Reactor[T]

Implicit information
This member is added by an implicit conversion from Reactor[T] to Ensuring[Reactor[T]] performed by method Ensuring in scala.Predef.
Definition Classes
Ensuring
def ensuring(cond: (Reactor[T]) ⇒ Boolean): Reactor[T]

Implicit information
This member is added by an implicit conversion from Reactor[T] to Ensuring[Reactor[T]] performed by method Ensuring in scala.Predef.
Definition Classes
Ensuring
def ensuring(cond: Boolean, msg: ⇒ Any): Reactor[T]

Implicit information
This member is added by an implicit conversion from Reactor[T] to Ensuring[Reactor[T]] performed by method Ensuring in scala.Predef.
Definition Classes
Ensuring
def ensuring(cond: Boolean): Reactor[T]

Implicit information
This member is added by an implicit conversion from Reactor[T] to Ensuring[Reactor[T]] performed by method Ensuring in scala.Predef.
Definition Classes
Ensuring
final def eq(arg0: AnyRef): Boolean

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

Definition Classes
AnyRef → Any
def finalize(): Unit

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( classOf[java.lang.Throwable] )
def formatted(fmtstr: String): String

Implicit information
This member is added by an implicit conversion from Reactor[T] to StringFormat[Reactor[T]] performed by method StringFormat in scala.Predef.
Definition Classes
StringFormat
Annotations
@inline()
final def getClass(): Class[_]

Definition Classes
AnyRef → Any
def hashCode(): Int

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

Definition Classes
Any
final def main: Connector[T]

The main connector of this reactor.
final def name: String

The name of this reactor.
final def ne(arg0: AnyRef): Boolean

Definition Classes
AnyRef
final def notify(): Unit

Definition Classes
AnyRef
final def notifyAll(): Unit

Definition Classes
AnyRef
final def synchronized[T0](arg0: ⇒ T0): T0

Definition Classes
AnyRef
final def sysEvents: Events[SysEvent]

The system event stream of this reactor.
final def system: ReactorSystem

The reactor system of this reactor.
def toString(): String

Definition Classes
AnyRef → Any
final def uid: Long

The unique id of this reactor.
The unique id of this reactor.
returns
the unique id, assigned only to this reactor
final def wait(): Unit

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

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

Definition Classes
AnyRef
Annotations
@throws( ... )
def →[B](y: B): (Reactor[T], B)

Implicit information
This member is added by an implicit conversion from Reactor[T] to ArrowAssoc[Reactor[T]] performed by method ArrowAssoc in scala.Predef.
Definition Classes
ArrowAssoc

Related Docs: object Reactor | package reactors

trait Reactor[T] extends Reflectable

Value Members

final def !=(arg0: Any): Boolean

final def ##(): Int

def +(other: String): String

def ->[B](y: B): (Reactor[T], B)

final def ==(arg0: Any): Boolean

final def asInstanceOf[T0]: T0

def clone(): AnyRef

def ensuring(cond: (Reactor[T]) ⇒ Boolean, msg: ⇒ Any): Reactor[T]

def ensuring(cond: (Reactor[T]) ⇒ Boolean): Reactor[T]

def ensuring(cond: Boolean, msg: ⇒ Any): Reactor[T]

def ensuring(cond: Boolean): Reactor[T]

final def eq(arg0: AnyRef): Boolean

def equals(arg0: Any): Boolean

def finalize(): Unit

def formatted(fmtstr: String): String

final def getClass(): Class[_]

def hashCode(): Int

final def isInstanceOf[T0]: Boolean

final def main: Connector[T]

final def name: String

final def ne(arg0: AnyRef): Boolean

final def notify(): Unit

final def notifyAll(): Unit

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

final def sysEvents: Events[SysEvent]

final def system: ReactorSystem

def toString(): String

final def uid: Long

final def wait(): Unit

final def wait(arg0: Long, arg1: Int): Unit

final def wait(arg0: Long): Unit

def →[B](y: B): (Reactor[T], B)

Inherited from Reflectable

Inherited from AnyRef

Inherited from Any

Inherited by implicit conversion any2stringadd from Reactor[T] to any2stringadd[Reactor[T]]

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

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

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

Ungrouped