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

add FAQ entry for careful ActorSystem creation, #15313

Browse source
This commit is contained in:
Roland Kuhn 2016-03-09 22:30:08 +01:00
parent 392cb75af4
commit 2925f1eb99
1 changed files with 12 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

12
akka-docs/rst/additional/faq.rst
View file

@ -25,6 +25,18 @@ Akka is also:
* a town in Morocco
* a near-earth asteroid
Resources with Explicit Lifecycle
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Actors, ActorSystems, ActorMaterializers (for streams), all these types of objects bind
resources that must be released explicitly. The reason is that Actors are meant to have
a life of their own, existing independently of whether messages are currently en route
to them. Therefore you should always make sure that for every creation of such an object
you have a matching ``stop``, ``terminate``, or ``shutdown`` call implemented.
In particular you typically want to bind such values to immutable references, i.e.
``final ActorSystem system`` in Java or ``val system: ActorSystem`` in Scala.
Actors in General
^^^^^^^^^^^^^^^^^