akka.actor
Class LocalActorRefProvider

java.lang.Object
  extended by akka.actor.LocalActorRefProvider
All Implemented Interfaces:
ActorRefProvider

public class LocalActorRefProvider
extends java.lang.Object
implements ActorRefProvider

Local ActorRef provider.

INTERNAL API!

Depending on this class is not supported, only the ActorRefProvider interface is supported.


Constructor Summary
LocalActorRefProvider(java.lang.String _systemName, ActorSystem.Settings settings, EventStream eventStream, DynamicAccess dynamicAccess)
           
LocalActorRefProvider(java.lang.String _systemName, ActorSystem.Settings settings, EventStream eventStream, DynamicAccess dynamicAccess, Deployer deployer, scala.Option<scala.Function1<ActorPath,InternalActorRef>> _deadLetters)
           
 
Method Summary
 InternalActorRef actorFor(ActorPath path)
          Create actor reference for a specified local or remote path.
 InternalActorRef actorFor(InternalActorRef ref, scala.collection.Iterable<java.lang.String> path)
          Create actor reference for the specified child path starting at the given starting point.
 InternalActorRef actorFor(InternalActorRef ref, java.lang.String path)
          Create actor reference for a specified local or remote path, which will be parsed using java.net.URI.
 InternalActorRef actorOf(ActorSystemImpl system, Props props, InternalActorRef supervisor, ActorPath path, boolean systemService, scala.Option<Deploy> deploy, boolean lookupDeploy, boolean async)
          Actor factory with create-only semantics: will create an actor as described by props with the given supervisor and path (may be different in case of remote supervision).
 InternalActorRef deadLetters()
          Dead letter destination for this provider.
 Deployer deployer()
          The Deployer associated with this ActorRefProvider
 DynamicAccess dynamicAccess()
           
 EventStream eventStream()
           
 Address getDefaultAddress()
          Obtain the external address of the default transport.
 scala.Option<Address> getExternalAddressFor(Address addr)
          Obtain the address which is to be used within sender references when sending to the given other address or none if the other address cannot be reached from this system (i.e.
 LocalActorRef guardian()
          Reference to the supervisor used for all top-level user actors.
protected  SupervisorStrategy guardianStrategy()
          Overridable supervision strategy to be used by the &ldquo;/user&rdquo; guardian.
 void init(ActorSystemImpl _system)
          Initialization of an ActorRefProvider happens in two steps: first construction of the object with settings, eventStream, etc.
 LoggingAdapter log()
           
 void registerExtraNames(scala.collection.immutable.Map<java.lang.String,InternalActorRef> _extras)
          Higher-level providers (or extensions) might want to register new synthetic top-level paths for doing special stuff.
 void registerTempActor(InternalActorRef actorRef, ActorPath path)
          Registers an actorRef at a path returned by tempPath(); do NOT pass in any other path.
 ActorRef resolveActorRef(ActorPath path)
          Create actor reference for a specified path.
 InternalActorRef resolveActorRef(InternalActorRef ref, scala.collection.Iterable<java.lang.String> pathElements)
          INTERNAL API
 ActorRef resolveActorRef(java.lang.String path)
          Create actor reference for a specified path.
 LocalActorRef rootGuardian()
          Reference to the supervisor of guardian and systemGuardian; this is exposed so that the ActorSystemImpl can use it as lookupRoot, i.e.
 ActorRef rootGuardianAt(Address address)
          Reference to the supervisor of guardian and systemGuardian at the specified address; this is exposed so that the ActorRefFactory can use it as lookupRoot, i.e.
protected  SupervisorStrategy rootGuardianStrategy()
          Overridable supervision strategy to be used by the &ldquo;/user&rdquo; guardian.
 ActorPath rootPath()
          The root path for all actors within this actor system, not including any remote address information.
 ActorSystem.Settings settings()
          The Settings associated with this ActorRefProvider
 LocalActorRef systemGuardian()
          Reference to the supervisor used for all top-level system actors.
protected  SupervisorStrategy systemGuardianStrategy()
          Overridable supervision strategy to be used by the &ldquo;/user&rdquo; guardian.
 VirtualPathContainer tempContainer()
          Returns the actor reference representing the &ldquo;/temp&rdquo; path.
 ActorPath tempPath()
          Generates and returns a unique actor path below &ldquo;/temp&rdquo;.
 scala.concurrent.Future<scala.runtime.BoxedUnit> terminationFuture()
          This Future is completed upon termination of this ActorRefProvider, which is usually initiated by stopping the guardian via ActorSystem.stop().
 scala.concurrent.Promise<scala.runtime.BoxedUnit> terminationPromise()
           
 InternalActorRef theOneWhoWalksTheBubblesOfSpaceTime()
          Top-level anchor for the supervision hierarchy of this actor system.
 void unregisterTempActor(ActorPath path)
          Unregister a temporary actor from the &ldquo;/temp&rdquo; path (i.e.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

LocalActorRefProvider

public LocalActorRefProvider(java.lang.String _systemName,
                             ActorSystem.Settings settings,
                             EventStream eventStream,
                             DynamicAccess dynamicAccess,
                             Deployer deployer,
                             scala.Option<scala.Function1<ActorPath,InternalActorRef>> _deadLetters)

LocalActorRefProvider

public LocalActorRefProvider(java.lang.String _systemName,
                             ActorSystem.Settings settings,
                             EventStream eventStream,
                             DynamicAccess dynamicAccess)
Method Detail

settings

public ActorSystem.Settings settings()
Description copied from interface: ActorRefProvider
The Settings associated with this ActorRefProvider

Specified by:
settings in interface ActorRefProvider
Returns:
(undocumented)

eventStream

public EventStream eventStream()

dynamicAccess

public DynamicAccess dynamicAccess()

deployer

public Deployer deployer()
Description copied from interface: ActorRefProvider
The Deployer associated with this ActorRefProvider

Specified by:
deployer in interface ActorRefProvider
Returns:
(undocumented)

rootPath

public ActorPath rootPath()
Description copied from interface: ActorRefProvider
The root path for all actors within this actor system, not including any remote address information.

Specified by:
rootPath in interface ActorRefProvider
Returns:
(undocumented)

log

public LoggingAdapter log()

deadLetters

public InternalActorRef deadLetters()
Description copied from interface: ActorRefProvider
Dead letter destination for this provider.

Specified by:
deadLetters in interface ActorRefProvider
Returns:
(undocumented)

tempPath

public ActorPath tempPath()
Description copied from interface: ActorRefProvider
Generates and returns a unique actor path below &ldquo;/temp&rdquo;.

Specified by:
tempPath in interface ActorRefProvider
Returns:
(undocumented)

theOneWhoWalksTheBubblesOfSpaceTime

public InternalActorRef theOneWhoWalksTheBubblesOfSpaceTime()
Top-level anchor for the supervision hierarchy of this actor system. Will receive only Supervise/ChildTerminated system messages or Failure message.

Returns:
(undocumented)

terminationPromise

public scala.concurrent.Promise<scala.runtime.BoxedUnit> terminationPromise()

terminationFuture

public scala.concurrent.Future<scala.runtime.BoxedUnit> terminationFuture()
Description copied from interface: ActorRefProvider
This Future is completed upon termination of this ActorRefProvider, which is usually initiated by stopping the guardian via ActorSystem.stop().

Specified by:
terminationFuture in interface ActorRefProvider
Returns:
(undocumented)

registerExtraNames

public void registerExtraNames(scala.collection.immutable.Map<java.lang.String,InternalActorRef> _extras)
Higher-level providers (or extensions) might want to register new synthetic top-level paths for doing special stuff. This is the way to do just that. Just be careful to complete all this before ActorSystem.start() finishes, or before you start your own auto-spawned actors.

Parameters:
_extras - (undocumented)

rootGuardianStrategy

protected SupervisorStrategy rootGuardianStrategy()
Overridable supervision strategy to be used by the &ldquo;/user&rdquo; guardian.

Returns:
(undocumented)

guardianStrategy

protected SupervisorStrategy guardianStrategy()
Overridable supervision strategy to be used by the &ldquo;/user&rdquo; guardian.

Returns:
(undocumented)

systemGuardianStrategy

protected SupervisorStrategy systemGuardianStrategy()
Overridable supervision strategy to be used by the &ldquo;/user&rdquo; guardian.

Returns:
(undocumented)

rootGuardian

public LocalActorRef rootGuardian()
Description copied from interface: ActorRefProvider
Reference to the supervisor of guardian and systemGuardian; this is exposed so that the ActorSystemImpl can use it as lookupRoot, i.e. for anchoring absolute actor look-ups.

Specified by:
rootGuardian in interface ActorRefProvider
Returns:
(undocumented)

rootGuardianAt

public ActorRef rootGuardianAt(Address address)
Description copied from interface: ActorRefProvider
Reference to the supervisor of guardian and systemGuardian at the specified address; this is exposed so that the ActorRefFactory can use it as lookupRoot, i.e. for anchoring absolute actor selections.

Specified by:
rootGuardianAt in interface ActorRefProvider
Parameters:
address - (undocumented)
Returns:
(undocumented)

guardian

public LocalActorRef guardian()
Description copied from interface: ActorRefProvider
Reference to the supervisor used for all top-level user actors.

Specified by:
guardian in interface ActorRefProvider
Returns:
(undocumented)

systemGuardian

public LocalActorRef systemGuardian()
Description copied from interface: ActorRefProvider
Reference to the supervisor used for all top-level system actors.

Specified by:
systemGuardian in interface ActorRefProvider
Returns:
(undocumented)

tempContainer

public VirtualPathContainer tempContainer()
Description copied from interface: ActorRefProvider
Returns the actor reference representing the &ldquo;/temp&rdquo; path.

Specified by:
tempContainer in interface ActorRefProvider
Returns:
(undocumented)

registerTempActor

public void registerTempActor(InternalActorRef actorRef,
                              ActorPath path)
Description copied from interface: ActorRefProvider
Registers an actorRef at a path returned by tempPath(); do NOT pass in any other path.

Specified by:
registerTempActor in interface ActorRefProvider
Parameters:
actorRef - (undocumented)
path - (undocumented)

unregisterTempActor

public void unregisterTempActor(ActorPath path)
Description copied from interface: ActorRefProvider
Unregister a temporary actor from the &ldquo;/temp&rdquo; path (i.e. obtained from tempPath()); do NOT pass in any other path.

Specified by:
unregisterTempActor in interface ActorRefProvider
Parameters:
path - (undocumented)

init

public void init(ActorSystemImpl _system)
Description copied from interface: ActorRefProvider
Initialization of an ActorRefProvider happens in two steps: first construction of the object with settings, eventStream, etc. and then—when the ActorSystem is constructed—the second phase during which actors may be created (e.g. the guardians).

Specified by:
init in interface ActorRefProvider
Parameters:
_system - (undocumented)

actorFor

public InternalActorRef actorFor(InternalActorRef ref,
                                 java.lang.String path)
Description copied from interface: ActorRefProvider
Create actor reference for a specified local or remote path, which will be parsed using java.net.URI. If no such actor exists, it will be (equivalent to) a dead letter reference. If s is a relative URI, resolve it relative to the given ref.

Specified by:
actorFor in interface ActorRefProvider
Parameters:
ref - (undocumented)
path - (undocumented)
Returns:
(undocumented)

actorFor

public InternalActorRef actorFor(ActorPath path)
Description copied from interface: ActorRefProvider
Create actor reference for a specified local or remote path. If no such actor exists, it will be (equivalent to) a dead letter reference.

Specified by:
actorFor in interface ActorRefProvider
Parameters:
path - (undocumented)
Returns:
(undocumented)

actorFor

public InternalActorRef actorFor(InternalActorRef ref,
                                 scala.collection.Iterable<java.lang.String> path)
Description copied from interface: ActorRefProvider
Create actor reference for the specified child path starting at the given starting point. This method always returns an actor which is &ldquo;logically local&rdquo;, i.e. it cannot be used to obtain a reference to an actor which is not physically or logically attached to this actor system.

Specified by:
actorFor in interface ActorRefProvider
Parameters:
ref - (undocumented)
path - (undocumented)
Returns:
(undocumented)

resolveActorRef

public ActorRef resolveActorRef(java.lang.String path)
Description copied from interface: ActorRefProvider
Create actor reference for a specified path. If no such actor exists, it will be (equivalent to) a dead letter reference.

Specified by:
resolveActorRef in interface ActorRefProvider
Parameters:
path - (undocumented)
Returns:
(undocumented)

resolveActorRef

public ActorRef resolveActorRef(ActorPath path)
Description copied from interface: ActorRefProvider
Create actor reference for a specified path. If no such actor exists, it will be (equivalent to) a dead letter reference.

Specified by:
resolveActorRef in interface ActorRefProvider
Parameters:
path - (undocumented)
Returns:
(undocumented)

resolveActorRef

public InternalActorRef resolveActorRef(InternalActorRef ref,
                                        scala.collection.Iterable<java.lang.String> pathElements)
INTERNAL API

Parameters:
ref - (undocumented)
pathElements - (undocumented)
Returns:
(undocumented)

actorOf

public InternalActorRef actorOf(ActorSystemImpl system,
                                Props props,
                                InternalActorRef supervisor,
                                ActorPath path,
                                boolean systemService,
                                scala.Option<Deploy> deploy,
                                boolean lookupDeploy,
                                boolean async)
Description copied from interface: ActorRefProvider
Actor factory with create-only semantics: will create an actor as described by props with the given supervisor and path (may be different in case of remote supervision). If systemService is true, deployment is bypassed (local-only). If Some(deploy) is passed in, it should be regarded as taking precedence over the nominally applicable settings, but it should be overridable from external configuration; the lookup of the latter can be suppressed by setting lookupDeploy to false.

Specified by:
actorOf in interface ActorRefProvider
Parameters:
system - (undocumented)
props - (undocumented)
supervisor - (undocumented)
path - (undocumented)
systemService - (undocumented)
deploy - (undocumented)
lookupDeploy - (undocumented)
async - (undocumented)
Returns:
(undocumented)

getExternalAddressFor

public scala.Option<Address> getExternalAddressFor(Address addr)
Description copied from interface: ActorRefProvider
Obtain the address which is to be used within sender references when sending to the given other address or none if the other address cannot be reached from this system (i.e. no means of communication known; no attempt is made to verify actual reachability).

Specified by:
getExternalAddressFor in interface ActorRefProvider
Parameters:
addr - (undocumented)
Returns:
(undocumented)

getDefaultAddress

public Address getDefaultAddress()
Description copied from interface: ActorRefProvider
Obtain the external address of the default transport.

Specified by:
getDefaultAddress in interface ActorRefProvider
Returns:
(undocumented)