club.minnced.discord.webhook.send

Class WebhookMessage

java.lang.Object

club.minnced.discord.webhook.send.WebhookMessage

public class WebhookMessage
extends java.lang.Object

Send-only message for a WebhookClient
A ReadonlyMessage can be sent by first converting it to a WebhookMessage with from(club.minnced.discord.webhook.receive.ReadonlyMessage).

Field Summary

Fields

Modifier and Type	Field and Description
protected AllowedMentions	allowedMentions
protected MessageAttachment[]	attachments
protected java.lang.String	avatarUrl
protected java.lang.String	content
protected java.util.List<WebhookEmbed>	embeds
protected int	flags
protected boolean	isTTS
static int	MAX_EMBEDS Maximum amount of embeds a single message can hold (10)
static int	MAX_FILES Maximum amount of files a single message can hold (10)
protected java.lang.String	username

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	WebhookMessage(java.lang.String username, java.lang.String avatarUrl, java.lang.String content, java.util.List<WebhookEmbed> embeds, boolean isTTS, MessageAttachment[] files, AllowedMentions allowedMentions, int flags)

Method Summary

Modifier and Type	Method and Description
@NotNull WebhookMessage	asEphemeral(boolean ephemeral) Returns a new WebhookMessage instance with the ephemeral flag turned on/off (true/false).
static @NotNull WebhookMessage	embeds(@NotNull java.util.Collection<WebhookEmbed> embeds) Creates a WebhookMessage from the provided embeds.
static @NotNull WebhookMessage	embeds(@NotNull WebhookEmbed first, WebhookEmbed... embeds) Creates a WebhookMessage from the provided embeds.
static @NotNull WebhookMessage	files(@NotNull java.util.Map<java.lang.String,?> attachments) Creates a WebhookMessage from the provided attachments.
static @NotNull WebhookMessage	files(@NotNull java.lang.String name1, @NotNull java.lang.Object data1, java.lang.Object... attachments) Creates a WebhookMessage from the provided attachments.
static @NotNull WebhookMessage	from(@NotNull ReadonlyMessage message) Converts a ReadonlyMessage to a WebhookMessage.
@Nullable MessageAttachment[]	getAttachments() The attachments for this message
@Nullable java.lang.String	getAvatarUrl() The avatar url for this message
@NotNull okhttp3.RequestBody	getBody() Provides a RequestBody of this message.
@Nullable java.lang.String	getContent() The content for this message
@NotNull java.util.List<WebhookEmbed>	getEmbeds() The embeds for this message
int	getFlags() The message flags used for this message.
@Nullable java.lang.String	getUsername() The username for this message
boolean	isFile() Whether this message contains files
boolean	isTTS() Whether this message should use Text-to-Speech (TTS)

Methods inherited from class java.lang.Object

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

Field Detail

MAX_FILES

public static final int MAX_FILES

Maximum amount of files a single message can hold (10)

See Also:

Constant Field Values

MAX_EMBEDS

public static final int MAX_EMBEDS

Maximum amount of embeds a single message can hold (10)

See Also:

Constant Field Values

username

protected final java.lang.String username

avatarUrl

protected final java.lang.String avatarUrl

content

protected final java.lang.String content

embeds

protected final java.util.List<WebhookEmbed> embeds

isTTS

protected final boolean isTTS

attachments

protected final MessageAttachment[] attachments

allowedMentions

protected final AllowedMentions allowedMentions

flags

protected final int flags

Constructor Detail

WebhookMessage

protected WebhookMessage(java.lang.String username,
                         java.lang.String avatarUrl,
                         java.lang.String content,
                         java.util.List<WebhookEmbed> embeds,
                         boolean isTTS,
                         MessageAttachment[] files,
                         AllowedMentions allowedMentions,
                         int flags)

Method Detail

getUsername

@Nullable
public @Nullable java.lang.String getUsername()

The username for this message

Returns:

Possibly-null username

getAvatarUrl

@Nullable
public @Nullable java.lang.String getAvatarUrl()

