raboof/pekko
1
0
Fork 0
Code Issues Pull requests Projects Releases 6 Packages Wiki Activity Actions 11

DOC: Correct wording about actorFor. See #2764

Browse source 
Conflicts:
	akka-docs/rst/general/addressing.rst
This commit is contained in:
Björn Antonsson 2013-02-18 13:30:12 +01:00
parent aff9cdb75e
commit 150e7036c6
1 changed files with 12 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

25
akka-docs/rst/general/addressing.rst
View file

@ -121,7 +121,7 @@ Physical Actor Paths
While the logical actor path describes the functional location within one actor While the logical actor path describes the functional location within one actor
system, configuration-based remote deployment means that an actor may be system, configuration-based remote deployment means that an actor may be
created on a different network host as its parent, i.e. within a different created on a different network host than its parent, i.e. within a different
actor system. In this case, following the actor path from the root guardian up actor system. In this case, following the actor path from the root guardian up
entails traversing the network, which is a costly operation. Therefore, each entails traversing the network, which is a costly operation. Therefore, each
actor also has a physical path, starting at the root guardian of the actor actor also has a physical path, starting at the root guardian of the actor
@ -143,7 +143,7 @@ therefore provides a translation from virtual paths to physical paths which may
change in reaction to node failures, cluster rebalancing, etc. change in reaction to node failures, cluster rebalancing, etc.
*This area is still under active development, expect updates in this section *This area is still under active development, expect updates in this section
for the 2.1 release.* for the Akka release code named Rollins .*
How are Actor References obtained? How are Actor References obtained?
---------------------------------- ----------------------------------
@ -157,7 +157,7 @@ querying the logical actor hierarchy.
concerning the facilities mentioned below, the exact semantics of clustered concerning the facilities mentioned below, the exact semantics of clustered
actor references and their paths—while certainly as similar as possible—may actor references and their paths—while certainly as similar as possible—may
differ in certain aspects, owing to the virtual nature of those paths. Expect differ in certain aspects, owing to the virtual nature of those paths. Expect
updates for the 2.1 release.* updates for the Akka release code named Rollins.*
Creating Actors Creating Actors
^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^
@ -174,16 +174,15 @@ Looking up Actors by Concrete Path
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
In addition, actor references may be looked up using the In addition, actor references may be looked up using the
:meth:`ActorSystem.actorFor` method, which returns an (unverified) local, remote :meth:`ActorSystem.actorFor` method, which returns a local or remote actor
or clustered actor reference. Sending messages to such a reference or attempting reference. The reference can be reused for communicating with said actor during
to observe its liveness will traverse the actor hierarchy of the actor system the whole lifetime of the actor. In the case of a local actor reference, the
from top to bottom by passing messages from parent to child until either the named actor needs to exist before the lookup, or else the acquired reference
target is reached or failure is certain, i.e. a name in the path does not exist will be an :class:`EmptyLocalActorRef`. This will be true even if an actor with
(in practice this process will be optimized using caches, but it still has added that exact path is created after acquiring the actor reference. For remote actor
cost compared to using the physical actor path, which can for example be references the behaviour is different and sending messages to such a reference
obtained from the sender reference included in replies from that actor). Akka will under the hood look up the actor by path on the remote system for every
handles message passing automatically, so this process is not visible to client message send.
code.
Absolute vs. Relative Paths Absolute vs. Relative Paths
``````````````````````````` ```````````````````````````