club.minnced.discord.webhook.send

Class WebhookMessageBuilder

java.lang.Object

club.minnced.discord.webhook.send.WebhookMessageBuilder

public class WebhookMessageBuilder
extends java.lang.Object

Constructs a WebhookMessage

Field Summary

Fields

Modifier and Type	Field and Description
protected AllowedMentions	allowedMentions
protected java.lang.String	avatarUrl
protected java.lang.StringBuilder	content
protected java.util.List<WebhookEmbed>	embeds
protected MessageAttachment[]	files
protected int	flags
protected boolean	isTTS
protected java.lang.String	username

Constructor Summary

Constructors

Constructor and Description
WebhookMessageBuilder()

Method Summary

Modifier and Type	Method and Description
@NotNull WebhookMessageBuilder	addEmbeds(@NotNull java.util.Collection<? extends WebhookEmbed> embeds) Adds the provided embeds to the builder
@NotNull WebhookMessageBuilder	addEmbeds(WebhookEmbed... embeds) Adds the provided embeds to the builder
@NotNull WebhookMessageBuilder	addFile(@NotNull java.io.File file) Adds the provided file as an attachment to this message.
@NotNull WebhookMessageBuilder	addFile(@NotNull java.lang.String name, @NotNull byte[] data) Adds the provided data as a file attachment to this message.
@NotNull WebhookMessageBuilder	addFile(@NotNull java.lang.String name, @NotNull java.io.File file) Adds the provided file as an attachment to this message.
@NotNull WebhookMessageBuilder	addFile(@NotNull java.lang.String name, @NotNull java.io.InputStream data) Adds the provided data as a file attachment to this message.
@NotNull WebhookMessageBuilder	append(@NotNull java.lang.String content) Appends the provided content to the already present content in this message.
@NotNull WebhookMessage	build() Constructs the WebhookMessage from the current configurations.
static @NotNull WebhookMessageBuilder	fromD4J(@NotNull java.util.function.Consumer<? super discord4j.core.spec.MessageCreateSpec> callback) Deprecated. Replace with fromD4J(MessageCreateSpec)
static @NotNull WebhookMessageBuilder	fromD4J(@NotNull discord4j.core.spec.MessageCreateSpec spec) Converts a Discord4J MessageCreateSpec into a compatible WebhookMessageBuilder.
static @NotNull WebhookMessageBuilder	fromD4J(@NotNull discord4j.core.spec.MessageEditSpec spec) Converts a Discord4J MessageCreateSpec into a compatible WebhookMessageBuilder.
static @NotNull WebhookMessageBuilder	fromJavacord(org.javacord.api.entity.message.Message message) Converts a Javacord Message into a compatible WebhookMessageBuilder.
static @NotNull WebhookMessageBuilder	fromJDA(net.dv8tion.jda.api.entities.Message message) Converts a JDA Message into a compatible WebhookMessageBuilder.
int	getFileAmount() The amount of files currently added
boolean	isEmpty() Whether this builder is currently empty
@NotNull WebhookMessageBuilder	reset() Clears this builder to its default state
@NotNull WebhookMessageBuilder	resetEmbeds() Clears all embeds currently added this builder
@NotNull WebhookMessageBuilder	resetFiles() Clears all files currently added to this builder
@NotNull WebhookMessageBuilder	setAllowedMentions(@NotNull AllowedMentions mentions) The mention whitelist.
@NotNull WebhookMessageBuilder	setAvatarUrl(@Nullable java.lang.String avatarUrl) The avatar url to use for this message.
@NotNull WebhookMessageBuilder	setContent(@Nullable java.lang.String content) Configures the content for this builder
@NotNull WebhookMessageBuilder	setEphemeral(boolean ephemeral) Whether the message should be ephemeral (only works for interaction webhooks).
@NotNull WebhookMessageBuilder	setTTS(boolean tts) Whether this message should use Text-to-Speech (TTS)
@NotNull WebhookMessageBuilder	setUsername(@Nullable java.lang.String username) The username to use for this message.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

content

protected final java.lang.StringBuilder content

embeds

protected final java.util.List<WebhookEmbed> embeds

files

protected final MessageAttachment[] files

