The set of commands accepted by a Receptionist.
The set of commands accepted by a Receptionist.
Not for user Extension
Current listing of all Actors that implement the protocol given by the ServiceKey.
Current listing of all Actors that implement the protocol given by the ServiceKey.
You can use key.Listing
for type-safe pattern matching.
Not for user extension.
Confirmation that the given akka.actor.typed.ActorRef has been associated with the ServiceKey.
Confirmation that the given akka.actor.typed.ActorRef has been associated with the ServiceKey.
You can use key.Registered
for type-safe pattern matching.
Not for user extension
Query the Receptionist for a list of all Actors implementing the given protocol at one point in time.
Sent by the receptionist, available here for easier testing
Associate the given akka.actor.typed.ActorRef with the given ServiceKey.
Associate the given akka.actor.typed.ActorRef with the given ServiceKey. Multiple registrations can be made for the same key. De-registration is implied by the end of the referenced Actor’s lifecycle.
Registration will be acknowledged with the Registered message to the given replyTo actor if there is one.
Sent by the receptionist, available here for easier testing
Subscribe the given actor to service updates.
Subscribe the given actor to service updates. When new instances are registered or unregistered to the given key the given subscriber will be sent a Listing with the new set of instances for that service.
The subscription will be acknowledged by sending out a first Listing. The subscription automatically ends with the termination of the subscriber.
Lookup or create an instance of the extension identified by this id.
Lookup or create an instance of the extension identified by this id.
Create the extension, will be invoked at most one time per actor system where the extension is registered.
Create the extension, will be invoked at most one time per actor system where the extension is registered.
Java API: Query the Receptionist for a list of all Actors implementing the given protocol at one point in time.
Java API: The identifier of the extension
Java API: The identifier of the extension
Java API: Sent by the receptionist, available here for easier testing
Java API: A Register message with Ack that the service was registered
Java API: A Register message without Ack that the service was registered
Java API: Sent by the receptionist, available here for easier testing
Java API: Subscribe the given actor to service updates.
Java API: Subscribe the given actor to service updates. When new instances are registered or unregistered to the given key the given subscriber will be sent a Listing with the new set of instances for that service.
The subscription will be acknowledged by sending out a first Listing. The subscription automatically ends with the termination of the subscriber.
A Receptionist is an entry point into an Actor hierarchy where select Actors publish their identity together with the protocols that they implement. Other Actors need only know the Receptionist’s identity in order to be able to use the services of the registered Actors.
These are the messages (and the extension) for interacting with the receptionist. The receptionist is easiest accessed through the system: ActorSystem.receptionist