akka.actor
Class ActorSelection

java.lang.Object
  akka.actor.ActorSelection

All Implemented Interfaces:

java.io.Serializable

public abstract class ActorSelection
extends java.lang.Object
implements scala.Serializable

An ActorSelection is a logical view of a section of an ActorSystem's tree of Actors, allowing for broadcasting of messages to that section.

See Also:

Serialized Form

Constructor Summary

ActorSelection()

Method Summary

protected abstract ActorRef	anchor()
static ActorSelection	apply(ActorRef anchorRef, scala.collection.Iterable<java.lang.String> elements) Construct an ActorSelection from the given string representing a path relative to the given target.
static ActorSelection	apply(ActorRef anchorRef, java.lang.String path) Construct an ActorSelection from the given string representing a path relative to the given target.
boolean	equals(java.lang.Object obj)
int	hashCode()
protected abstract scala.collection.immutable.IndexedSeq<java.lang.Object>	path()
scala.concurrent.Future<ActorRef>	resolveOne(scala.concurrent.duration.FiniteDuration timeout) Resolve the ActorRef matching this selection.
scala.concurrent.Future<ActorRef>	resolveOne(Timeout timeout) Resolve the ActorRef matching this selection.
void	tell(java.lang.Object msg)
void	tell(java.lang.Object msg, ActorRef sender)
static ScalaActorSelection	toScala(ActorSelection sel)
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ActorSelection

public ActorSelection()

Method Detail

toScala

public static ScalaActorSelection toScala(ActorSelection sel)

apply

public static ActorSelection apply(ActorRef anchorRef,
                                   java.lang.String path)

Construct an ActorSelection from the given string representing a path relative to the given target. This operation has to create all the matching magic, so it is preferable to cache its result if the intention is to send messages frequently.

apply

public static ActorSelection apply(ActorRef anchorRef,
                                   scala.collection.Iterable<java.lang.String> elements)

Construct an ActorSelection from the given string representing a path relative to the given target. This operation has to create all the matching magic, so it is preferable to cache its result if the intention is to send messages frequently.

anchor

protected abstract ActorRef anchor()

path

protected abstract scala.collection.immutable.IndexedSeq<java.lang.Object> path()

tell

public void tell(java.lang.Object msg)

tell

public void tell(java.lang.Object msg,
                 ActorRef sender)

resolveOne

public scala.concurrent.Future<ActorRef> resolveOne(Timeout timeout)

Resolve the ActorRef matching this selection. The result is returned as a Future that is completed with the ActorRef if such an actor exists. It is completed with failure ActorNotFound if no such actor exists or the identification didn't complete within the supplied timeout.

Under the hood it talks to the actor to verify its existence and acquire its ActorRef.

resolveOne

public scala.concurrent.Future<ActorRef> resolveOne(scala.concurrent.duration.FiniteDuration timeout)

Resolve the ActorRef matching this selection. The result is returned as a Future that is completed with the ActorRef if such an actor exists. It is completed with failure ActorNotFound if no such actor exists or the identification didn't complete within the supplied timeout.

Under the hood it talks to the actor to verify its existence and acquire its ActorRef.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object