Package studio.mevera.imperat

Class BaseImperat<S extends CommandSource>

java.lang.Object

studio.mevera.imperat.BaseImperat<S>

All Implemented Interfaces:

AnnotationInjector<S>, CommandRegistrar<S>, EventListener, EventPublisher, Imperat<S>, SourceWrapper<S>

public abstract class BaseImperat<S extends CommandSource>
extends Object
implements Imperat<S>

Field Summary

Fields

Modifier and Type	Field	Description
protected final ImperatConfig<S>	config

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	BaseImperat(@NotNull ImperatConfig<S> config)

Method Summary

Modifier and Type	Method	Description
CompletableFuture<List<String>>	autoComplete(S source, @NotNull String fullCommandLine)
boolean	canBeSender(Type type)	Checks whether the valueType can be a command sender
@NotNull ImperatConfig<S>	config()	The config for imperat
void	debug()	Debugs all registered commands and their usages.
@NotNull ExecutionResult<S>	execute(@NotNull CommandContext<S> context)	Dispatches and executes a command using CommandContext only
@NotNull ExecutionResult<S>	execute(S sender, @NotNull String line)	Dispatches the full command-line
@NotNull ExecutionResult<S>	execute(S sender, @NotNull String commandName, @NotNull String rawArgsOneLine)	Dispatches and executes a command with certain raw arguments
@NotNull ExecutionResult<S>	execute(S source, @NotNull String commandName, String[] rawInput)	Dispatches and executes a command with certain raw arguments
@NotNull ExecutionResult<S>	execute(S source, @NotNull Command<S> command, @NotNull String commandName, String[] rawInput)	Dispatches and executes a command with certain raw arguments using Command
@NotNull AnnotationParser<S>	getAnnotationParser()	Fetches the annotation parser
@Nullable Command<S>	getCommand(String name)
Collection<? extends Command<S>>	getRegisteredCommands()	Gets all registered commands
@Nullable Command<S>	getSubCommand(String owningCommand, String name)
<E extends Event> void	listen(@NotNull Class<E> eventType, @NotNull EventListenerConsumer<E> handler, @NotNull Priority priority, @NotNull ExecutionStrategy strategy)
<E extends Event> void	publishEvent(E event)
<A extends Annotation> void	registerAnnotationReplacer(Class<A> type, AnnotationReplacer<A> replacer)	Registers AnnotationReplacer
final void	registerAnnotations(Class<? extends Annotation>... type)	Registers a valueType of annotations so that it can be detected by AnnotationReader , it's useful as it allows that valueType of annotation to be recognized as a true Imperat-related annotation to be used in something like checking if a Argument is annotated and checks for the annotations it has.
void	registerCommand(Class<?> commandClass)	Registers a command class built by the annotations using a parser
void	registerCommand(Object commandInstance)	Registers a command instance built by the annotations using a parser
void	registerSimpleCommand(Command<S> command)	Registering a command into the global registry, it will check for ambiguity with other commands and their tree before registering, if an ambiguity is detected it will throw an AmbiguousCommandException
boolean	removeListener(@NotNull UUID subscriptionId)
void	setAnnotationParser(AnnotationParser<S> parser)	Changes the instance of AnnotationParser
void	unregisterAllCommands()	Unregisters all commands from the internal registry
void	unregisterCommand(String name)	Unregisters a command from the internal registry

Methods inherited from class java.lang.Object

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

Methods inherited from interface studio.mevera.imperat.AnnotationInjector

registerGlobalExceptionHandlers

Methods inherited from interface studio.mevera.imperat.CommandRegistrar

getCommand, registerCommands, registerCommands, registerCommands

Methods inherited from interface studio.mevera.imperat.events.EventListener

listen, listen

Methods inherited from interface studio.mevera.imperat.Imperat

getPlatform, shutdownPlatform

Methods inherited from interface studio.mevera.imperat.SourceWrapper

createDummySender, wrapSender

Field Details

config

protected final ImperatConfig<S extends CommandSource> config

Constructor Details

BaseImperat

protected BaseImperat(@NotNull
 @NotNull ImperatConfig<S> config)

Method Details

listen

public <E extends Event> void listen(@NotNull
 @NotNull Class<E> eventType,
 @NotNull
 @NotNull EventListenerConsumer<E> handler,
 @NotNull
 @NotNull Priority priority,
 @NotNull
 @NotNull ExecutionStrategy strategy)

Specified by:

listen in interface EventListener

publishEvent

public <E extends Event> void publishEvent(E event)

Specified by:

publishEvent in interface EventPublisher

removeListener

public boolean removeListener(@NotNull
 @NotNull UUID subscriptionId)

Specified by:

removeListener in interface EventListener

config

@NotNull
public @NotNull ImperatConfig<S> config()

The config for imperat

Specified by:

config in interface Imperat<S extends CommandSource>

Returns:

the config holding all variables.

canBeSender

public boolean canBeSender(Type type)

Checks whether the valueType can be a command sender

Specified by:

canBeSender in interface SourceWrapper<S extends CommandSource>

Parameters:

type - the valueType

Returns:

whether the valueType can be a command sender

registerSimpleCommand

public void registerSimpleCommand(Command<S> command)

Registering a command into the global registry, it will check for ambiguity with other commands and their tree before registering, if an ambiguity is detected it will throw an AmbiguousCommandException

Specified by:

registerSimpleCommand in interface CommandRegistrar<S extends CommandSource>

Parameters:

command - the command to register

registerCommand

public void registerCommand(Class<?> commandClass)

Registers a command class built by the annotations using a parser

Specified by:

registerCommand in interface CommandRegistrar<S extends CommandSource>

Parameters:

