revxrsal.commands.parameter.primitives

Class BooleanParameterType

java.lang.Object

revxrsal.commands.parameter.primitives.BooleanParameterType

All Implemented Interfaces:

BaseParameterType, ParameterType<CommandActor,java.lang.Boolean>

public final class BooleanParameterType
extends java.lang.Object
implements ParameterType<CommandActor,java.lang.Boolean>

A basic ParameterType for parsing boolean types

Nested Class Summary

Nested classes/interfaces inherited from interface revxrsal.commands.parameter.ParameterType

ParameterType.Factory<A extends CommandActor>

Constructor Summary

Constructors

Constructor and Description
BooleanParameterType()

Method Summary

Modifier and Type	Method and Description
@NotNull SuggestionProvider<CommandActor>	defaultSuggestions() Returns the default suggestions.
java.lang.Boolean	parse(@NotNull MutableStringStream input, @NotNull ExecutionContext<CommandActor> context) Reads input from the given MutableStringStream, parses the object, or throws exceptions if needed.
@NotNull PrioritySpec	parsePriority() The priority for an argument of this type over other candidate arguments.

Methods inherited from class java.lang.Object

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

Methods inherited from interface revxrsal.commands.parameter.ParameterType

isGreedy

Constructor Detail

BooleanParameterType

public BooleanParameterType()

Method Detail

parse

public java.lang.Boolean parse(@NotNull
                               @NotNull MutableStringStream input,
                               @NotNull
                               @NotNull ExecutionContext<CommandActor> context)

Description copied from interface: ParameterType

Reads input from the given MutableStringStream, parses the object, or throws exceptions if needed.

Note: Lamp makes no guarantees about the times it may invoke this method. It may be called repeatedly for execution, tab completion, finding execution candidates, etc.

As such, it's important to implement the parse method with the following in mind:

• Avoid expensive computations
• Avoid "expensive computations"
• Avoid sending the actor any feedback inside this method. Any feedback should only be sent using exceptions (see CommandErrorException)
• Avoid any side-effects in general. Ideally, this method should be pure.

Specified by:

parse in interface ParameterType<CommandActor,java.lang.Boolean>

Parameters:

input - The input stream. This argument type is free to consume as much as it needs

context - The command execution context, as well as arguments that have been resolved

Returns:

The parsed object. This should never be null.

defaultSuggestions

@NotNull
public @NotNull SuggestionProvider<CommandActor> defaultSuggestions()

Description copied from interface: ParameterType

Returns the default suggestions. These will be sent if the containing ParameterNode does not supply any custom suggestions.

Specified by:

defaultSuggestions in interface ParameterType<CommandActor,java.lang.Boolean>

Returns:

The default type suggestions

parsePriority

@NotNull
public @NotNull PrioritySpec parsePriority()

Description copied from interface: ParameterType

The priority for an argument of this type over other candidate arguments.

An example of this, is when a command has the following signatures:

• /foo [integer]
• /foo [string]

Because an integer parameter can only accept a certain type of input (i.e. numbers), it will have higher priority over a string parameter, and as such, if the user inputs /foo 10, the integer will be tested first, before moving on to the string.

For more details on the priority API, see PrioritySpec

Specified by:

parsePriority in interface ParameterType<CommandActor,java.lang.Boolean>

Returns:

the parse priority for this parameter

See Also:

PrioritySpec