java.lang.Object

net.dv8tion.jda.api.sharding.DefaultShardManager

All Implemented Interfaces:: IGuildChannelContainer<Channel>, ShardManager

public class DefaultShardManager extends Object implements ShardManager

JDA's default ShardManager implementation. To create new instances use the DefaultShardManagerBuilder.

Since:: 3.4
Author:: Aljoscha Grebe

Field Summary

Fields

Modifier and Type

Field

Description

static final ThreadFactory

DEFAULT_THREAD_FACTORY

static final org.slf4j.Logger

LOG
Constructor Summary

Constructors

Constructor

Description

DefaultShardManager(String token)

DefaultShardManager(String token, Collection<Integer> shardIds)

DefaultShardManager(String token, Collection<Integer> shardIds, net.dv8tion.jda.internal.utils.config.sharding.ShardingConfig shardingConfig, net.dv8tion.jda.internal.utils.config.sharding.EventConfig eventConfig, net.dv8tion.jda.internal.utils.config.sharding.PresenceProviderConfig presenceConfig, net.dv8tion.jda.internal.utils.config.sharding.ThreadingProviderConfig threadingConfig, net.dv8tion.jda.internal.utils.config.sharding.ShardingSessionConfig sessionConfig, net.dv8tion.jda.internal.utils.config.sharding.ShardingMetaConfig metaConfig, IntFunction<? extends RestConfig> restConfigProvider, ChunkingFilter chunkingFilter)
Method Summary

Modifier and Type

Method

Description

void

addEventListener(Object... listeners)

Adds all provided listeners to the event-listeners that will be used to handle events.

void

addEventListeners(IntFunction<Object> eventListenerProvider)

Adds listeners provided by the listener provider to each shard to the event-listeners that will be used to handle events.

EnumSet<GatewayIntent>

getGatewayIntents()

The GatewayIntents for the JDA sessions of this shard manager.

Guild

getGuildById(long id)

This returns the Guild which has the same id as the one provided.

ShardCacheView

getShardCache()

Unified ShardCacheView of all cached JDA bound to this ShardManager instance.

int

getShardsQueued()

Returns the amount of shards queued for (re)connecting.

int

getShardsTotal()

Returns the amount of shards managed by this ShardManager.

void

login()

Initializes and starts all shards.

void

removeEventListener(Object... listeners)

Removes all provided listeners from the event-listeners and no longer uses them to handle events.

void

removeEventListenerProvider(IntFunction<Object> eventListenerProvider)

Remove a listener provider.

void

restart()

Restarts all shards, shutting old ones down first.

void

restart(int shardId)

Restarts the shards with the given id only.

void

setActivityProvider(IntFunction<? extends Activity> activityProvider)

Sets provider that provider the Activity for all shards.

void

setIdleProvider(IntFunction<Boolean> idleProvider)

Sets the provider that decides for all shards whether they should be marked as afk or not.

void

setPresenceProvider(IntFunction<OnlineStatus> statusProvider, IntFunction<? extends Activity> activityProvider)

Sets the provider that provides the OnlineStatus and Activity for all shards.

void

setStatusProvider(IntFunction<OnlineStatus> statusProvider)

Sets the provider that provides the OnlineStatus for all shards.

void

shutdown()

Shuts down all JDA shards, closing all their connections.

void

shutdown(int shardId)

Shuts down the shard with the given id only.

void

start(int shardId)

Adds a new shard with the given id to this ShardManager and starts it.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface net.dv8tion.jda.api.entities.channel.attribute.IGuildChannelContainer
getCategories, getCategoriesByName, getCategoryById, getCategoryById, getChannelById, getChannelById, getForumChannelById, getForumChannelById, getForumChannels, getForumChannelsByName, getGuildChannelById, getGuildChannelById, getMediaChannelById, getMediaChannelById, getMediaChannels, getMediaChannelsByName, getNewsChannelById, getNewsChannelById, getNewsChannels, getNewsChannelsByName, getStageChannelById, getStageChannelById, getStageChannels, getStageChannelsByName, getTextChannelById, getTextChannelById, getTextChannels, getTextChannelsByName, getThreadChannelById, getThreadChannelById, getThreadChannels, getThreadChannelsByName, getVoiceChannelById, getVoiceChannelById, getVoiceChannels, getVoiceChannelsByName

Methods inherited from interface net.dv8tion.jda.api.sharding.ShardManager
getAverageGatewayPing, getCategoryCache, getChannelCache, getEmojiById, getEmojiById, getEmojiCache, getEmojis, getEmojisByName, getForumChannelCache, getGuildById, getGuildCache, getGuildChannelById, getGuildChannelById, getGuilds, getGuildsByName, getMediaChannelCache, getMutualGuilds, getMutualGuilds, getNewsChannelCache, getPrivateChannelById, getPrivateChannelById, getPrivateChannelCache, getPrivateChannels, getRoleById, getRoleById, getRoleCache, getRoles, getRolesByName, getShardById, getShardById, getShards, getShardsRunning, getStageChannelCache, getStatus, getStatuses, getTextChannelCache, getThreadChannelCache, getUserById, getUserById, getUserByTag, getUserByTag, getUserCache, getUsers, getVoiceChannelCache, removeEventListeners, retrieveApplicationInfo, retrieveUserById, retrieveUserById, setActivity, setIdle, setPresence, setStatus

