All Superinterfaces:: Channel, Comparable<GuildChannel>, Formattable, GuildChannel, ICopyableChannel, IDetachableEntity, IMemberContainer, IMentionable, IPermissionContainer, IPositionableChannel, ISnowflake

public interface Category extends GuildChannel, ICopyableChannel, IPositionableChannel, IPermissionContainer, IMemberContainer

Represents a channel category in the official Discord API.
Categories are used to keep order in a Guild by dividing the channels into groups.

See Also:

Field Summary

Fields inherited from interface Channel
MAX_NAME_LENGTH

Fields inherited from interface GuildChannel
JUMP_URL
Method Summary

Modifier and Type

Method

Description

ChannelAction<Category>

createCopy()

Creates a copy of the specified GuildChannel.

ChannelAction<Category>

createCopy(Guild guild)

Creates a copy of the specified GuildChannel in the specified Guild.

ChannelAction<ForumChannel>

createForumChannel(String name)

Creates a new ForumChannel with this Category as parent.

ChannelAction<MediaChannel>

createMediaChannel(String name)

Creates a new MediaChannel with this Category as parent.

ChannelAction<NewsChannel>

createNewsChannel(String name)

Creates a new NewsChannel with this Category as parent.

ChannelAction<StageChannel>

createStageChannel(String name)

Creates a new StageChannel with this Category as parent.

ChannelAction<TextChannel>

createTextChannel(String name)

Creates a new TextChannel with this Category as parent.

ChannelAction<VoiceChannel>

createVoiceChannel(String name)

Creates a new VoiceChannel with this Category as parent.

default @Unmodifiable List<GuildChannel>

getChannels()

All Channels listed for this Category.

default @Unmodifiable List<ForumChannel>

getForumChannels()

All ForumChannels listed for this Category

CategoryManager

getManager()

Returns the ChannelManager for this GuildChannel.

default @Unmodifiable List<MediaChannel>

getMediaChannels()

All MediaChannels listed for this Category

default @Unmodifiable List<Member>

getMembers()

A List of all Members that are in this GuildChannel
For TextChannels, this returns all Members with the Permission.VIEW_CHANNEL Permission.

default @Unmodifiable List<NewsChannel>

getNewsChannels()

All NewsChannels listed for this Category

default @Unmodifiable List<StageChannel>

getStageChannels()

All StageChannel listed for this Category

default @Unmodifiable List<TextChannel>

getTextChannels()

All TextChannels listed for this Category

default @Unmodifiable List<VoiceChannel>

getVoiceChannels()

All VoiceChannels listed for this Category

CategoryOrderAction

modifyTextChannelPositions()

Modifies the positional order of this Category's nested TextChannels and NewsChannels.

CategoryOrderAction

modifyVoiceChannelPositions()

Modifies the positional order of this Category's nested VoiceChannels and StageChannels.

Methods inherited from interface Channel
formatTo, getAsMention, getFlags, getJDA, getName, getType

Methods inherited from interface Comparable
compareTo

Methods inherited from interface GuildChannel
delete, getGuild, getJumpUrl, getPermissionContainer

Methods inherited from interface IDetachableEntity
isDetached

Methods inherited from interface IPermissionContainer
getMemberPermissionOverrides, getPermissionOverride, getPermissionOverrides, getRolePermissionOverrides, upsertPermissionOverride

Methods inherited from interface IPositionableChannel
getPosition, getPositionRaw

Methods inherited from interface ISnowflake
getId, getIdLong, getTimeCreated

Method Details
- getChannels
  
  @Nonnull default @Unmodifiable List<GuildChannel> getChannels()
  
  All Channels listed for this Category.
  Includes all types of channels, except for threads.
  
  Returns:
  
  Immutable list of all child channels
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getTextChannels
  
  @Nonnull default @Unmodifiable List<TextChannel> getTextChannels()
  
  All TextChannels listed for this Category
  
  Returns:
  
  Immutable list of all child TextChannels
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getNewsChannels
  
  @Nonnull default @Unmodifiable List<NewsChannel> getNewsChannels()
  
  All NewsChannels listed for this Category
  
  Returns:
  
  Immutable list of all child NewsChannels
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getForumChannels
  
  @Nonnull default @Unmodifiable List<ForumChannel> getForumChannels()
  
  All ForumChannels listed for this Category
  
  Returns:
  
  Immutable list of all child ForumChannels
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getMediaChannels
  
  @Nonnull default @Unmodifiable List<MediaChannel> getMediaChannels()
  
  All MediaChannels listed for this Category
  
  Returns:
  
  Immutable list of all child ForumChannels
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getVoiceChannels
  
  @Nonnull default @Unmodifiable List<VoiceChannel> getVoiceChannels()
  
  All VoiceChannels listed for this Category
  
  Returns:
  
  Immutable list of all child VoiceChannels
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getStageChannels
  
  @Nonnull default @Unmodifiable List<StageChannel> getStageChannels()
  
  All StageChannel listed for this Category
  
  Returns:
  
  Immutable list of all child StageChannel
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- createTextChannel
  @Nonnull @CheckReturnValue ChannelAction<TextChannel> createTextChannel(@Nonnull String name)
  
  Creates a new TextChannel with this Category as parent. For this to be successful, the logged in account has to have the MANAGE_CHANNEL Permission in this Category.
  This will copy all PermissionOverrides of this Category! Unless the bot is unable to sync it with this category due to permission escalation. See IPermissionHolder.canSync(IPermissionContainer, IPermissionContainer) for details.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MISSING_ACCESS
  The VIEW_CHANNEL permission was removed
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  
  Parameters:
  
  name - The name of the TextChannel to create (up to 100 characters)
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new TextChannel before creating it
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_CHANNEL permission
  
  IllegalArgumentException - If the provided name is null, empty, or longer than 100 characters
  
  DetachedEntityException - If this entity is detached