The avatar url for this message

Returns:

Possibly-null avatar url

getContent

@Nullable
public @Nullable java.lang.String getContent()

The content for this message

Returns:

Possibly-null content

getEmbeds

@NotNull
public @NotNull java.util.List<WebhookEmbed> getEmbeds()

The embeds for this message

Returns:

The embeds

getAttachments

@Nullable
public @Nullable MessageAttachment[] getAttachments()

The attachments for this message

Returns:

The attachments

isTTS

public boolean isTTS()

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

Returns:

True, if this message will use tts

getFlags

public int getFlags()

The message flags used for this message.

Returns:

The flags

asEphemeral

@NotNull
public @NotNull WebhookMessage asEphemeral(boolean ephemeral)

Returns a new WebhookMessage instance with the ephemeral flag turned on/off (true/false).
This instance remains unchanged and a new instance is returned.

Parameters:

ephemeral - Whether to make this message ephemeral

Returns:

New WebhookMessage instance

from

@NotNull
public static @NotNull WebhookMessage from(@NotNull
                                                     @NotNull ReadonlyMessage message)

Converts a ReadonlyMessage to a WebhookMessage.
This does not convert attachments.

Parameters:

message - The message to convert

Returns:

A WebhookMessage copy

Throws:

java.lang.NullPointerException - If provided with null

embeds

@NotNull
public static @NotNull WebhookMessage embeds(@NotNull
                                                       @NotNull WebhookEmbed first,
                                                       @NotNull
                                                       WebhookEmbed... embeds)

Creates a WebhookMessage from the provided embeds. A message can hold up to 10 embeds.

Parameters:

first - The first embed

embeds - Optional additional embeds for the message

Returns:

A WebhookMessage for the embeds

Throws:

java.lang.NullPointerException - If provided with null

java.lang.IllegalArgumentException - If more than are provided

embeds

@NotNull
public static @NotNull WebhookMessage embeds(@NotNull
                                                       @NotNull java.util.Collection<WebhookEmbed> embeds)

Creates a WebhookMessage from the provided embeds. A message can hold up to 10 embeds.

Parameters:

embeds - Embeds for the message

Returns:

A WebhookMessage for the embeds

Throws:

java.lang.NullPointerException - If provided with null

java.lang.IllegalArgumentException - If more than are provided

files

@NotNull
public static @NotNull WebhookMessage files(@NotNull
                                                      @NotNull java.util.Map<java.lang.String,?> attachments)

Creates a WebhookMessage from the provided attachments.
A message can hold up to 10 attachments and a total of 8MiB of data.

Parameters:

attachments - The attachments to add, keys are the alternative names for each attachment

Returns:

A WebhookMessage for the attachments

Throws:

java.lang.NullPointerException - If provided with null

java.lang.IllegalArgumentException - If no attachments are provided or more than 10

files

@NotNull
public static @NotNull WebhookMessage files(@NotNull
                                                      @NotNull java.lang.String name1,
                                                      @NotNull
                                                      @NotNull java.lang.Object data1,
                                                      @NotNull
                                                      java.lang.Object... attachments)

Creates a WebhookMessage from the provided attachments.
A message can hold up to 10 attachments and a total of 8MiB of data.

The files are provided in pairs of Name->Data similar to the first 2 arguments.
The allowed data types are byte[] | InputStream | File

Parameters:

name1 - The alternative name of the first attachment

data1 - The first attachment, must be of type byte[] | InputStream | File

attachments - Optional additional attachments to add, pairs of String->Data

Returns:

A WebhookMessage for the attachments

Throws:

java.lang.NullPointerException - If provided with null

java.lang.IllegalArgumentException - If no attachments are provided or more than 10 or the additional arguments are not an even count or an invalid format

isFile

public boolean isFile()

Whether this message contains files

Returns:

True, if this message contains files

getBody

@NotNull
public @NotNull okhttp3.RequestBody getBody()

Provides a RequestBody of this message.
This is used internally for executing webhooks through HTTP requests.

Returns:

The request body