Package de.jcm.discordgamesdk

Class DiscordUtils

java.lang.Object

de.jcm.discordgamesdk.DiscordUtils

public class DiscordUtils
extends Object

A few utils that might be useful when working with the SDK or Discord in general.

Method Summary

Modifier and Type	Method	Description
static Consumer<Result>	completer(CompletableFuture<Void> future)	Creates a Consumer that takes a Result and then completes a CompletableFuture.
static Instant	dateTimeFromSnowflake(long snowflake)	Gets an Instant from a Discord Snowflake.
static <T> BiConsumer<Result,T>	returningCompleter(CompletableFuture<T> future)	Creates a BiConsumer that takes a Result and then completes a CompletableFuture.

Methods inherited from class java.lang.Object

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

Method Details

completer

public static Consumer<Result> completer(CompletableFuture<Void> future)

Creates a Consumer that takes a Result and then completes a CompletableFuture.

The future is completely normally with a null value, if and only if the Result is Result.OK.

In any other case it is completed exceptionally with a GameSDKException wrapping the Result.

This method is mainly intended for chaining SDK calls together, so that one executes after another completed.

Parameters:

future - A CompletableFuture that should be completed

Returns:

A Consumer completing the future

See Also:

• CompletableFuture
• CompletionStage

returningCompleter

public static <T> BiConsumer<Result,T> returningCompleter(CompletableFuture<T> future)

Creates a BiConsumer that takes a Result and then completes a CompletableFuture.

The future is completely normally with the value passed to the BiConsumer, if and only if the Result is Result.OK.

In any other case it is completed exceptionally with a GameSDKException wrapping the Result.

This method is mainly intended for chaining SDK calls together, so that one executes after another completed.

Type Parameters:

T - Type of the returned value (not the Result, but the other value)

Parameters:

future - A CompletableFuture that should be completed

Returns:

A BiConsumer completing the future

See Also:

• CompletableFuture
• CompletionStage

dateTimeFromSnowflake

public static Instant dateTimeFromSnowflake(long snowflake)

Gets an Instant from a Discord Snowflake.

Discord Snowflakes are used for all sorts of IDs (e.g. User ID, Lobby ID). They contain information about the time they were created, which this methods extracts.

Parameters:

snowflake - A Discord Snowflake

Returns:

The Instant at which the Discord object (User, Lobby, etc.) was created

See Also:

• https://discord.com/developers/docs/reference#snowflakes