Package net.dv8tion.jda.api.requests.restaction

Interface WebhookMessageUpdateAction<T>

Type Parameters:

T - The type of message that will be returned

All Superinterfaces:

RestAction<T>

public interface WebhookMessageUpdateAction<T>
extends RestAction<T>

Specialized RestAction used to update an existing message sent by a Webhook or InteractionHook.

See Also:

• InteractionHook.editOriginal(String)
• WebhookClient.editMessageById(long, String)

Method Summary

Modifier and Type	Method	Description
default WebhookMessageUpdateAction<T>	addFile(byte[] data, String name, AttachmentOption... options)	Adds the provided byte[] as file data.
default WebhookMessageUpdateAction<T>	addFile(File file, String name, AttachmentOption... options)	Adds the provided File.
default WebhookMessageUpdateAction<T>	addFile(File file, AttachmentOption... options)	Adds the provided File.
WebhookMessageUpdateAction<T>	addFile(InputStream data, String name, AttachmentOption... options)	Adds the provided InputStream as file data.
WebhookMessageUpdateAction<T>	applyMessage(Message message)	Applies the Message to overwrite the existing message.
default WebhookMessageUpdateAction<T>	retainFiles(Collection<? extends Message.Attachment> attachments)	Removes all attachments that are currently attached to the existing message except for the ones provided.
default WebhookMessageUpdateAction<T>	retainFilesById(long... ids)	Removes all attachments that are currently attached to the existing message except for the ones provided.
default WebhookMessageUpdateAction<T>	retainFilesById(String... ids)	Removes all attachments that are currently attached to the existing message except for the ones provided.
WebhookMessageUpdateAction<T>	retainFilesById(Collection<String> ids)	Removes all attachments that are currently attached to the existing message except for the ones provided.
default WebhookMessageUpdateAction<T>	setActionRow(Collection<? extends ItemComponent> components)	Set only one action row for convenience.
default WebhookMessageUpdateAction<T>	setActionRow(ItemComponent... components)	Set only one action row for convenience.
default WebhookMessageUpdateAction<T>	setActionRows(Collection<? extends ActionRow> rows)	Set the action rows for the message.
WebhookMessageUpdateAction<T>	setActionRows(ActionRow... rows)	Set the action rows for the message.
WebhookMessageUpdateAction<T>	setContent(String content)	Set the new content for this message.
WebhookMessageUpdateAction<T>	setEmbeds(Collection<? extends MessageEmbed> embeds)	Set the MessageEmbeds for the message
default WebhookMessageUpdateAction<T>	setEmbeds(MessageEmbed... embeds)	Set the MessageEmbeds for the message

Methods inherited from interface net.dv8tion.jda.api.requests.RestAction

addCheck, and, and, complete, complete, completeAfter, deadline, delay, delay, delay, delay, flatMap, flatMap, getCheck, getJDA, map, mapToResult, onErrorFlatMap, onErrorFlatMap, onErrorMap, onErrorMap, queue, queue, queue, queueAfter, queueAfter, queueAfter, queueAfter, queueAfter, queueAfter, setCheck, submit, submit, submitAfter, submitAfter, timeout, zip

Method Details

setContent

@Nonnull
@CheckReturnValue
WebhookMessageUpdateAction<T> setContent(@Nullable
 String content)

Set the new content for this message.

Parameters:

content - The new message content

Returns:

The same update action, for chaining convenience

Throws:

IllegalArgumentException - If the provided content is longer than MAX_CONTENT_LENGTH characters

setEmbeds

@Nonnull
@CheckReturnValue
WebhookMessageUpdateAction<T> setEmbeds(@Nonnull
 Collection<? extends MessageEmbed> embeds)

Set the MessageEmbeds for the message

Parameters:

embeds - The message embeds

Returns:

The same update action, for chaining convenience

Throws:

IllegalArgumentException - If null is provided, or one of the embeds is too big

setEmbeds

