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

document blocking nature of system.actorOf, see #2007

Browse source
This commit is contained in:
Roland 2012-04-23 12:25:33 +02:00
parent 4204b31759
commit 0c4b2a11ae
3 changed files with 20 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

7
akka-docs/java/untyped-actors.rst
View file

@ -82,6 +82,13 @@ that is used in log messages and for identifying actors. The name must not be em
or start with ``$``. If the given name is already in use by another child to the
same parent actor an `InvalidActorNameException` is thrown.
.. warning::
Creating top-level actors with ``system.actorOf`` is a blocking operation,
hence it may dead-lock due to starvation if the default dispatcher is
overloaded. To avoid problems, do not call this method from within actors or
futures which run on the default dispatcher.
Actors are automatically started asynchronously when created.
When you create the ``UntypedActor`` then it will automatically call the ``preStart``
callback method on the ``UntypedActor`` class. This is an excellent place to