Field Details
- LOG
  
  public static final org.slf4j.Logger LOG
- DEFAULT_THREAD_FACTORY
  
  public static final ThreadFactory DEFAULT_THREAD_FACTORY
Constructor Details
- DefaultShardManager
  
  public DefaultShardManager(@Nonnull String token)
- DefaultShardManager
  
  public DefaultShardManager(@Nonnull String token, @Nullable Collection<Integer> shardIds)
- DefaultShardManager
  
  public DefaultShardManager(@Nonnull String token, @Nullable Collection<Integer> shardIds, @Nullable net.dv8tion.jda.internal.utils.config.sharding.ShardingConfig shardingConfig, @Nullable net.dv8tion.jda.internal.utils.config.sharding.EventConfig eventConfig, @Nullable net.dv8tion.jda.internal.utils.config.sharding.PresenceProviderConfig presenceConfig, @Nullable net.dv8tion.jda.internal.utils.config.sharding.ThreadingProviderConfig threadingConfig, @Nullable net.dv8tion.jda.internal.utils.config.sharding.ShardingSessionConfig sessionConfig, @Nullable net.dv8tion.jda.internal.utils.config.sharding.ShardingMetaConfig metaConfig, @Nullable IntFunction<? extends RestConfig> restConfigProvider, @Nullable ChunkingFilter chunkingFilter)
Method Details
- getGatewayIntents
  
  @Nonnull public EnumSet<GatewayIntent> getGatewayIntents()
  
  Description copied from interface: ShardManager
  
  The GatewayIntents for the JDA sessions of this shard manager.
  
  Specified by:
  
  getGatewayIntents in interface ShardManager
  
  Returns:
  
  EnumSet of active gateway intents
- addEventListener
  
  public void addEventListener(@Nonnull Object... listeners)
  
  Description copied from interface: ShardManager
  
  Adds all provided listeners to the event-listeners that will be used to handle events.
  Note: when using the InterfacedEventListener (default), the given listener must be an instance of EventListener!
  
  Specified by:
  
  addEventListener in interface ShardManager
  
  Parameters:
  
  listeners - The listener(s) which will react to events.
- removeEventListener
  
  public void removeEventListener(@Nonnull Object... listeners)
  
  Description copied from interface: ShardManager
  
  Removes all provided listeners from the event-listeners and no longer uses them to handle events.
  
  Specified by:
  
  removeEventListener in interface ShardManager
  
  Parameters:
  
  listeners - The listener(s) to be removed.
- addEventListeners
  
  public void addEventListeners(@Nonnull IntFunction<Object> eventListenerProvider)
  
  Description copied from interface: ShardManager
  
  Adds listeners provided by the listener provider to each shard to the event-listeners that will be used to handle events. The listener provider gets a shard id applied and is expected to return a listener.
  Note: when using the InterfacedEventListener (default), the given listener must be an instance of EventListener!
  
  Specified by:
  
  addEventListeners in interface ShardManager
  
  Parameters:
  
  eventListenerProvider - The provider of listener(s) which will react to events.
- removeEventListenerProvider
  
  public void removeEventListenerProvider(@Nonnull IntFunction<Object> eventListenerProvider)
  
  Description copied from interface: ShardManager
  
  Remove a listener provider. This will stop further created / restarted shards from getting a listener added by that provider.
  Default is a no-op for backwards compatibility, see implementations like removeEventListenerProvider(IntFunction) for actual code
  
  Specified by:
  
  removeEventListenerProvider in interface ShardManager
  
  Parameters:
  
  eventListenerProvider - The provider of listeners that shall be removed.
- getShardsQueued
  
  public int getShardsQueued()
  
  Description copied from interface: ShardManager
  
  Returns the amount of shards queued for (re)connecting.
  
  Specified by:
  
  getShardsQueued in interface ShardManager
  
  Returns:
  
  The amount of shards queued for (re)connecting.
- getShardsTotal
  
  public int getShardsTotal()
  
  Description copied from interface: ShardManager
  
  Returns the amount of shards managed by this ShardManager. This includes shards currently queued for a restart.
  
  Specified by:
  
  getShardsTotal in interface ShardManager
  
  Returns:
  
  The managed amount of shards.
- getGuildById
  
  @Nullable public Guild getGuildById(long id)
  
  Description copied from interface: ShardManager
  
  This returns the Guild which has the same id as the one provided.
  If there is no connected guild with an id that matches the provided one, this will return null.
  
  Specified by:
  
  getGuildById in interface ShardManager
  
  Parameters:
  
  id - The id of the Guild.
  
  Returns:
  
  Possibly-null Guild with matching id.