commandClass - the annotated command instance to parse

registerCommand

public void registerCommand(Object commandInstance)

Description copied from interface: CommandRegistrar

Registers a command instance built by the annotations using a parser

Specified by:

registerCommand in interface CommandRegistrar<S extends CommandSource>

Parameters:

commandInstance - the annotated command instance to parse

unregisterCommand

public void unregisterCommand(String name)

Unregisters a command from the internal registry

Specified by:

unregisterCommand in interface CommandRegistrar<S extends CommandSource>

Parameters:

name - the name of the command to unregister

unregisterAllCommands

public void unregisterAllCommands()

Unregisters all commands from the internal registry

Specified by:

unregisterAllCommands in interface CommandRegistrar<S extends CommandSource>

getCommand

@Nullable
public @Nullable Command<S> getCommand(String name)

Specified by:

getCommand in interface CommandRegistrar<S extends CommandSource>

Parameters:

name - the name/alias of the command

Returns:

fetches Command with specific name/alias

registerAnnotations

@SafeVarargs
public final void registerAnnotations(Class<? extends Annotation>... type)

Registers a valueType of annotations so that it can be detected by AnnotationReader , it's useful as it allows that valueType of annotation to be recognized as a true Imperat-related annotation to be used in something like checking if a Argument is annotated and checks for the annotations it has.

Specified by:

registerAnnotations in interface AnnotationInjector<S extends CommandSource>

Parameters:

type - the valueType of annotation

registerAnnotationReplacer

public <A extends Annotation> void registerAnnotationReplacer(Class<A> type,
 AnnotationReplacer<A> replacer)

Registers AnnotationReplacer

Specified by:

registerAnnotationReplacer in interface AnnotationInjector<S extends CommandSource>

Type Parameters:

A - the valueType of annotation to replace

Parameters:

type - the valueType to replace the annotation by

replacer - the replacer

getSubCommand

@Nullable
public @Nullable Command<S> getSubCommand(String owningCommand,
 String name)

Specified by:

getSubCommand in interface CommandRegistrar<S extends CommandSource>

Parameters:

owningCommand - the command owning this sub-command

name - the name of the subcommand you're looking for

Returns:

the subcommand of a command

execute

@NotNull
public @NotNull ExecutionResult<S> execute(@NotNull
 @NotNull CommandContext<S> context)

Description copied from interface: Imperat

Dispatches and executes a command using CommandContext only

Specified by:

execute in interface Imperat<S extends CommandSource>

Parameters:

context - the context

Returns:

the usage match setResult

execute

@NotNull
public @NotNull ExecutionResult<S> execute(@NotNull
 S source,
 @NotNull
 @NotNull Command<S> command,
 @NotNull
 @NotNull String commandName,
 String[] rawInput)

Description copied from interface: Imperat

Dispatches and executes a command with certain raw arguments using Command

Specified by:

execute in interface Imperat<S extends CommandSource>

Parameters:

source - the sender/executor of this command

command - the command object to execute

rawInput - the command's args input

Returns:

the usage match setResult

execute

@NotNull
public @NotNull ExecutionResult<S> execute(@NotNull
 S source,
 @NotNull
 @NotNull String commandName,
 String[] rawInput)

Description copied from interface: Imperat

Dispatches and executes a command with certain raw arguments

Specified by:

execute in interface Imperat<S extends CommandSource>

Parameters:

source - the sender/executor of this command

commandName - the name of the command to execute

rawInput - the command's args input

Returns:

the usage match setResult

execute

@NotNull
public @NotNull ExecutionResult<S> execute(@NotNull
 S sender,
 @NotNull
 @NotNull String commandName,
 @NotNull
 @NotNull String rawArgsOneLine)

Description copied from interface: Imperat

Dispatches and executes a command with certain raw arguments

Specified by:

execute in interface Imperat<S extends CommandSource>

Parameters:

sender - the sender/executor of this command

commandName - the name of the command to execute

rawArgsOneLine - the command's args input on ONE LINE

Returns:

the usage match setResult

execute

@NotNull
public @NotNull ExecutionResult<S> execute(@NotNull
 S sender,
 @NotNull
 @NotNull String line)

Description copied from interface: Imperat

Dispatches the full command-line

Specified by:

execute in interface Imperat<S extends CommandSource>

Parameters:

sender - the source/sender of the command

line - the command line to dispatch

Returns:

the usage match setResult

autoComplete

public CompletableFuture<List<String>> autoComplete(@NotNull
 S source,
 @NotNull
 @NotNull String fullCommandLine)

Specified by:

autoComplete in interface Imperat<S extends CommandSource>

Parameters:

source - the sender writing the command

fullCommandLine - the full command line

Returns:

the suggestions at the current position

getRegisteredCommands

public Collection<? extends Command<S>> getRegisteredCommands()

Gets all registered commands

Specified by:

getRegisteredCommands in interface CommandRegistrar<S extends CommandSource>

Returns:

the registered commands

getAnnotationParser

@NotNull
public @NotNull AnnotationParser<S> getAnnotationParser()

Description copied from interface: AnnotationInjector

Fetches the annotation parser

Specified by:

getAnnotationParser in interface AnnotationInjector<S extends CommandSource>

Returns:

the annotation parser instance.

See Also:

• AnnotationParser

setAnnotationParser

public void setAnnotationParser(AnnotationParser<S> parser)

Changes the instance of AnnotationParser

Specified by:

setAnnotationParser in interface AnnotationInjector<S extends CommandSource>

Parameters:

parser - the parser

debug

public void debug()

Description copied from interface: Imperat

Debugs all registered commands and their usages.

Specified by:

debug in interface Imperat<S extends CommandSource>