@Nonnull
@CheckReturnValue
default WebhookMessageUpdateAction<T> setEmbeds(@Nonnull
 MessageEmbed... embeds)

Set the MessageEmbeds for the message

Parameters:

embeds - The message embeds

Returns:

The same update action, for chaining convenience

Throws:

IllegalArgumentException - If null is provided, or one of the embeds is too big

setActionRow

@Nonnull
@CheckReturnValue
default WebhookMessageUpdateAction<T> setActionRow(@Nonnull
 ItemComponent... components)

Set only one action row for convenience.

Parameters:

components - The action row components, such as Buttons

Returns:

The same update action, for chaining convenience

Throws:

IllegalArgumentException - If null is provided, an invalid number of components is provided, or any custom id is duplicated

setActionRow

@Nonnull
@CheckReturnValue
default WebhookMessageUpdateAction<T> setActionRow(@Nonnull
 Collection<? extends ItemComponent> components)

Set only one action row for convenience.

Parameters:

components - The action row components, such as Buttons

Returns:

The same update action, for chaining convenience

Throws:

IllegalArgumentException - If null is provided, an invalid number of components is provided, or any custom id is duplicated

setActionRows

@Nonnull
@CheckReturnValue
default WebhookMessageUpdateAction<T> setActionRows(@Nonnull
 Collection<? extends ActionRow> rows)

Set the action rows for the message.

Parameters:

rows - The new action rows

Returns:

The same update action, for chaining convenience

Throws:

IllegalArgumentException - If null is provided, more than 5 action rows are provided, or any custom id is duplicated

setActionRows

@Nonnull
@CheckReturnValue
WebhookMessageUpdateAction<T> setActionRows(@Nonnull
 ActionRow... rows)

Set the action rows for the message.

Parameters:

rows - The new action rows

Returns:

The same update action, for chaining convenience

Throws:

IllegalArgumentException - If null is provided, more than 5 action rows are provided, or any custom id is duplicated

applyMessage

@Nonnull
@CheckReturnValue
WebhookMessageUpdateAction<T> applyMessage(@Nonnull
 Message message)

Applies the Message to overwrite the existing message.

Parameters:

message - The message to use for updating

Returns:

The same update action, for chaining convenience

Throws:

IllegalArgumentException - If null is provided

addFile

@Nonnull
@CheckReturnValue
WebhookMessageUpdateAction<T> addFile(@Nonnull
 InputStream data,
 @Nonnull
 String name,
 @Nonnull
 AttachmentOption... options)

Adds the provided InputStream as file data.
The stream will be closed upon execution!
The provided file will be appended to the message. You can use retainFiles(Collection) to delete files from the message.

Parameters:

data - The InputStream data to upload to the webhook.

name - The file name that should be sent to discord
Refer to the documentation for addFile(java.io.File, String, AttachmentOption...) for information about this parameter.

options - Possible options to apply to this attachment, such as marking it as spoiler image

Returns:

The same update action, for chaining convenience

Throws:

IllegalArgumentException - If the provided data or filename is null.

addFile

@Nonnull
@CheckReturnValue
default WebhookMessageUpdateAction<T> addFile(@Nonnull
 byte[] data,
 @Nonnull
 String name,
 @Nonnull
 AttachmentOption... options)

Adds the provided byte[] as file data.
The stream will be closed upon execution!
The provided file will be appended to the message. You can use retainFiles(Collection) to delete files from the message.

Parameters:

data - The byte[] data to upload to the webhook.

name - The file name that should be sent to discord
Refer to the documentation for addFile(java.io.File, String, AttachmentOption...) for information about this parameter.

options - Possible options to apply to this attachment, such as marking it as spoiler image

Returns:

The same update action, for chaining convenience

Throws:

IllegalArgumentException - If the provided data or filename is null.

addFile

@Nonnull
@CheckReturnValue
default WebhookMessageUpdateAction<T> addFile(@Nonnull
 File file,
 @Nonnull
 String name,
 @Nonnull
 AttachmentOption... options)

