Package net.dv8tion.jda.internal.utils.message

Interface AbstractMessageBuilderMixin<R extends MessageRequest<R>,B extends AbstractMessageBuilder<?,B>>

All Superinterfaces:

MessageData, MessageRequest<R>

All Known Subinterfaces:

MessageCreateBuilderMixin<R>, MessageEditBuilderMixin<R>

All Known Implementing Classes:

ForumPostActionImpl, MessageCreateActionImpl, MessageEditActionImpl, MessageEditCallbackActionImpl, ReplyCallbackActionImpl, WebhookMessageCreateActionImpl, WebhookMessageEditActionImpl

public interface AbstractMessageBuilderMixin<R extends MessageRequest<R>,B extends AbstractMessageBuilder<?,B>>
extends MessageRequest<R>

Method Summary

Modifier and Type	Method	Description
default EnumSet<Message.MentionType>	getAllowedMentions()	The mention types which are whitelisted.
default List<? extends AttachedFile>	getAttachments()	The configured message attachments as AttachedFile, this is the opposite of MessageRequest.setFiles(Collection) and only returns what was set using that setter.
B	getBuilder()
default List<MessageTopLevelComponentUnion>	getComponents()	The configured message components, this is the opposite of MessageRequest.setComponents(Collection) and only returns what was set using that setter.
default String	getContent()	The configured message content, this is the opposite for MessageRequest.setContent(String) and only returns what was set using that setter.
default List<MessageEmbed>	getEmbeds()	The configured message embeds, this is the opposite of MessageRequest.setEmbeds(Collection) and only returns what was set using that setter.
default Set<String>	getMentionedRoles()	The IDs for roles which are allowed to be mentioned, or an empty list.
default Set<String>	getMentionedUsers()	The IDs for users which are allowed to be mentioned, or an empty list.
default boolean	isMentionRepliedUser()	Whether this message would mention a user, if it is sent as a reply.
default boolean	isSuppressEmbeds()	Whether embeds will be suppressed on this message.
default boolean	isUsingComponentsV2()	Whether this message is using components V2.
default R	mention(Collection<? extends IMentionable> mentions)	Used to provide a whitelist for Users, Members and Roles that should be pinged, even when they would not be pinged otherwise according to the Set of allowed mention types.
default R	mentionRepliedUser(boolean mention)	Whether to mention the user, when replying to a message.
default R	mentionRoles(Collection<String> roleIds)	Used to provide a whitelist of Roles that should be pinged, even when they would not be pinged otherwise according to the Set of allowed mention types.
default R	mentionUsers(Collection<String> userIds)	Used to provide a whitelist of Users that should be pinged, even when they would not be pinged otherwise according to the Set of allowed mention types.
default R	setAllowedMentions(Collection<Message.MentionType> allowedMentions)	Sets the MentionTypes that should be parsed.
default R	setComponents(Collection<? extends MessageTopLevelComponent> components)	The MessageTopLevelComponents that should be attached to the message.
default R	setContent(String content)	The message content, which shows above embeds and attachments.
default R	setEmbeds(Collection<? extends MessageEmbed> embeds)	The MessageEmbeds that should be attached to the message.
default R	setFiles(Collection<? extends FileUpload> files)	The FileUploads that should be attached to the message.
default R	setSuppressEmbeds(boolean suppress)	Set whether embeds should be suppressed on this message.
default R	useComponentsV2(boolean use)	Sets whether this message is allowed to use V2 components, this is disabled by default.

Methods inherited from interface net.dv8tion.jda.api.utils.messages.MessageData

getComponentTree

Methods inherited from interface net.dv8tion.jda.api.utils.messages.MessageRequest

applyMessage, mention, mentionRoles, mentionRoles, mentionUsers, mentionUsers, setComponents, setComponents, setEmbeds, setFiles, useComponentsV2

Method Details

getBuilder

B getBuilder()

setContent

@Nonnull
default R setContent(@Nullable
 String content)

Description copied from interface: MessageRequest

The message content, which shows above embeds and attachments.

Specified by:

setContent in interface MessageRequest<R extends MessageRequest<R>>

Parameters:

