JDAImpl (JDA 1.2.2

java.lang.Object
- net.dv8tion.jda.entities.impl.JDAImpl

All Implemented Interfaces:

JDA
```
public class JDAImpl
extends java.lang.Object
implements JDA
```
Represents the core of the Discord API. All functionality is connected through this.

Constructor Summary

Constructors
Constructor and Description

JDAImpl()

JDAImpl(java.lang.String proxyUrl, int proxyPort)

Constructors
Constructor and Description
`JDAImpl()`
`JDAImpl(java.lang.String proxyUrl, int proxyPort)`

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`ack(Message msg)` Acks a specific message.
`void`	`addEventListener(java.lang.Object listener)` Adds an Object to the event-listeners that will be used to handle events.
`GuildManager`	`createGuild(java.lang.String name)` Deprecated.
`GuildManager`	`createGuild(java.lang.String name, Region region)` Creates a new `Guild`.
`void`	`createGuildAsync(java.lang.String name, java.util.function.Consumer<GuildManager> callback)` Deprecated.
`void`	`createGuildAsync(java.lang.String name, Region region, java.util.function.Consumer<GuildManager> callback)` Creates a new `Guild`.
`AccountManager`	`getAccountManager()` Returns the `AccountManager` for the currently logged in account. Account settings can only be modified using this object.
`AudioManager`	`getAudioManager()` Returns the `AudioManager` for this `JDA` instance.
`java.lang.String`	`getAuthToken()` The login token that is currently being used for Discord authentication.
`java.util.Map<java.lang.String,TextChannel>`	`getChannelMap()`
`WebSocketClient`	`getClient()`
`IEventManager`	`getEventManager()`
`org.apache.http.HttpHost`	`getGlobalProxy()` The proxy settings used by all JDA instances.
`Guild`	`getGuildById(java.lang.String id)` This returns the `Guild` which has the same id as the one provided. If there is no known guild with an id that matches the provided one, then this returns `null`.
`java.util.Map<java.lang.String,Guild>`	`getGuildMap()`
`java.util.List<Guild>`	`getGuilds()` An unmodifiable list of all `Guilds` that this account is connected to. If this account is not connected to any `Guilds`, this will return an empty list.
`java.util.List<Guild>`	`getGuildsByName(java.lang.String name)` An unmodifiable list of all `Guilds` that have the same name as the one provided. If there are no `Guilds` with the provided name, then this returns an empty list.
`java.lang.Long`	`getMessageLimit()`
`java.util.Map<java.lang.String,java.lang.String>`	`getOffline_pms()`
`java.util.Map<java.lang.String,PrivateChannel>`	`getPmChannelMap()`
`PrivateChannel`	`getPrivateChannelById(java.lang.String id)` This returns the `PrivateChannel` which has the same id as the one provided. If there is no known `PrivateChannel` with an id that matches the provided one, then this returns `null`.
`java.util.List<PrivateChannel>`	`getPrivateChannels()` An unmodifiable list of all known `PrivateChannels`.
`Requester`	`getRequester()`
`int`	`getResponseTotal()` This value is the total amount of JSON responses that discord has sent. This value resets every time the websocket has to reconnect.
`SelfInfo`	`getSelfInfo()` Returns the currently logged in account represented by `SelfInfo`. Account settings cannot be modified using this object.
`TextChannel`	`getTextChannelById(java.lang.String id)` This returns the `TextChannel` which has the same id as the one provided. If there is no known `TextChannel` with an id that matches the provided one, then this returns `null`.
`java.util.List<TextChannel>`	`getTextChannels()` An unmodifiable list of all `TextChannels` of all `Guilds` that this account is a member of.
`java.util.List<TextChannel>`	`getTextChannelsByName(java.lang.String name)` An unmodifiable list of all `TextChannels` that have the same name as the one provided. If there are no `TextChannels` with the provided name, then this returns an empty list.
`User`	`getUserById(java.lang.String id)` This returns the `User` who has the same id as the one provided. If there is no known user with an id that matches the provided one, this this returns `null`.
`java.util.Map<java.lang.String,User>`	`getUserMap()`
`java.util.List<User>`	`getUsers()` An unmodifiable list of all known `Users`. This list will never contain duplicates and represents all `Users` that JDA can currently see.
`java.util.List<User>`	`getUsersByName(java.lang.String name)` This unmodifiable returns all `Users` that have the same username as the one provided. If there are no `Users` with the provided name, then this returns an empty list.
`VoiceChannel`	`getVoiceChannelById(java.lang.String id)` This returns the `VoiceChannel` which has the same id as the one provided. If there is no known `VoiceChannel` with an id that matches the provided one, then this returns `null`.
`java.util.List<VoiceChannel>`	`getVoiceChannelByName(java.lang.String name)` An unmodifiable list of all `VoiceChannels` that have the same name as the one provided. If there are no `VoiceChannels` with the provided name, then this returns an empty list.
`java.util.Map<java.lang.String,VoiceChannel>`	`getVoiceChannelMap()`
`java.util.List<VoiceChannel>`	`getVoiceChannels()` An unmodifiable list of all `VoiceChannels` of all `Guilds` that this account is a member of.
`boolean`	`isAckAllowed()`
`boolean`	`isDebug()` Used to determine if JDA is currently in debug mode.
`void`	`login(java.lang.String email, java.lang.String password)` Attempts to login to Discord.
`void`	`removeEventListener(java.lang.Object listener)` Removes the provided Object from the event-listeners and no longer uses it to handle events.
`void`	`setAllowAck(boolean enable)` Enables or disables the ack functionality of JDA. Read the Javadocs of `ack(Message)` for guidelines on how and when to ack!
`void`	`setAuthToken(java.lang.String token)`
`void`	`setDebug(boolean enableDebug)` Used to enable JDA debug output.
`void`	`setEventManager(IEventManager manager)` Changes the internal EventManager.
`void`	`setMessageTimeout(long timeout)`
`void`	`setResponseTotal(int responseTotal)`
`void`	`setSelfInfo(SelfInfo selfInfo)`
`void`	`shutdown()` Shuts down JDA, closing all its connections.
`void`	`shutdown(boolean free)` Shuts down JDA, closing all its connections.

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

- Constructor Detail
  - JDAImpl
```
public JDAImpl()
```
  - JDAImpl
```
public JDAImpl(java.lang.String proxyUrl,
               int proxyPort)
```
- Method Detail
  - login
```
public void login(java.lang.String email,
                  java.lang.String password)
           throws java.lang.IllegalArgumentException,
                  javax.security.auth.login.LoginException
```
    Attempts to login to Discord. Upon successful auth with Discord, a token is generated and stored in token.json.
    
    Parameters:
    
    email - The email of the account attempting to log in.
    
    password - The password of the account attempting to log in.
    
    Throws:
    
    java.lang.IllegalArgumentException - Thrown if this email or password provided are empty or null.
    
    javax.security.auth.login.LoginException - Thrown if the email-password combination fails the auth check with the Discord servers.
  - getAuthToken
```
public java.lang.String getAuthToken()
```
    Description copied from interface: JDA
    
    The login token that is currently being used for Discord authentication.
    
    Specified by:
    
    getAuthToken in interface JDA
    
    Returns:
    
    Never-null, 18 character length string containing the auth token.
  - setAuthToken
```
public void setAuthToken(java.lang.String token)
```
  - setEventManager
```
public void setEventManager(IEventManager manager)
```
    Description copied from interface: JDA
    
    Changes the internal EventManager. The default EventManager is InterfacedEventListener. There is also an AnnotatedEventManager available.
    
    Specified by:
    
    setEventManager in interface JDA
    
    Parameters:
    
    manager - The new EventManager to use
  - addEventListener
```
public void addEventListener(java.lang.Object listener)
```
    Description copied from interface: JDA
    
    Adds an Object to the event-listeners that will be used to handle events. This uses the InterfacedEventListener by default. To switch to the AnnotatedEventManager, use JDA.setEventManager(IEventManager). Note: when using the InterfacedEventListener (default), given listener must be instance of EventListener!
    
    Specified by:
    
    addEventListener in interface JDA
    
    Parameters:
    
    listener - The listener
  - removeEventListener
```
public void removeEventListener(java.lang.Object listener)
```
    Description copied from interface: JDA
    
    Removes the provided Object from the event-listeners and no longer uses it to handle events.
    
    Specified by:
    
    removeEventListener in interface JDA
    
    Parameters:
    
    listener - The listener to be removed.
  - getEventManager
```
public IEventManager getEventManager()
```
  - getClient
```
public WebSocketClient getClient()
```
  - getUserMap
```
public java.util.Map<java.lang.String,User> getUserMap()
```
  - getUsers
```
public java.util.List<User> getUsers()
```
    Description copied from interface: JDA
    
    An unmodifiable list of all known Users.
    This list will never contain duplicates and represents all Users that JDA can currently see.
    
    Specified by:
    
    getUsers in interface JDA
    
    Returns:
    
    List of all known Users.
  - getUserById
```
public User getUserById(java.lang.String id)
```
    Description copied from interface: JDA
    
    This returns the User who has the same id as the one provided.
    If there is no known user with an id that matches the provided one, this this returns null.
    
    Specified by:
    
    getUserById in interface JDA
    
    Parameters:
    
    id - The id of the User.
    
    Returns:
    
    Possibly-null User with matching id.
  - getUsersByName
```
public java.util.List<User> getUsersByName(java.lang.String name)
```
    Description copied from interface: JDA
    
    This unmodifiable returns all Users that have the same username as the one provided.
    If there are no Users with the provided name, then this returns an empty list.
    
    Specified by:
    
    getUsersByName in interface JDA
    
    Parameters:
    
    name - The name of the requested Users.
    
    Returns:
    
    Possibly-empty list of Users that all have the same name as the provided name.
  - getGuildMap
```
public java.util.Map<java.lang.String,Guild> getGuildMap()
```
  - getGuilds
```
public java.util.List<Guild> getGuilds()
```
    Description copied from interface: JDA
    
    An unmodifiable list of all Guilds that this account is connected to.
    If this account is not connected to any Guilds, this will return an empty list.
    
    Specified by:
    
    getGuilds in interface JDA
    
    Returns:
    
    Possibly-empty list of all the Guilds that this account is connected to.
  - getGuildsByName
```
public java.util.List<Guild> getGuildsByName(java.lang.String name)
```
    Description copied from interface: JDA
    
    An unmodifiable list of all Guilds that have the same name as the one provided.
    If there are no Guilds with the provided name, then this returns an empty list.
    
    Specified by:
    
    getGuildsByName in interface JDA
    
    Parameters:
    
    name - The name of the requested Guilds.
    
    Returns:
    
    Possibly-empty list of all the Guilds that all have the same name as the provided name.
  - getTextChannelsByName
```
public java.util.List<TextChannel> getTextChannelsByName(java.lang.String name)
```
    Description copied from interface: JDA
    
    An unmodifiable list of all TextChannels that have the same name as the one provided.
    If there are no TextChannels with the provided name, then this returns an empty list.
    Note: just because a TextChannel is present in this list does not mean that you will be able to send messages to it. Furthermore, if you log into this account on the discord client, it is possible that you will see fewer channels than this returns. This is because the discord client hides any TextChannel that you don't have the Permission.MESSAGE_READ permission in.
    
    Specified by:
    
    getTextChannelsByName in interface JDA
    
    Parameters:
    
    name - The name of the requested TextChannels.
    
    Returns:
    
    Possibly-empty list of all the TextChannels that all have the same name as the provided name.
  - getVoiceChannelByName
```
public java.util.List<VoiceChannel> getVoiceChannelByName(java.lang.String name)
```
    Description copied from interface: JDA
    
    An unmodifiable list of all VoiceChannels that have the same name as the one provided.
    If there are no VoiceChannels with the provided name, then this returns an empty list.
    
    Specified by:
    
    getVoiceChannelByName in interface JDA
    
    Parameters:
    
    name - The name of the requested VoiceChannels.
    
    Returns:
    
    Possibly-empty list of all the VoiceChannels that all have the same name as the provided name.
  - getPrivateChannels
```
public java.util.List<PrivateChannel> getPrivateChannels()
```
    Description copied from interface: JDA
    
    An unmodifiable list of all known PrivateChannels.
    
    Specified by:
    
    getPrivateChannels in interface JDA
    
    Returns:
    
    Possibly-empty list of all PrivateChannels.
  - createGuild
```
@Deprecated
public GuildManager createGuild(java.lang.String name)
```
    Deprecated.
    
    Description copied from interface: JDA
    
    This method is deprecated! please switch to JDA.createGuild(String, Region). Creates a new Guild. This will a return the Manager to the existing, but still empty Guild (no members, no channels). To create a Guild asynchronously (wait for generation of #general chat), use JDA.createGuildAsync(String, Consumer) instead. In the very rare case, that the Discord-server has problems, The created guild can be unavailable until it is actually created. In that case, this will return null.
    
    Specified by:
    
    createGuild in interface JDA
    
    Parameters:
    
    name - the name of the new Guild
    
    Returns:
    
    the GuildManager for the created Guild, or null, if the created Guild is temporarily unavailable
  - createGuild
```
public GuildManager createGuild(java.lang.String name,
                                Region region)
```
    Description copied from interface: JDA
    
    Creates a new Guild. This will a return the Manager to the existing, but still empty Guild (no members, no channels). To create a Guild asynchronously (wait for generation of #general chat), use JDA.createGuildAsync(String, Consumer) instead. In the very rare case, that the Discord-server has problems, The created guild can be unavailable until it is actually created. In that case, this will return null.
    
    Specified by:
    
    createGuild in interface JDA
    
    Parameters:
    
    name - the name of the new Guild
    
    region - the region of the new Guild
    
    Returns:
    
    the GuildManager for the created Guild, or null, if the created Guild is temporarily unavailable
  - createGuildAsync
```
@Deprecated
public void createGuildAsync(java.lang.String name,
                                          java.util.function.Consumer<GuildManager> callback)
```
    Deprecated.
    
    Description copied from interface: JDA
    
    This method is deprecated! please switch to JDA.createGuildAsync(String, Region, Consumer). Creates a new Guild. This function will wait until the Guild was fully created by the Discord-Server (default channels,...), and then call the provided callback-function with the GuildManager-object To create a Guild synchronously, use JDA.createGuild(String) instead
    
    Specified by:
    
    createGuildAsync in interface JDA
    
    Parameters:
    
    name - the name of the new Guild
    
    callback - the callback-function that gets called once the guild was fully initialized
  - createGuildAsync
```
public void createGuildAsync(java.lang.String name,
                             Region region,
                             java.util.function.Consumer<GuildManager> callback)
```
    Description copied from interface: JDA
    
    Creates a new Guild. This function will wait until the Guild was fully created by the Discord-Server (default channels,...), and then call the provided callback-function with the GuildManager-object To create a Guild synchronously, use JDA.createGuild(String) instead
    
    Specified by:
    
    createGuildAsync in interface JDA
    
    Parameters:
    
    name - the name of the new Guild
    
    region - the region of the new Guild
    
    callback - the callback-function that gets called once the guild was fully initialized
  - getGuildById
```
public Guild getGuildById(java.lang.String id)
```
    Description copied from interface: JDA
    
    This returns the Guild which has the same id as the one provided.
    If there is no known guild with an id that matches the provided one, then this returns null.
    
    Specified by:
    
    getGuildById in interface JDA
    
    Parameters:
    
    id - The id of the Guild.
    
    Returns:
    
    Possibly-null Guild with matching id.
  - getChannelMap
```
public java.util.Map<java.lang.String,TextChannel> getChannelMap()
```
  - getTextChannels
```
public java.util.List<TextChannel> getTextChannels()
```
    Description copied from interface: JDA
    
    An unmodifiable list of all TextChannels of all Guilds that this account is a member of.
    Note: just because a TextChannel is present in this list does not mean that you will be able to send messages to it. Furthermore, if you log into this account on the discord client, it is possible that you will see fewer channels than this returns. This is because the discord client hides any TextChannel that you don't have the Permission.MESSAGE_READ permission in.
    
    Specified by:
    
    getTextChannels in interface JDA
    
    Returns:
    
    Possibly-empty list of all known TextChannels.
  - getTextChannelById
```
public TextChannel getTextChannelById(java.lang.String id)
```
    Description copied from interface: JDA
    
    This returns the TextChannel which has the same id as the one provided.
    If there is no known TextChannel with an id that matches the provided one, then this returns null.
    Note: just because a TextChannel is present does not mean that you will be able to send messages to it. Furthermore, if you log into this account on the discord client, it is you will not see the channel that this returns. This is because the discord client hides any TextChannel that you don't have the Permission.MESSAGE_READ permission in.
    
    Specified by:
    
    getTextChannelById in interface JDA
    
    Parameters:
    
    id - The id of the TextChannel.
    
    Returns:
    
    Possibly-null TextChannel with matching id.
  - getVoiceChannelMap
```
public java.util.Map<java.lang.String,VoiceChannel> getVoiceChannelMap()
```
  - getVoiceChannels
```
public java.util.List<VoiceChannel> getVoiceChannels()
```
    Description copied from interface: JDA
    
    An unmodifiable list of all VoiceChannels of all Guilds that this account is a member of.
    
    Specified by:
    
    getVoiceChannels in interface JDA
    
    Returns:
    
    Possible-empty list of all known VoiceChannels.
  - getVoiceChannelById
```
public VoiceChannel getVoiceChannelById(java.lang.String id)
```
    Description copied from interface: JDA
    
    This returns the VoiceChannel which has the same id as the one provided.
    If there is no known VoiceChannel with an id that matches the provided one, then this returns null.
    
    Specified by:
    
    getVoiceChannelById in interface JDA
    
    Parameters:
    
    id - The id of the VoiceChannel.
    
    Returns:
    
    Possibly-null VoiceChannel with matching id.
  - getPrivateChannelById
```
public PrivateChannel getPrivateChannelById(java.lang.String id)
```
    Description copied from interface: JDA
    
    This returns the PrivateChannel which has the same id as the one provided.
    If there is no known PrivateChannel with an id that matches the provided one, then this returns null.
    
    Specified by:
    
    getPrivateChannelById in interface JDA
    
    Parameters:
    
    id - The id of the PrivateChannel.
    
    Returns:
    
    Possibly-null PrivateChannel with matching id.
  - getPmChannelMap
```
public java.util.Map<java.lang.String,PrivateChannel> getPmChannelMap()
```
  - getOffline_pms
```
public java.util.Map<java.lang.String,java.lang.String> getOffline_pms()
```
  - getSelfInfo
```
public SelfInfo getSelfInfo()
```
    Description copied from interface: JDA
    
    Returns the currently logged in account represented by SelfInfo.
    Account settings cannot be modified using this object. If you wish to modify account settings please use the AccountManager.
    
    Specified by:
    
    getSelfInfo in interface JDA
    
    Returns:
    
    The currently logged in account.
  - setSelfInfo
```
public void setSelfInfo(SelfInfo selfInfo)
```
  - getResponseTotal
```
public int getResponseTotal()
```
    Description copied from interface: JDA
    
    This value is the total amount of JSON responses that discord has sent.
    This value resets every time the websocket has to reconnect.
    
    Specified by:
    
    getResponseTotal in interface JDA
    
    Returns:
    
    Never-negative int containing total response amount.
  - setResponseTotal
```
public void setResponseTotal(int responseTotal)
```
  - getRequester
```
public Requester getRequester()
```
  - getGlobalProxy
```
public org.apache.http.HttpHost getGlobalProxy()
```
    Description copied from interface: JDA
    
    The proxy settings used by all JDA instances.
    
    Specified by:
    
    getGlobalProxy in interface JDA
    
    Returns:
    
    The proxy settings used by all JDA instances. If JDA currently isn't using a proxy, Proxy.NO_PROXY is returned.
  - getAccountManager
```
public AccountManager getAccountManager()
```
    Description copied from interface: JDA
    
    Returns the AccountManager for the currently logged in account.
    Account settings can only be modified using this object.
    
    Specified by:
    
    getAccountManager in interface JDA
    
    Returns:
    
    The AccountManager for the currently logged in account.
  - setDebug
```
public void setDebug(boolean enableDebug)
```
    Description copied from interface: JDA
    
    Used to enable JDA debug output.
    
    Specified by:
    
    setDebug in interface JDA
    
    Parameters:
    
    enableDebug - If true - enables debug output.
  - isDebug
```
public boolean isDebug()
```
    Description copied from interface: JDA
    
    Used to determine if JDA is currently in debug mode.
    
    Specified by:
    
    isDebug in interface JDA
    
    Returns:
    
    True if JDA is currently in debug mode.
  - shutdown
```
public void shutdown()
```
    Description copied from interface: JDA
    
    Shuts down JDA, closing all its connections. After this command is issued the JDA Instance can not be used anymore. This will also close the background-thread used for requests (which is required for further api calls of other JDA instances). If this is not desired, use JDA.shutdown(boolean) instead. To reconnect, just create a new JDA instance.
    
    Specified by:
    
    shutdown in interface JDA
  - shutdown
```
public void shutdown(boolean free)
```
    Description copied from interface: JDA
    
    Shuts down JDA, closing all its connections. After this command is issued the JDA Instance can not be used anymore. Depending on the free-parameter, this will also close the background-thread used for requests. If the background-thread is closed, the system can exit properly, but no further JDA requests are possible (includes other JDA instances). If you want to reconnect, and the request-thread was not freed, just create a new JDA instance.
    
    Specified by:
    
    shutdown in interface JDA
    
    Parameters:
    
    free - If true, shuts down JDA's rest system permanently.
  - setMessageTimeout
```
public void setMessageTimeout(long timeout)
```
  - getMessageLimit
```
public java.lang.Long getMessageLimit()
```
  - setAllowAck
```
public void setAllowAck(boolean enable)
```
    Enables or disables the ack functionality of JDA.
    Read the Javadocs of ack(Message) for guidelines on how and when to ack!
    
    Parameters:
    
    enable - whether or not to enable ack functionality
  - isAckAllowed
```
public boolean isAckAllowed()
```
  - ack
```
public void ack(Message msg)
```
    Acks a specific message. This feature is disabled by default. To enable them, call setAllowAck(boolean).
    IMPORTANT: It is highly discouraged to ack every message and may lead to rate-limits and other bad stuff. Use this wisely (only if needed, or on a long enough interval). Acking a specific Message also acks every Message before (only ack last one if possible)
    
    Parameters:
    
    msg - the message to ack
  - getAudioManager
```
public AudioManager getAudioManager()
```
    Description copied from interface: JDA
    
    Returns the AudioManager for this JDA instance. AudioManager deals with creating, managing and severing audio connections to VoiceChannels.
    
    Specified by:
    
    getAudioManager in interface JDA
    
    Returns:
    
    The AudioManager for this JDA instance.

Class JDAImpl

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

JDAImpl

JDAImpl

Method Detail

login

getAuthToken

setAuthToken

setEventManager

addEventListener

removeEventListener

getEventManager

getClient

getUserMap

getUsers

getUserById

getUsersByName

getGuildMap

getGuilds

getGuildsByName

getTextChannelsByName

getVoiceChannelByName

getPrivateChannels

createGuild

createGuild

createGuildAsync

createGuildAsync

getGuildById

getChannelMap

getTextChannels

getTextChannelById

getVoiceChannelMap

getVoiceChannels

getVoiceChannelById

getPrivateChannelById

getPmChannelMap

getOffline_pms

getSelfInfo

setSelfInfo

getResponseTotal

setResponseTotal

getRequester

getGlobalProxy

getAccountManager

setDebug

isDebug

shutdown

shutdown

setMessageTimeout

getMessageLimit

setAllowAck

isAckAllowed

ack

getAudioManager