Glossary
Core classes
DiscordClient
Main REST API wrapper, and an entry point to spawn Gateway connections. Can be obtained by calling getClient().rest()
from most objects.
CoreResources
A mediator for resources essential to operate on DiscordClient
, like the RestClient
, JacksonResources
and ReactorResources
.
GatewayDiscordClient
Discord Gateway is the websocket connection receiving real-time updates. In v3.1 we call GatewayDiscordClient
to the manager of all resources and state regarding all participating shards. Connections are maintained by it and is capable of giving access to cached entities from updates. Can be obtained by calling getClient()
from most objects.
GatewayBootstrap
A builder to create a GatewayDiscordClient
. The place where resources and many configurations are set before connecting to Discord Gateway. Defaults are used to enable built-in sharding and can be customized in many ways.
GatewayClient
The same component as in v3.0, it keeps all state regarding a single shard lifecycle, providing automatic reconnections and forwarding updates to the parent GatewayDiscordClient
.
GatewayResources
A mediator for most resources required by a GatewayClient
to operate. The rest are provided during GatewayBootstrap
setup and are used to build GatewayOptions
.
GatewayOptions
The set of configuration passed to a GatewayClient
in order to be created.
ShardCoordinator
A manager in charge of relaying lifecycle events for sharding. It is used to notify clients that shards are identifying, connecting or disconnecting to allow for distributed application scenarios where the notification may be relayed across boundaries.
StateHolder
The same component as in v3.0, it stores all entity updates from the Gateway. In v3.1 though, it will receive updates from all joining shards.
EventDispatcher
The same component as in v3.0, it publishes Gateway events to the user. In v3.1 the events are coming from all shards, so a single instance is enough for a GatewayDiscordClient
.
ReactorResources
Encapsulates Reactor Netty HttpClient and Scheduler for blocking and timed tasks, can be customized.
JacksonResources
Jackson ObjectMapper configured specifically for Discord4J, can be customized.
RouterFactory
Factory to create a Router
which performs REST API requests. Can be customized to coordinate multiple instances.