content - The content (up to 2000 characters)

Returns:

The same instance for chaining

getContent

@Nonnull
default String getContent()

Description copied from interface: MessageData

The configured message content, this is the opposite for MessageRequest.setContent(String) and only returns what was set using that setter.

For message edit requests, this will not be the current content of the message.

Specified by:

getContent in interface MessageData

Returns:

The currently configured content, or an empty string if none was set yet

See Also:

• MessageRequest.setContent(String)

setEmbeds

@Nonnull
default R setEmbeds(@Nonnull
 Collection<? extends MessageEmbed> embeds)

Description copied from interface: MessageRequest

The MessageEmbeds that should be attached to the message.
You can use Collections.emptyList() to remove all embeds from the message.

This requires Permission.MESSAGE_EMBED_LINKS in the channel.

Specified by:

setEmbeds in interface MessageRequest<R extends MessageRequest<R>>

Parameters:

embeds - The embeds to attach to the message (up to 10)

Returns:

The same instance for chaining

See Also:

• Collections.emptyList()

getEmbeds

@Nonnull
default List<MessageEmbed> getEmbeds()

Description copied from interface: MessageData

The configured message embeds, this is the opposite of MessageRequest.setEmbeds(Collection) and only returns what was set using that setter.

For message edit requests, this will not be the current embeds of the message.

Specified by:

getEmbeds in interface MessageData

Returns:

The currently configured embeds, or an empty list if none were set yet

See Also:

• MessageRequest.setEmbeds(Collection)

setComponents

@Nonnull
default R setComponents(@Nonnull
 Collection<? extends MessageTopLevelComponent> components)

Description copied from interface: MessageRequest

The MessageTopLevelComponents that should be attached to the message.
You can use Collections.emptyList() to remove all components from the message.

