Interface Extension<T extends Extension.Data>

All Known Implementing Classes:

GuiceExtension

public interface Extension<T extends Extension.Data>

Implementations of this interface, that are registered by Javas service provider interface, will be called in JDACBuilder to configure the framework.

This interface provides ways to extend the framework with own functionality:

• providedImplementations(): By implementing this method and returning a collection of Implementations, you can for example provide an own implementation of InteractionControllerInstantiator or Descriptor. These implementations will override the default ones.

• If the Extension needs additional configuration data, implementations have to provide an own implementation of Extension.Data that the user has to register in the builder by calling JDACBuilder.extensionData(Data...).

Example

This example extension provides an own implementation of InteractionControllerInstantiator.

public class DIExtension implements Extension {

    private Injector injector;

    @Override
    public void init(@Nullable Data data) {
        this.injector = data != null
                ? ((DIExtensionData) data).providedInjector()
                : DI.createInjector();
    }

    @Override
    public Collection<Implementation<?>> providedImplementations() {
        return List.of(new Implementation<>(
                InteractionClassProvider.class,
                _ -> new CustomInteractionClassProvider(this))
        );
    }

    @Override
    public Class<GuiceExtensionData> dataType() {
        return DIExtensionData.class;
    }
}

public record DIExtensionData(Injector providedInjector) implements Extension.Data {}

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	Extension.Data	Implementations of this interface are providing additional configuration to implementations of Extension.

Method Summary

Modifier and Type	Method	Description
default @Nullable Class<T>	dataType()
void	init(@Nullable T data)	Initialises the Extension with the provided Extension.Data.
default Collection<Implementation<?>>	providedImplementations()	Gets a collection of Implementations this Extension provides.

Method Details

init

void init(@Nullable T data)

Initialises the Extension with the provided Extension.Data. Will be called right after jda-commands loaded the Extension.

Parameters:

data - The custom implementation of Extension.Data if given by the User. This can be safely cast to the type returned by dataType().

providedImplementations

default Collection<Implementation<?>> providedImplementations()

Gets a collection of Implementations this Extension provides.

Returns:

a collection of Implementations

Implementation Note:

Please note that this method is called multiple times during framework creation. If the identity of the implementations is important, you should always return the same instance.

dataType

default @Nullable Class<T> dataType()

Returns:

the Class of the custom Extension.Data implementation or null if the extension doesn't support additional configuration