allowedMentions

protected AllowedMentions allowedMentions

username

protected java.lang.String username

avatarUrl

protected java.lang.String avatarUrl

isTTS

protected boolean isTTS

flags

protected int flags

Constructor Detail

WebhookMessageBuilder

public WebhookMessageBuilder()

Method Detail

isEmpty

public boolean isEmpty()

Whether this builder is currently empty

Returns:

True, if this builder is empty

getFileAmount

public int getFileAmount()

The amount of files currently added

Returns:

The amount of currently added files

reset

@NotNull
public @NotNull WebhookMessageBuilder reset()

Clears this builder to its default state

Returns:

This builder for chaining convenience

resetFiles

@NotNull
public @NotNull WebhookMessageBuilder resetFiles()

Clears all files currently added to this builder

Returns:

This builder for chaining convenience

resetEmbeds

@NotNull
public @NotNull WebhookMessageBuilder resetEmbeds()

Clears all embeds currently added this builder

Returns:

This builder for chaining convenience

setAllowedMentions

@NotNull
public @NotNull WebhookMessageBuilder setAllowedMentions(@NotNull
                                                                   @NotNull AllowedMentions mentions)

The mention whitelist.
See AllowedMentions for more details.

Parameters:

mentions - The mention whitelist

Returns:

This builder for chaining convenience

Throws:

java.lang.NullPointerException - If provided null

addEmbeds

@NotNull
public @NotNull WebhookMessageBuilder addEmbeds(@NotNull
                                                          WebhookEmbed... embeds)

Adds the provided embeds to the builder

Parameters:

embeds - The embeds to add

Returns:

This builder for chaining convenience

Throws:

java.lang.NullPointerException - If provided with null

java.lang.IllegalStateException - If more than are added

addEmbeds

@NotNull
public @NotNull WebhookMessageBuilder addEmbeds(@NotNull
                                                          @NotNull java.util.Collection<? extends WebhookEmbed> embeds)

Adds the provided embeds to the builder

Parameters:

embeds - The embeds to add

Returns:

This builder for chaining convenience

Throws:

java.lang.NullPointerException - If provided with null

java.lang.IllegalStateException - If more than are added

setContent

@NotNull
public @NotNull WebhookMessageBuilder setContent(@Nullable
                                                           @Nullable java.lang.String content)

Configures the content for this builder

Parameters:

content - The (nullable) content to use

Returns:

This builder for chaining convenience

Throws:

java.lang.IllegalArgumentException - If the content is larger than 2000 characters

append

@NotNull
public @NotNull WebhookMessageBuilder append(@NotNull
                                                       @NotNull java.lang.String content)

Appends the provided content to the already present content in this message.

Parameters:

content - The content to append

Returns:

This builder for chaining convenience

Throws:

java.lang.NullPointerException - If provided with null

java.lang.IllegalArgumentException - If the content exceeds 2000 characters

setUsername

@NotNull
public @NotNull WebhookMessageBuilder setUsername(@Nullable
                                                            @Nullable java.lang.String username)

The username to use for this message.
Each message by a webhook can have a different user appearance. If this is not set it will default the user appearance in the settings of the webhook.

Parameters:

username - The (nullable) username to use

Returns:

This builder for chaining convenience

setAvatarUrl

@NotNull
public @NotNull WebhookMessageBuilder setAvatarUrl(@Nullable
                                                             @Nullable java.lang.String avatarUrl)

The avatar url to use for this message.
Each message by a webhook can have a different user appearance. If this is not set it will default the user appearance in the settings of the webhook.

Parameters:

avatarUrl - The (nullable) avatar url to use

Returns:

This builder for chaining convenience

setTTS

@NotNull
public @NotNull WebhookMessageBuilder setTTS(boolean tts)

Whether this message should use Text-to-Speech (TTS)

Parameters:

tts - True, if this message should use tts

Returns:

This builder for chaining convenience

setEphemeral

@NotNull
public @NotNull WebhookMessageBuilder setEphemeral(boolean ephemeral)

Whether the message should be ephemeral (only works for interaction webhooks).

Parameters:

ephemeral - True if the message should be ephemeral, false otherwise