- createNewsChannel
  @Nonnull @CheckReturnValue ChannelAction<NewsChannel> createNewsChannel(@Nonnull String name)
  
  Creates a new NewsChannel with this Category as parent. For this to be successful, the logged in account has to have the MANAGE_CHANNEL Permission in this Category.
  This will copy all PermissionOverrides of this Category! Unless the bot is unable to sync it with this category due to permission escalation. See IPermissionHolder.canSync(IPermissionContainer, IPermissionContainer) for details.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MISSING_ACCESS
  The VIEW_CHANNEL permission was removed
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  
  Parameters:
  
  name - The name of the NewsChannel to create (up to 100 characters)
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new NewsChannel before creating it
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_CHANNEL permission
  
  IllegalArgumentException - If the provided name is null, empty, or longer than 100 characters
  
  DetachedEntityException - If this entity is detached
- createVoiceChannel
  @Nonnull @CheckReturnValue ChannelAction<VoiceChannel> createVoiceChannel(@Nonnull String name)
  
  Creates a new VoiceChannel with this Category as parent. For this to be successful, the logged in account has to have the MANAGE_CHANNEL Permission in this Category.
  This will copy all PermissionOverrides of this Category! Unless the bot is unable to sync it with this category due to permission escalation. See IPermissionHolder.canSync(IPermissionContainer, IPermissionContainer) for details.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MISSING_ACCESS
  The VIEW_CHANNEL permission was removed
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  
  Parameters:
  
  name - The name of the VoiceChannel to create (up to 100 characters)
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new VoiceChannel before creating it
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_CHANNEL permission
  
  IllegalArgumentException - If the provided name is null, empty, or longer than 100 characters
  
  DetachedEntityException - If this entity is detached
- createStageChannel
  @Nonnull @CheckReturnValue ChannelAction<StageChannel> createStageChannel(@Nonnull String name)
  
  Creates a new StageChannel with this Category as parent. For this to be successful, the logged in account has to have the MANAGE_CHANNEL Permission in this Category.
  This will copy all PermissionOverrides of this Category! Unless the bot is unable to sync it with this category due to permission escalation. See IPermissionHolder.canSync(IPermissionContainer, IPermissionContainer) for details.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MISSING_ACCESS
  The VIEW_CHANNEL permission was removed
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  
  Parameters:
  
  name - The name of the StageChannel to create (up to 100 characters)
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new StageChannel before creating it
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_CHANNEL permission
  
  IllegalArgumentException - If the provided name is null, empty, or longer than 100 characters
  
  DetachedEntityException - If this entity is detached
- createForumChannel
  @Nonnull @CheckReturnValue ChannelAction<ForumChannel> createForumChannel(@Nonnull String name)
  
  Creates a new ForumChannel with this Category as parent. For this to be successful, the logged in account has to have the MANAGE_CHANNEL Permission in this Category.
  This will copy all PermissionOverrides of this Category! Unless the bot is unable to sync it with this category due to permission escalation. See IPermissionHolder.canSync(IPermissionContainer, IPermissionContainer) for details.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MISSING_ACCESS
  The VIEW_CHANNEL permission was removed
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  
  Parameters:
  
  name - The name of the ForumChannel to create (up to 100 characters)
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new ForumChannel before creating it
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_CHANNEL permission
  
  IllegalArgumentException - If the provided name is null, empty, or longer than 100 characters
  
  DetachedEntityException - If this entity is detached
- createMediaChannel
  @Nonnull @CheckReturnValue ChannelAction<MediaChannel> createMediaChannel(@Nonnull String name)
  
  Creates a new MediaChannel with this Category as parent. For this to be successful, the logged in account has to have the MANAGE_CHANNEL Permission in this Category.
  This will copy all PermissionOverrides of this Category! Unless the bot is unable to sync it with this category due to permission escalation. See IPermissionHolder.canSync(IPermissionContainer, IPermissionContainer) for details.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MISSING_ACCESS
  The VIEW_CHANNEL permission was removed
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  
  Parameters:
  
  name - The name of the MediaChannel to create (up to 100 characters)
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new MediaChannel before creating it
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_CHANNEL permission
  
  IllegalArgumentException - If the provided name is null, empty, or longer than 100 characters
  
  DetachedEntityException - If this entity is detached