Example: Set action rows

 final List<MessageTopLevelComponent> list = new ArrayList<>();
 list.add(ActionRow.of(selectMenu); // first row
 list.add(ActionRow.of(button1, button2)); // second row (shows below the first)

 channel.sendMessage("Content here")
   .setComponents(list)
   .queue();
 

Example: Remove action rows

 channel.sendMessage("Content here")
    .setComponents(Collections.emptyList())
    .queue();
 

Specified by:

setComponents in interface MessageRequest<R extends MessageRequest<R>>

Parameters:

components - The MessageTopLevelComponents to set, can be empty to remove components, can contain up to 5 V1 components. There are no limits for V2 components outside the total tree size (40).

Returns:

The same instance for chaining

useComponentsV2

@Nonnull
default R useComponentsV2(boolean use)

Description copied from interface: MessageRequest

Sets whether this message is allowed to use V2 components, this is disabled by default.

Using V2 components removes the top-level component limit, and allows more components in total (40).
They also allow you to use a larger choice of components, such as any component extending MessageTopLevelComponent, as long as they are compatible.
The character limit for the messages also gets changed to 4000.

This, however, comes with a few drawbacks:

• You cannot send content, embeds, polls or stickers
• It does not support voice messages
• It does not support previewing files
• URLs don't create embeds
• You cannot switch this message back to not using Components V2 (you can however upgrade a message to V2)

A default value can be set in MessageRequest.setDefaultUseComponentsV2(boolean).

Specified by:

useComponentsV2 in interface MessageRequest<R extends MessageRequest<R>>

Parameters:

use - true to enable V2 components, false to disabled them.

Returns:

The same instance for chaining

See Also:

• MessageTopLevelComponent
• MessageRequest.setDefaultUseComponentsV2(boolean)

getComponents

@Nonnull
default List<MessageTopLevelComponentUnion> getComponents()

Description copied from interface: MessageData

The configured message components, this is the opposite of MessageRequest.setComponents(Collection) and only returns what was set using that setter.

For message edit requests, this will not be the current components of the message.

Specified by:

getComponents in interface MessageData

Returns:

The currently configured components, or an empty list if none were set yet

See Also:

• MessageRequest.setEmbeds(Collection)

isUsingComponentsV2

default boolean isUsingComponentsV2()

Description copied from interface: MessageData

Whether this message is using components V2.

Specified by:

isUsingComponentsV2 in interface MessageData

Returns:

true if this is using components V2

See Also:

• MessageRequest.useComponentsV2()
• MessageRequest.useComponentsV2(boolean)

setSuppressEmbeds

@Nonnull
default R setSuppressEmbeds(boolean suppress)

Description copied from interface: MessageRequest

Set whether embeds should be suppressed on this message.
This also includes rich embeds added via MessageRequest.setEmbeds(MessageEmbed...).

Default: false

Specified by:

setSuppressEmbeds in interface MessageRequest<R extends MessageRequest<R>>

Parameters:

suppress - True, if all embeds should be suppressed

Returns:

The same instance for chaining

isSuppressEmbeds

default boolean isSuppressEmbeds()

Description copied from interface: MessageData

Whether embeds will be suppressed on this message.

Specified by:

isSuppressEmbeds in interface MessageData

Returns:

True, if embeds are suppressed

setFiles

@Nonnull
default R setFiles(@Nullable
 Collection<? extends FileUpload> files)

Description copied from interface: MessageRequest

The FileUploads that should be attached to the message.
This will replace all the existing attachments on the message, if this is an edit request. You can use MessageEditRequest.setAttachments(Collection) to keep existing attachments, instead of this method.

Resource Handling Note: Once the request is handed off to the requester, for example when you call RestAction.queue(), the requester will automatically clean up all opened files by itself. You are only responsible to close them yourself if it is never handed off properly. For instance, if an exception occurs after using FileUpload.fromData(File), before calling RestAction.queue(). You can safely use a try-with-resources to handle this, since FileUpload.close() becomes ineffective once the request is handed off.

Example
Create an embed with a custom image, uploaded alongside the message:

 MessageEmbed embed = new EmbedBuilder()
         .setDescription("Image of a cute cat")
         .setImage("attachment://cat.png") // here "cat.png" is the name used in the FileUpload.fromData factory method
         .build();

 // The name here will be "cat.png" to discord, what the file is called on your computer is irrelevant and only used to read the data of the image.
 FileUpload file = FileUpload.fromData(new File("mycat-final-copy.png"), "cat.png"); // Opens the file called "cat.png" and provides the data used for sending

 channel.sendMessageEmbeds(embed)
        .setFiles(file)
        .queue();
 

Specified by:

setFiles in interface MessageRequest<R extends MessageRequest<R>>

Parameters:

files - The FileUploads to attach to the message, null or an empty list will set the attachments to an empty list and remove them from the message

Returns:

The same instance for chaining

getAttachments

@Nonnull
default List<? extends AttachedFile> getAttachments()

Description copied from interface: MessageData

The configured message attachments as AttachedFile, this is the opposite of MessageRequest.setFiles(Collection) and only returns what was set using that setter.

For message edit requests, this will not be the current file attachments of the message.

Specified by:

getAttachments in interface MessageData

Returns:

The currently configured attachments, or an empty list if none were set yet

See Also:

• MessageRequest.setFiles(Collection)

mentionRepliedUser

@Nonnull
default R mentionRepliedUser(boolean mention)

Description copied from interface: MessageRequest

Whether to mention the user, when replying to a message.
This only matters in combination with MessageCreateAction.setMessageReference(...)!

This is true by default but can be configured using MessageRequest.setDefaultMentionRepliedUser(boolean)!

Specified by:

mentionRepliedUser in interface MessageRequest<R extends MessageRequest<R>>

Parameters:

mention - True, to mention the author in the referenced message

Returns:

The same instance for chaining

setAllowedMentions

@Nonnull
default R setAllowedMentions(@Nullable
 Collection<Message.MentionType> allowedMentions)

Description copied from interface: MessageRequest

Sets the MentionTypes that should be parsed.
If a message is sent with an empty Set of MentionTypes, then it will not ping any User, Role or @everyone/@here, while still showing up as mention tag.

If null is provided to this method, then all Types will be mentionable (unless whitelisting via one of the mention* methods is used).

Note: A default for this can be set using AllowedMentions.setDefaultMentions(Collection).

Specified by:

setAllowedMentions in interface MessageRequest<R extends MessageRequest<R>>

Parameters:

allowedMentions - MentionTypes that are allowed to being parsed and mentioned. All other mention types will not be mentioned by this message. You can pass null or EnumSet.allOf(MentionType.class) to allow all mentions.

Returns:

The same instance for chaining

mention

@Nonnull
default R mention(@Nonnull
 Collection<? extends IMentionable> mentions)

Description copied from interface: MessageRequest

Used to provide a whitelist for Users, Members and Roles that should be pinged, even when they would not be pinged otherwise according to the Set of allowed mention types.
On other types of IMentionable, this does nothing.

Note: When a User/Member is whitelisted this way, then parsing of User mentions is automatically disabled (same applies to Roles).
Also note that whitelisting users or roles implicitly disables parsing of other mentions, if not otherwise set via MessageRequest.setDefaultMentions(Collection) or MessageRequest.setAllowedMentions(Collection).

Specified by:

mention in interface MessageRequest<R extends MessageRequest<R>>

Parameters:

mentions - Users, Members and Roles that should be explicitly whitelisted to be pingable.

Returns:

The same instance for chaining

See Also:

• MessageRequest.setAllowedMentions(Collection)
• MessageRequest.setDefaultMentions(Collection)

mentionUsers

@Nonnull
default R mentionUsers(@Nonnull
 Collection<String> userIds)

Description copied from interface: MessageRequest

Used to provide a whitelist of Users that should be pinged, even when they would not be pinged otherwise according to the Set of allowed mention types.

Note: When a User is whitelisted this way, then parsing of User mentions is automatically disabled.
Also note that whitelisting users or roles implicitly disables parsing of other mentions, if not otherwise set via MessageRequest.setDefaultMentions(Collection) or MessageRequest.setAllowedMentions(Collection).

Specified by:

mentionUsers in interface MessageRequest<R extends MessageRequest<R>>

Parameters:

userIds - Ids of Users that should be explicitly whitelisted to be pingable.

Returns:

The same instance for chaining

See Also:

• MessageRequest.setAllowedMentions(Collection)
• MessageRequest.setDefaultMentions(Collection)

mentionRoles

@Nonnull
default R mentionRoles(@Nonnull
 Collection<String> roleIds)

Description copied from interface: MessageRequest

Used to provide a whitelist of Roles that should be pinged, even when they would not be pinged otherwise according to the Set of allowed mention types.

Note: When a Role is whitelisted this way, then parsing of Role mentions is automatically disabled.
Also note that whitelisting users or roles implicitly disables parsing of other mentions, if not otherwise set via MessageRequest.setDefaultMentions(Collection) or MessageRequest.setAllowedMentions(Collection).

Specified by:

mentionRoles in interface MessageRequest<R extends MessageRequest<R>>

Parameters:

roleIds - Ids of Roles that should be explicitly whitelisted to be pingable.

Returns:

The same instance for chaining

See Also:

• MessageRequest.setAllowedMentions(Collection)
• MessageRequest.setDefaultMentions(Collection)

getMentionedUsers

@Nonnull
default Set<String> getMentionedUsers()

Description copied from interface: MessageData

The IDs for users which are allowed to be mentioned, or an empty list.

Specified by:

getMentionedUsers in interface MessageData

Returns:

The user IDs which are mention whitelisted

getMentionedRoles

@Nonnull
default Set<String> getMentionedRoles()

Description copied from interface: MessageData

The IDs for roles which are allowed to be mentioned, or an empty list.

Specified by:

getMentionedRoles in interface MessageData

Returns:

The role IDs which are mention whitelisted

getAllowedMentions

@Nonnull
default EnumSet<Message.MentionType> getAllowedMentions()

Description copied from interface: MessageData

The mention types which are whitelisted.

Specified by:

getAllowedMentions in interface MessageData

Returns:

The mention types which can be mentioned by this message

isMentionRepliedUser

default boolean isMentionRepliedUser()

Description copied from interface: MessageData

Whether this message would mention a user, if it is sent as a reply.

Specified by:

isMentionRepliedUser in interface MessageData

Returns:

True, if this would mention with the reply