Returns:

This builder for chaining convenience

addFile

@NotNull
public @NotNull WebhookMessageBuilder addFile(@NotNull
                                                        @NotNull java.io.File file)

Adds the provided file as an attachment to this message.
A single message can have up to attachments.

Parameters:

file - The file to attach

Returns:

This builder for chaining convenience

Throws:

java.lang.NullPointerException - If provided with null

addFile

@NotNull
public @NotNull WebhookMessageBuilder addFile(@NotNull
                                                        @NotNull java.lang.String name,
                                                        @NotNull
                                                        @NotNull java.io.File file)

Adds the provided file as an attachment to this message.
A single message can have up to attachments.

Parameters:

name - The alternative name that should be used instead

file - The file to attach

Returns:

This builder for chaining convenience

Throws:

java.lang.NullPointerException - If provided with null

addFile

@NotNull
public @NotNull WebhookMessageBuilder addFile(@NotNull
                                                        @NotNull java.lang.String name,
                                                        @NotNull
                                                        @NotNull byte[] data)

Adds the provided data as a file attachment to this message.
A single message can have up to attachments.

Parameters:

name - The alternative name that should be used

data - The data to attach as a file

Returns:

This builder for chaining convenience

Throws:

java.lang.NullPointerException - If provided with null

addFile

@NotNull
public @NotNull WebhookMessageBuilder addFile(@NotNull
                                                        @NotNull java.lang.String name,
                                                        @NotNull
                                                        @NotNull java.io.InputStream data)

Adds the provided data as a file attachment to this message.
A single message can have up to attachments.

Parameters:

name - The alternative name that should be used

data - The data to attach as a file

Returns:

This builder for chaining convenience

Throws:

java.lang.NullPointerException - If provided with null

build

@NotNull
public @NotNull WebhookMessage build()

Constructs the WebhookMessage from the current configurations.

Returns:

The resulting WebhookMessage

fromJDA

@NotNull
public static @NotNull WebhookMessageBuilder fromJDA(@NotNull
                                                               net.dv8tion.jda.api.entities.Message message)

Converts a JDA Message into a compatible WebhookMessageBuilder.

Parameters:

message - The message

Returns:

WebhookMessageBuilder with the converted data

Throws:

java.lang.NullPointerException - If null is provided

fromJavacord

@NotNull
public static @NotNull WebhookMessageBuilder fromJavacord(@NotNull
                                                                    org.javacord.api.entity.message.Message message)

Converts a Javacord Message into a compatible WebhookMessageBuilder.

Parameters:

message - The message

Returns:

WebhookMessageBuilder with the converted data

Throws:

java.lang.NullPointerException - If null is provided

fromD4J

@NotNull
 @Deprecated
public static @NotNull WebhookMessageBuilder fromD4J(@NotNull
                                                                             @NotNull java.util.function.Consumer<? super discord4j.core.spec.MessageCreateSpec> callback)

Deprecated. Replace with fromD4J(MessageCreateSpec)

Converts a Discord4J MessageCreateSpec into a compatible WebhookMessageBuilder.

Parameters:

callback - The callback used to specify the desired message settings

Returns:

WebhookMessageBuilder with the converted data

Throws:

java.lang.NullPointerException - If null is provided

fromD4J

@NotNull
public static @NotNull WebhookMessageBuilder fromD4J(@NotNull
                                                               @NotNull discord4j.core.spec.MessageCreateSpec spec)

Converts a Discord4J MessageCreateSpec into a compatible WebhookMessageBuilder.

Parameters:

spec - The message create spec used to specify the desired message settings

Returns:

WebhookMessageBuilder with the converted data

Throws:

java.lang.NullPointerException - If null is provided

fromD4J

@NotNull
public static @NotNull WebhookMessageBuilder fromD4J(@NotNull
                                                               @NotNull discord4j.core.spec.MessageEditSpec spec)

Converts a Discord4J MessageCreateSpec into a compatible WebhookMessageBuilder.

Parameters:

spec - The message create spec used to specify the desired message settings

Returns:

WebhookMessageBuilder with the converted data

Throws:

java.lang.NullPointerException - If null is provided