- modifyTextChannelPositions
  @Nonnull @CheckReturnValue CategoryOrderAction modifyTextChannelPositions()
  
  Modifies the positional order of this Category's nested TextChannels and NewsChannels.
  This uses an extension of ChannelOrderAction specialized for ordering the nested TextChannels and NewsChannels of this Category.
  Like ChannelOrderAction, the returned CategoryOrderAction can be used to move TextChannels/NewsChannels up, down, or to a specific position.
  This uses ascending order with a 0 based index.
  Possible ErrorResponses include:
  
  UNNKOWN_CHANNEL
  One of the channels has been deleted before the completion of the task.
  
  MISSING_ACCESS
  The currently logged in account was removed from the Guild.
  
  Returns:
  
  A CategoryOrderAction for ordering the Category's TextChannels and NewsChannels.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- modifyVoiceChannelPositions
  @Nonnull @CheckReturnValue CategoryOrderAction modifyVoiceChannelPositions()
  
  Modifies the positional order of this Category's nested VoiceChannels and StageChannels.
  This uses an extension of ChannelOrderAction specialized for ordering the nested VoiceChannels and StageChannels of this Category.
  Like ChannelOrderAction, the returned CategoryOrderAction can be used to move VoiceChannels/StageChannels up, down, or to a specific position.
  This uses ascending order with a 0 based index.
  Possible ErrorResponses include:
  
  UNNKOWN_CHANNEL
  One of the channels has been deleted before the completion of the task.
  
  MISSING_ACCESS
  The currently logged in account was removed from the Guild.
  
  Returns:
  
  A CategoryOrderAction for ordering the Category's VoiceChannels and StageChannels.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getMembers
  
  @Nonnull default @Unmodifiable List<Member> getMembers()
  
  Description copied from interface: IMemberContainer
  
  A List of all Members that are in this GuildChannel
  For TextChannels, this returns all Members with the Permission.VIEW_CHANNEL Permission.
  For VoiceChannels, this returns all Members that joined that VoiceChannel.
  For Categories, this returns all Members who are in its child channels.
  
  Specified by:
  
  getMembers in interface IMemberContainer
  
  Returns:
  
  An immutable List of Members that are in this GuildChannel.
- createCopy
  @Nonnull @CheckReturnValue ChannelAction<Category> createCopy(@Nonnull Guild guild)
  
  Description copied from interface: ICopyableChannel
  
  Creates a copy of the specified GuildChannel in the specified Guild.
  If the provided target guild is not the same Guild this channel is in then the parent category and permissions will not be copied due to technical difficulty and ambiguity.
  This copies the following elements:
  
  Name
  
  Parent Category (if present)
  
  Voice Elements (Bitrate, Userlimit)
  
  Text Elements (Topic, NSFW, Slowmode)
  
  All permission overrides for Members/Roles
  
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MISSING_ACCESS
  The VIEW_CHANNEL permission was removed
  
  Specified by:
  
  createCopy in interface ICopyableChannel
  
  Parameters:
  
  guild - The Guild to create the channel in
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new GuildChannel before creating it!
- createCopy
  @Nonnull @CheckReturnValue ChannelAction<Category> createCopy()
  
  Description copied from interface: ICopyableChannel
  
  Creates a copy of the specified GuildChannel.
  This copies the following elements:
  
  Name
  
  Parent Category (if present)
  
  Voice Elements (Bitrate, Userlimit)
  
  Text Elements (Topic, NSFW, Slowmode)
  
  All permission overrides for Members/Roles
  
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MISSING_ACCESS
  The VIEW_CHANNEL permission was removed
  
  Specified by:
  
  createCopy in interface ICopyableChannel
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new GuildChannel before creating it!
- getManager
  
  @Nonnull @CheckReturnValue CategoryManager getManager()
  
  Description copied from interface: GuildChannel
  
  Returns the ChannelManager for this GuildChannel.
  In the ChannelManager, you can modify the name, topic and position of this GuildChannel. You modify multiple fields in one request by chaining setters before calling RestAction.queue().
  
  Specified by:
  
  getManager in interface GuildChannel
  
  Specified by:
  
  getManager in interface IPermissionContainer
  
  Specified by:
  
  getManager in interface IPositionableChannel
  
  Returns:
  
  The ChannelManager of this GuildChannel

Interface Category

Field Summary

Fields inherited from interface Channel

Fields inherited from interface GuildChannel

Method Summary

Methods inherited from interface Channel

Methods inherited from interface Comparable

Methods inherited from interface GuildChannel

Methods inherited from interface IDetachableEntity

Methods inherited from interface IPermissionContainer

Methods inherited from interface IPositionableChannel

Methods inherited from interface ISnowflake

Method Details

getChannels

getTextChannels

getNewsChannels

getForumChannels

getMediaChannels

getVoiceChannels

getStageChannels

createTextChannel

createNewsChannel

createVoiceChannel

createStageChannel

createForumChannel

createMediaChannel

modifyTextChannelPositions

modifyVoiceChannelPositions

getMembers

createCopy

createCopy

getManager