com.sk89q.intake.dispatcher

Class SimpleDispatcher

java.lang.Object

com.sk89q.intake.dispatcher.SimpleDispatcher

All Implemented Interfaces:

CommandCallable, CommandCompleter, Dispatcher

public class SimpleDispatcher
extends Object
implements Dispatcher

A simple implementation of Dispatcher.

Constructor Summary

Constructors

Constructor and Description
SimpleDispatcher() Create a new instance.

Method Summary

Modifier and Type	Method and Description
boolean	call(String arguments, Namespace namespace, List<String> parentCommands) Execute the command.
boolean	contains(String alias) Returns whether the dispatcher contains a registered command for the given alias.
CommandMapping	get(String alias) Get the CommandCallable associated with an alias.
Set<String>	getAliases() Get a list of all the command aliases, which includes the primary alias.
Set<CommandMapping>	getCommands() Get a list of commands.
Description	getDescription() Get the object describing the command.
Set<String>	getPrimaryAliases() Get a list of primary aliases.
List<String>	getSuggestions(String arguments, Namespace locals) Get a list of suggestions based on input.
void	registerCommand(CommandCallable callable, String... alias) Register a command with this dispatcher.
boolean	testPermission(Namespace locals) Test whether the user is permitted to use the command.

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleDispatcher

public SimpleDispatcher()

Create a new instance.

Method Detail

registerCommand

public void registerCommand(CommandCallable callable,
                            String... alias)

Description copied from interface: Dispatcher

Register a command with this dispatcher.

Specified by:

registerCommand in interface Dispatcher

Parameters:

callable - the command executor

alias - a list of aliases, where the first alias is the primary name

getCommands

public Set<CommandMapping> getCommands()

Description copied from interface: Dispatcher

Get a list of commands. Each command, regardless of how many aliases it may have, will only appear once in the returned set.

The returned collection cannot be modified.

Specified by:

getCommands in interface Dispatcher

Returns:

a list of registrations

getAliases

public Set<String> getAliases()

Description copied from interface: Dispatcher

Get a list of all the command aliases, which includes the primary alias.

A command may have more than one alias assigned to it. The returned collection cannot be modified.

Specified by:

getAliases in interface Dispatcher

Returns:

a list of aliases

getPrimaryAliases

public Set<String> getPrimaryAliases()

Description copied from interface: Dispatcher

Get a list of primary aliases.

The returned collection cannot be modified.

Specified by:

getPrimaryAliases in interface Dispatcher

Returns:

a list of aliases

contains

public boolean contains(String alias)

Description copied from interface: Dispatcher

Returns whether the dispatcher contains a registered command for the given alias.

Specified by:

contains in interface Dispatcher

Parameters:

alias - the alias

Returns:

true if a registered command exists

get

public CommandMapping get(String alias)

Description copied from interface: Dispatcher

Get the CommandCallable associated with an alias. Returns null if no command is named by the given alias.

Specified by:

get in interface Dispatcher

Parameters:

alias - the alias

Returns:

the command mapping (null if not found)

call

public boolean call(String arguments,
                    Namespace namespace,
                    List<String> parentCommands)
             throws CommandException,
                    InvocationCommandException,
                    AuthorizationException

Description copied from interface: CommandCallable

Execute the command.

parentCommands is a list of "parent" commands, including the current command, where each deeper command is appended to the list of parent commands.

For example, if the command entered was /world create ocean and the command in question was the "create" command, then:

• arguments would be ocean
• parentCommands would be world create

On the other hand, if the command was "world," then:

• arguments would be create ocean
• parentCommands would be world

Specified by:

call in interface CommandCallable

Parameters:

arguments - The arguments

namespace - Additional values used for execution

parentCommands - The list of parent commands

Returns:

Whether the command succeeded

Throws:

CommandException - If there is an error with the command

InvocationCommandException - If there is an error with executing the command

AuthorizationException - If there is a authorization error

getSuggestions

public List<String> getSuggestions(String arguments,
                                   Namespace locals)
                            throws CommandException

Description copied from interface: CommandCompleter

Get a list of suggestions based on input.

Specified by:

getSuggestions in interface CommandCompleter

Parameters:

arguments - the arguments entered up to this point

locals - the locals

Returns:

a list of suggestions

Throws:

CommandException - thrown if there was a parsing error

getDescription

public Description getDescription()

Description copied from interface: CommandCallable

Get the object describing the command.

Specified by:

getDescription in interface CommandCallable

Returns:

The object describing the command

testPermission

public boolean testPermission(Namespace locals)

Description copied from interface: CommandCallable

Test whether the user is permitted to use the command.

Specified by:

testPermission in interface CommandCallable

Parameters:

locals - The namespace

Returns:

Whether permission is provided