Module router

Module router 

Source
Expand description

Where a connection goes when it has just authenticated.

A connection that has just proven who it is belongs to no shard yet, and the decision cannot come from a shard: none of them knows about it, and asking them all would be a broadcast for every arrival. So it is a runtime-level policy, and this is its whole surface.

It runs on the connection’s own task, never on a shard’s, which is what makes it free to await: validating a token, calling out to a service, or reading a database blocks one arrival rather than a whole shard.

REF: docs/design/guide-implementation.md 10.1

Structs§

AlwaysAttach
A router that sends everyone to the same shard.
ConnectionIdentity
What the gateway knows about a connection at the moment it must be routed.

Enums§

RouteDecision
The routing verdict.

Traits§

ConnectionRouter
The policy that answers “which shard?”.