Adds the provided File.
The stream will be closed upon execution!
The provided file will be appended to the message. You can use retainFiles(Collection) to delete files from the message.

The name parameter is used to inform Discord about what the file should be called. This is 2 fold:

1. The file name provided is the name that is found in Message.Attachment.getFileName() after upload and it is the name that will show up in the client when the upload is displayed.
   Note: The fileName does not show up on the Desktop client for images. It does on mobile however.
2. The extension of the provided fileName also determines how Discord will treat the file. Discord currently only has special handling for image file types, but the fileName's extension must indicate that it is an image file. This means it has to end in something like .png, .jpg, .jpeg, .gif, etc. As a note, you can also not provide a full name for the file and instead ONLY provide the extension like "png" or "gif" and Discord will generate a name for the upload and append the fileName as the extension.

Parameters:

file - The File data to upload to the webhook.

name - The file name that should be sent to discord

options - Possible options to apply to this attachment, such as marking it as spoiler image

Returns:

The same update action, for chaining convenience

Throws:

IllegalArgumentException - If the provided file or filename is null.

addFile

@Nonnull
@CheckReturnValue
default WebhookMessageUpdateAction<T> addFile(@Nonnull
 File file,
 @Nonnull
 AttachmentOption... options)

Adds the provided File.
The stream will be closed upon execution!
The provided file will be appended to the message. You can use retainFiles(Collection) to delete files from the message.

Parameters:

file - The File data to upload to the webhook.

options - Possible options to apply to this attachment, such as marking it as spoiler image

Returns:

The same update action, for chaining convenience

Throws:

IllegalArgumentException - If the provided file is null.

retainFilesById

@Nonnull
@CheckReturnValue
WebhookMessageUpdateAction<T> retainFilesById(@Nonnull
 Collection<String> ids)

Removes all attachments that are currently attached to the existing message except for the ones provided.
For example retainFilesById(Arrays.asList("123")) would remove all attachments except for the one with the id 123.

To remove all attachments from the message you can pass an empty list.

Parameters:

ids - The ids for the attachments which should be retained on the message

Returns:

The same update action, for chaining convenience

Throws:

IllegalArgumentException - If any of the ids is null or not a valid snowflake

retainFilesById

@Nonnull
@CheckReturnValue
default WebhookMessageUpdateAction<T> retainFilesById(@Nonnull
 String... ids)

Removes all attachments that are currently attached to the existing message except for the ones provided.
For example retainFilesById(Arrays.asList("123")) would remove all attachments except for the one with the id 123.

To remove all attachments from the message you can pass an empty list.

Parameters:

ids - The ids for the attachments which should be retained on the message

Returns:

The same update action, for chaining convenience

Throws:

IllegalArgumentException - If any of the ids is null or not a valid snowflake

retainFilesById

@Nonnull
@CheckReturnValue
default WebhookMessageUpdateAction<T> retainFilesById(long... ids)

Removes all attachments that are currently attached to the existing message except for the ones provided.
For example retainFilesById(Arrays.asList("123")) would remove all attachments except for the one with the id 123.

To remove all attachments from the message you can pass an empty list.

Parameters:

ids - The ids for the attachments which should be retained on the message

Returns:

The same update action, for chaining convenience

Throws:

IllegalArgumentException - If any of the ids is null or not a valid snowflake

retainFiles

@Nonnull
@CheckReturnValue
default WebhookMessageUpdateAction<T> retainFiles(@Nonnull
 Collection<? extends Message.Attachment> attachments)

Removes all attachments that are currently attached to the existing message except for the ones provided.
For example retainFiles(message.getAttachments().subList(1, message.getAttachments().size())) would only remove the first attachment from the message.

To remove all attachments from the message you can pass an empty list.

Parameters:

attachments - The attachments which should be retained on the message

Returns:

The same update action, for chaining convenience

Throws:

IllegalArgumentException - If any of the ids is null or not a valid snowflake