club.minnced.discord.webhook

Class WebhookClientBuilder

java.lang.Object

club.minnced.discord.webhook.WebhookClientBuilder

public class WebhookClientBuilder
extends java.lang.Object

Builder for a WebhookClient instance.

See Also:

WebhookClient.withId(long, String), WebhookClient.withUrl(String)

Field Summary

Fields

Modifier and Type	Field and Description
protected AllowedMentions	allowedMentions
protected okhttp3.OkHttpClient	client
protected long	id
protected boolean	isDaemon
protected boolean	parseMessage
protected java.util.concurrent.ScheduledExecutorService	pool
protected java.util.concurrent.ThreadFactory	threadFactory
protected long	threadId
protected java.lang.String	token
static java.util.regex.Pattern	WEBHOOK_PATTERN Pattern used to validate webhook urls (?:https?://)?(?:\w+\.)?discord(?:app)?\.com/api(?:/v\d+)?/webhooks/(\d+)/([\w-]+)(?:/(?:\w+)?)?

Constructor Summary

Constructors

Constructor and Description
WebhookClientBuilder(long id, @NotNull java.lang.String token) Creates a new WebhookClientBuilder for the specified webhook components
WebhookClientBuilder(@NotNull java.lang.String url) Creates a new WebhookClientBuilder for the specified webhook url The url is verified using WEBHOOK_PATTERN.

Method Summary

Modifier and Type	Method and Description
@NotNull WebhookClient	build() Builds the WebhookClient with the current settings
@NotNull D4JWebhookClient	buildD4J() Builds the D4JWebhookClient with the current settings
@NotNull JavacordWebhookClient	buildJavacord() Builds the JavacordWebhookClient with the current settings
@NotNull JDAWebhookClient	buildJDA() Builds the JDAWebhookClient with the current settings
static @NotNull WebhookClientBuilder	fromD4J(discord4j.core.object.entity.Webhook webhook) Creates a WebhookClientBuilder for the provided webhook.
static @NotNull WebhookClientBuilder	fromJavacord(org.javacord.api.entity.webhook.Webhook webhook) Creates a WebhookClientBuilder for the provided webhook.
static @NotNull WebhookClientBuilder	fromJDA(net.dv8tion.jda.api.entities.Webhook webhook) Creates a WebhookClientBuilder for the provided webhook.
@NotNull WebhookClientBuilder	setAllowedMentions(@Nullable AllowedMentions mentions) The default mention whitelist for every outgoing message.
@NotNull WebhookClientBuilder	setDaemon(boolean isDaemon) Whether the default executor should use daemon threads.
@NotNull WebhookClientBuilder	setExecutorService(@Nullable java.util.concurrent.ScheduledExecutorService executorService) The ScheduledExecutorService that is used to execute send requests in the resulting WebhookClient.
@NotNull WebhookClientBuilder	setHttpClient(@Nullable okhttp3.OkHttpClient client) The OkHttpClient that is used to execute send requests in the resulting WebhookClient.
@NotNull WebhookClientBuilder	setThreadFactory(@Nullable java.util.concurrent.ThreadFactory factory) The ThreadFactory that is used to initialize the default ScheduledExecutorService used if setExecutorService(java.util.concurrent.ScheduledExecutorService) is not configured.
@NotNull WebhookClientBuilder	setThreadId(long threadId) The ID for the thread you want the messages to be posted to.
@NotNull WebhookClientBuilder	setWait(boolean waitForMessage) Whether resulting messages should be parsed after sending, if this is set to false the futures returned by WebhookClient will receive null instead of instances of ReadonlyMessage.

Methods inherited from class java.lang.Object

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

Field Detail

WEBHOOK_PATTERN

public static final java.util.regex.Pattern WEBHOOK_PATTERN

Pattern used to validate webhook urls (?:https?://)?(?:\w+\.)?discord(?:app)?\.com/api(?:/v\d+)?/webhooks/(\d+)/([\w-]+)(?:/(?:\w+)?)?

id

protected final long id

token

protected final java.lang.String token

threadId

protected long threadId

pool

protected java.util.concurrent.ScheduledExecutorService pool

client

protected okhttp3.OkHttpClient client

threadFactory

protected java.util.concurrent.ThreadFactory threadFactory

allowedMentions

protected AllowedMentions allowedMentions

isDaemon

protected boolean isDaemon

parseMessage

protected boolean parseMessage

Constructor Detail

WebhookClientBuilder

public WebhookClientBuilder(long id,
                            @NotNull
                            @NotNull java.lang.String token)

Creates a new WebhookClientBuilder for the specified webhook components

Parameters:

id - The webhook id

token - The webhook token

Throws:

java.lang.NullPointerException - If the token is null

WebhookClientBuilder

public WebhookClientBuilder(@NotNull
                            @NotNull java.lang.String url)

Creates a new WebhookClientBuilder for the specified webhook url
The url is verified using WEBHOOK_PATTERN.

Parameters:

url - The url to use

Throws:

java.lang.NullPointerException - If the url is null

java.lang.IllegalArgumentException - If the url is not valid

Method Detail

fromJDA

@NotNull
public static @NotNull WebhookClientBuilder fromJDA(@NotNull
                                                              net.dv8tion.jda.api.entities.Webhook webhook)

Creates a WebhookClientBuilder for the provided webhook.

Parameters:

webhook - The webhook

Returns:

The WebhookClientBuilder

Throws:

java.lang.NullPointerException - If the webhook is null or does not provide a token

fromD4J

@NotNull
public static @NotNull WebhookClientBuilder fromD4J(@NotNull
                                                              discord4j.core.object.entity.Webhook webhook)

Creates a WebhookClientBuilder for the provided webhook.

Parameters:

webhook - The webhook

Returns:

The WebhookClientBuilder

Throws:

java.lang.NullPointerException - If the webhook is null or does not provide a token

fromJavacord

@NotNull
public static @NotNull WebhookClientBuilder fromJavacord(@NotNull
                                                                   org.javacord.api.entity.webhook.Webhook webhook)

Creates a WebhookClientBuilder for the provided webhook.

Parameters:

webhook - The webhook

Returns:

The WebhookClientBuilder

Throws:

java.lang.NullPointerException - If the webhook is null or does not provide a token

setExecutorService

@NotNull
public @NotNull WebhookClientBuilder setExecutorService(@Nullable
                                                                  @Nullable java.util.concurrent.ScheduledExecutorService executorService)

The ScheduledExecutorService that is used to execute send requests in the resulting WebhookClient.
This will be closed by a call to WebhookClient.close().

Parameters:

executorService - The executor service to use

Returns:

The current builder, for chaining convenience

setHttpClient

@NotNull
public @NotNull WebhookClientBuilder setHttpClient(@Nullable
                                                             @Nullable okhttp3.OkHttpClient client)

The OkHttpClient that is used to execute send requests in the resulting WebhookClient.
It is usually not necessary to use multiple different clients in one application

Parameters:

client - The http client to use

Returns:

The current builder, for chaining convenience

setThreadFactory

@NotNull
public @NotNull WebhookClientBuilder setThreadFactory(@Nullable
                                                                @Nullable java.util.concurrent.ThreadFactory factory)

The ThreadFactory that is used to initialize the default ScheduledExecutorService used if setExecutorService(java.util.concurrent.ScheduledExecutorService) is not configured.

Parameters:

factory - The factory to use

Returns:

The current builder, for chaining convenience

setAllowedMentions

@NotNull
public @NotNull WebhookClientBuilder setAllowedMentions(@Nullable
                                                                  @Nullable AllowedMentions mentions)

The default mention whitelist for every outgoing message.
See AllowedMentions for more details.

Parameters:

mentions - The mention whitelist

Returns:

This builder for chaining convenience

setDaemon

@NotNull
public @NotNull WebhookClientBuilder setDaemon(boolean isDaemon)

Whether the default executor should use daemon threads.
This has no effect if either setExecutorService(java.util.concurrent.ScheduledExecutorService) or setThreadFactory(java.util.concurrent.ThreadFactory) are configured to non-null values.

Parameters:

isDaemon - Whether to use daemon threads or not

Returns:

The current builder, for chaining convenience

setWait

@NotNull
public @NotNull WebhookClientBuilder setWait(boolean waitForMessage)

Whether resulting messages should be parsed after sending, if this is set to false the futures returned by WebhookClient will receive null instead of instances of ReadonlyMessage.

Parameters:

waitForMessage - True, if the client should parse resulting messages (default behavior)

Returns:

The current builder, for chaining convenience

setThreadId

@NotNull
public @NotNull WebhookClientBuilder setThreadId(long threadId)

The ID for the thread you want the messages to be posted to.
You can use WebhookClient.onThread(long) to send specific messages to threads.

Parameters:

threadId - The target thread id, or 0 to not use threads

Returns:

The current builder, for chaining convenience

build

@NotNull
public @NotNull WebhookClient build()

Builds the WebhookClient with the current settings

Returns:

WebhookClient instance

buildJDA

@NotNull
public @NotNull JDAWebhookClient buildJDA()

Builds the JDAWebhookClient with the current settings

Returns:

JDAWebhookClient instance

buildD4J

@NotNull
public @NotNull D4JWebhookClient buildD4J()

Builds the D4JWebhookClient with the current settings

Returns:

D4JWebhookClient instance

buildJavacord

@NotNull
public @NotNull JavacordWebhookClient buildJavacord()

Builds the JavacordWebhookClient with the current settings

Returns:

JavacordWebhookClient instance