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

clarify semantics of name reuse/gracefulStop, see #2073

Browse source
This commit is contained in:
Roland 2012-05-16 13:43:00 +02:00
parent 3757fbd24b
commit 4256522fc8
3 changed files with 48 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -506,6 +506,18 @@ termination of several actors:
.. includecode:: code/akka/docs/actor/UntypedActorDocTestBase.java
:include: import-gracefulStop,gracefulStop
When ``gracefulStop()`` returns successfully, the actor’s ``postStop()`` hook
will have been executed: there exists a happens-before edge between the end of
``postStop()`` and the return of ``gracefulStop()``.
.. warning::
Keep in mind that an actor stopping and its name being deregistered are
separate events which happen asynchronously from each other. Therefore it may
be that you will find the name still in use after ``gracefulStop()``
returned. In order to guarantee proper deregistration, only reuse names from
within a supervisor you control and only in response to a :class:`Terminated`
message, i.e. not for top-level actors.
.. _UntypedActor.HotSwap: