Skip to content

Commit 5b3a4d6

Browse files
committed
+docs receptionist checkout docs
1 parent d98bcea commit 5b3a4d6

File tree

1 file changed

+4
-3
lines changed

1 file changed

+4
-3
lines changed

Sources/DistributedActors/Docs.docc/Receptionist.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -103,6 +103,7 @@ distributed actor Boss: LifecycleWatch {
103103

104104
### Checking-out from receptionist listings
105105

106-
In general, the receptionist should not be used as means of implementing "presence" in the sense of a specific
107-
actor checking in and out of the receptionist as it sees fit, e.g. to signal "I am now available again!". Such
108-
patterns are to be implemented in the application layer of your system, and should be done b
106+
Checking out of the receptionist is performed automatically when a previously checked-in actor is terminated,
107+
be it by the node that it was located on terminating, or the actor itself being deallocated.
108+
109+
There is no explicit API for checking out an actor. The receptionist should not be used to aggressively add and remove the same actor, but instead publish actors which are supposed to be well known and relatively stable contact points. For aggressively added/removed actors, it is recommended to handle this on the application level, by one well known actor managing the handing out of references. This way it also is possible to more tightly check where and how actor references are handed out.

0 commit comments

Comments
 (0)