- getShardCache
  
  @Nonnull public ShardCacheView getShardCache()
  
  Description copied from interface: ShardManager
  
  Unified ShardCacheView of all cached JDA bound to this ShardManager instance.
  
  Specified by:
  
  getShardCache in interface ShardManager
  
  Returns:
  
  Unified ShardCacheView
- login
  
  public void login()
  
  Description copied from interface: ShardManager
  
  Initializes and starts all shards. This should only be called once.
  
  Specified by:
  
  login in interface ShardManager
- restart
  
  public void restart(int shardId)
  
  Description copied from interface: ShardManager
  
  Restarts the shards with the given id only.
  If there is no shard with the given Id, this method acts like ShardManager.start(int).
  
  Specified by:
  
  restart in interface ShardManager
  
  Parameters:
  
  shardId - The id of the target shard
- restart
  
  public void restart()
  
  Description copied from interface: ShardManager
  
  Restarts all shards, shutting old ones down first.
  As all shards need to connect to discord again this will take equally long as the startup of a new ShardManager (using the 5000ms + backoff as delay between starting new JDA instances).
  
  Specified by:
  
  restart in interface ShardManager
- shutdown
  
  public void shutdown()
  
  Description copied from interface: ShardManager
  
  Shuts down all JDA shards, closing all their connections. After this method has been called the ShardManager instance can not be used anymore.
  This will shutdown the internal queue worker for (re-)starts of shards. This means ShardManager.restart(int), ShardManager.restart(), and ShardManager.start(int) will throw RejectedExecutionException.
  This will interrupt the default JDA event thread, due to the gateway connection being interrupted.
  
  Specified by:
  
  shutdown in interface ShardManager
- shutdown
  
  public void shutdown(int shardId)
  
  Description copied from interface: ShardManager
  
  Shuts down the shard with the given id only.
  If there is no shard with the given id, this will do nothing.
  
  Specified by:
  
  shutdown in interface ShardManager
  
  Parameters:
  
  shardId - The id of the shard that should be stopped
- start
  
  public void start(int shardId)
  
  Description copied from interface: ShardManager
  
  Adds a new shard with the given id to this ShardManager and starts it.
  
  Specified by:
  
  start in interface ShardManager
  
  Parameters:
  
  shardId - The id of the shard that should be started
- setActivityProvider
  
  public void setActivityProvider(IntFunction<? extends Activity> activityProvider)
  
  Description copied from interface: ShardManager
  
  Sets provider that provider the Activity for all shards.
  A Activity can be retrieved via Activity.playing(String). For streams you provide a valid streaming url as second parameter.
  This will also change the provider for shards that are created in the future.
  Specified by:
  
  setActivityProvider in interface ShardManager
  
  Parameters:
  
  activityProvider - Provider for an Activity instance or null to reset
  
  See Also:
  
  Activity.playing(String)
  
  Activity.streaming(String, String)
- setIdleProvider
  
  public void setIdleProvider(@Nonnull IntFunction<Boolean> idleProvider)
  
  Description copied from interface: ShardManager
  
  Sets the provider that decides for all shards whether they should be marked as afk or not.
  This will also change the provider for shards that are created in the future.
  
  Specified by:
  
  setIdleProvider in interface ShardManager
  
  Parameters:
  
  idleProvider - Provider for a boolean
- setPresenceProvider
  
  public void setPresenceProvider(IntFunction<OnlineStatus> statusProvider, IntFunction<? extends Activity> activityProvider)
  
  Description copied from interface: ShardManager
  
  Sets the provider that provides the OnlineStatus and Activity for all shards.
  This will also change the status for shards that are created in the future.
  Specified by:
  
  setPresenceProvider in interface ShardManager
  
  Parameters:
  
  statusProvider - The OnlineStatus to be used (OFFLINE/null -> INVISIBLE)
  
  activityProvider - A Activity instance or null to reset
  
  See Also:
  
  Activity.playing(String)
  
  Activity.streaming(String, String)
- setStatusProvider
  
  public void setStatusProvider(IntFunction<OnlineStatus> statusProvider)
  
  Description copied from interface: ShardManager
  
  Sets the provider that provides the OnlineStatus for all shards.
  This will also change the provider for shards that are created in the future.
  
  Specified by:
  
  setStatusProvider in interface ShardManager
  
  Parameters:
  
  statusProvider - The OnlineStatus to be used (OFFLINE/null -> INVISIBLE)

Class DefaultShardManager

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface net.dv8tion.jda.api.entities.channel.attribute.IGuildChannelContainer

Methods inherited from interface net.dv8tion.jda.api.sharding.ShardManager

Field Details

LOG

DEFAULT_THREAD_FACTORY

Constructor Details

DefaultShardManager

DefaultShardManager

DefaultShardManager

Method Details

getGatewayIntents

addEventListener

removeEventListener

addEventListeners

removeEventListenerProvider

getShardsQueued

getShardsTotal

getGuildById

getShardCache

login

restart

restart

shutdown

shutdown

start

setActivityProvider

setIdleProvider

setPresenceProvider

setStatusProvider