Class Runtime

java.lang.Object

com.github.kaktushose.jda.commands.dispatching.Runtime

All Implemented Interfaces:

Closeable, AutoCloseable

@Internal
public final class Runtime
extends Object
implements Closeable

A Runtime delegates the jda events to their corresponding EventHandler and manages the used virtual threads.

A new Runtime is created each time an SlashCommandInteractionEvent, GenericContextInteractionEvent or CommandAutoCompleteInteractionEvent is provided by jda or if an interaction is marked as 'independent'. Runtimes are executed in parallel, but events are processed sequentially by each runtime. Every EventHandler called by this Runtime is executed in its own virtual thread, isolated from the runtime one.

Implementation Note:

Each Runtime is based on a BlockingQueue in which jda events, belonging to this runtime, are put by the JDAEventListener running on the jda event thread. Each runtime than has its own virtual thread that takes events from this queue and executes them sequentially but each in its own (sub) virtual thread. Therefore, the virtual thread in which the user code will be called, only exists for the lifespan of one "interaction" and cannot interfere with other interactions on the same or other runtimes.

Method Summary

Modifier and Type	Method	Description
void	close()
@NotNull String	id()
<T> T	interactionInstance(Class<T> clazz)
boolean	isClosed()
@NotNull KeyValueStore	keyValueStore()
void	queueEvent(GenericInteractionCreateEvent event)
static @NotNull Runtime	startNew(String id, DispatchingContext dispatchingContext, JDA jda)

Methods inherited from class java.lang.Object

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

Method Details

startNew

@NotNull
public static @NotNull Runtime startNew(String id,
 DispatchingContext dispatchingContext,
 JDA jda)

id

@NotNull
public @NotNull String id()

queueEvent

public void queueEvent(GenericInteractionCreateEvent event)

keyValueStore

@NotNull
public @NotNull KeyValueStore keyValueStore()

interactionInstance

public <T> T interactionInstance(Class<T> clazz)

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

isClosed

public boolean isClosed()