Interface Extension<T extends Extension.Data>

public interface Extension<T extends Extension.Data>

Extensions

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:

Properties

By implementing properties() and returning a collection of PropertyProviders, you can for example provide an own implementation of Instantiator or Descriptor. These implementations will override the default ones.

It's important to know, that you can only return PropertyProviders of Propertys with Property.category() set to Property.Category.LOADABLE!

Extension Configuration (Extension.Data)

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...).

On Framework Start

At the time that framework is fully initialized and started (practically at the end of JDACBuilder.start()), the onStart(JDACommands) method of all extensions will be called. This allows further configuration, e.g. through the Introspection API by using JDACommands.introspection().

Example

This example extension provides an own implementation of Instantiator.

public class DIExtension implements Extension<DIExtensionData> {

    private Injector injector;

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

    @Override
    public Collection<PropertyProvider<?>> properties() {
        return List.of(PropertyProvider.create(
                Property.INSTANTIATOR,
                2000,
                _ -> new CustomInteractionClassProvider(this))
        );
    }

    @Override
    public void onStart(JDACommands framework) {
        Introspection introspection = framework.introspection();

        introspection.subscribe(RuntimeCloseEvent.class, (event, _) -> ...);
    }

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

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