Package net.dv8tion.jda.api.interactions.commands.build

Class OptionData

java.lang.Object

net.dv8tion.jda.api.interactions.commands.build.OptionData

All Implemented Interfaces:

SerializableData

public class OptionData
extends Object
implements SerializableData

Builder for a Slash-Command option.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	MAX_CHOICE_NAME_LENGTH	The maximum length of the name of Command Option Choice names
static final int	MAX_CHOICE_VALUE_LENGTH	The maximum length a String value for a choice can be.
static final int	MAX_CHOICES	The total amount of choices you can set.
static final int	MAX_DESCRIPTION_LENGTH	The maximum length the description of an option can be.
static final int	MAX_NAME_LENGTH	The maximum length the name of an option can be.
static final double	MAX_POSITIVE_NUMBER	The highest positive amount Discord allows the NUMBER type to be.
static final double	MIN_NEGATIVE_NUMBER	The largest negative amount Discord allows the NUMBER type to be.

Constructor Summary

Constructors

Constructor	Description
OptionData(OptionType type, String name, String description)	Create an option builder.
OptionData(OptionType type, String name, String description, boolean isRequired)	Create an option builder.
OptionData(OptionType type, String name, String description, boolean isRequired, boolean isAutoComplete)	Create an option builder.

Method Summary

Modifier and Type	Method	Description
OptionData	addChoice(String name, double value)	Add a predefined choice for this option.
OptionData	addChoice(String name, long value)	Add a predefined choice for this option.
OptionData	addChoice(String name, String value)	Add a predefined choice for this option.
OptionData	addChoices(Collection<? extends Command.Choice> choices)	Adds up to 25 predefined choices for this option.
OptionData	addChoices(Command.Choice... choices)	Adds up to 25 predefined choices for this option.
static OptionData	fromData(DataObject json)	Parses the provided serialization back into an OptionData instance.
static OptionData	fromOption(Command.Option option)	Converts the provided Command.Option into a OptionData instance.
EnumSet<ChannelType>	getChannelTypes()	The ChannelTypes this option is restricted to.
List<Command.Choice>	getChoices()	The choices for this option.
String	getDescription()	The description for this option
Number	getMaxValue()	The maximum value which can be provided for this option.
Number	getMinValue()	The minimum value which can be provided for this option.
String	getName()	The name for this option
OptionType	getType()	The OptionType for this option
boolean	isAutoComplete()	Whether this option supports auto-complete interactions via CommandAutoCompleteInteractionEvent.
boolean	isRequired()	Whether this option is required.
OptionData	setAutoComplete(boolean autoComplete)	Configure whether this option should support auto-complete interactions via CommandAutoCompleteInteractionEvent.
OptionData	setChannelTypes(Collection<ChannelType> channelTypes)	Configure the ChannelTypes to restrict this option to.
OptionData	setChannelTypes(ChannelType... channelTypes)	Configure the ChannelTypes to restrict this option to.
OptionData	setDescription(String description)	Configure the description
OptionData	setMaxValue(double value)	Configure the maximal value which can be provided for this option.
OptionData	setMaxValue(long value)	Configure the maximal value which can be provided for this option.
OptionData	setMinValue(double value)	Configure the minimal value which can be provided for this option.
OptionData	setMinValue(long value)	Configure the minimal value which can be provided for this option.
OptionData	setName(String name)	Configure the name
OptionData	setRequired(boolean required)	Configure whether the user must set this option.
OptionData	setRequiredRange(double minValue, double maxValue)	Configure the minimal and maximal value which can be provided for this option.
OptionData	setRequiredRange(long minValue, long maxValue)	Configure the minimal and maximal value which can be provided for this option.
DataObject	toData()	Serialized DataObject for this object.

Methods inherited from class java.lang.Object

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

Field Details

MAX_POSITIVE_NUMBER

public static final double MAX_POSITIVE_NUMBER

The highest positive amount Discord allows the NUMBER type to be.

See Also:

• Constant Field Values

MIN_NEGATIVE_NUMBER

public static final double MIN_NEGATIVE_NUMBER

The largest negative amount Discord allows the NUMBER type to be.

See Also:

• Constant Field Values

MAX_NAME_LENGTH

public static final int MAX_NAME_LENGTH

The maximum length the name of an option can be.

See Also:

• Constant Field Values

MAX_CHOICE_NAME_LENGTH

public static final int MAX_CHOICE_NAME_LENGTH

The maximum length of the name of Command Option Choice names

See Also:

• Constant Field Values

MAX_DESCRIPTION_LENGTH

public static final int MAX_DESCRIPTION_LENGTH

The maximum length the description of an option can be.

See Also:

• Constant Field Values

MAX_CHOICE_VALUE_LENGTH

public static final int MAX_CHOICE_VALUE_LENGTH

The maximum length a String value for a choice can be.

See Also:

• Constant Field Values

MAX_CHOICES

public static final int MAX_CHOICES

The total amount of choices you can set.

See Also:

• Constant Field Values

Constructor Details

OptionData

public OptionData(@Nonnull
 OptionType type,
 @Nonnull
 String name,
 @Nonnull
 String description)

Create an option builder.
This option is not required by default.

Parameters:

type - The OptionType

name - The option name, up to 32 alphanumeric (with dash) lowercase characters, as defined by MAX_NAME_LENGTH

description - The option description, up to 100 characters, as defined by MAX_DESCRIPTION_LENGTH

Throws:

IllegalArgumentException - If any of the following checks fail

• type is not null
• name is alphanumeric (with dash), lowercase and between 1 and 32 characters long
• description is between 1 and 100 characters long

OptionData

public OptionData(@Nonnull
 OptionType type,
 @Nonnull
 String name,
 @Nonnull
 String description,
 boolean isRequired)

Create an option builder.

Parameters:

type - The OptionType

name - The option name, up to 32 alphanumeric (with dash) lowercase characters, as defined by MAX_NAME_LENGTH

description - The option description, up to 100 characters, as defined by MAX_DESCRIPTION_LENGTH

isRequired - True, if this option is required

Throws:

IllegalArgumentException - If any of the following checks fail

• type is not null
• name is alphanumeric (with dash), lowercase and between 1 and 32 characters long
• description is between 1 and 100 characters long

OptionData

public OptionData(@Nonnull
 OptionType type,
 @Nonnull
 String name,
 @Nonnull
 String description,
 boolean isRequired,
 boolean isAutoComplete)

Create an option builder.

Parameters:

type - The OptionType

name - The option name, up to 32 alphanumeric (with dash) lowercase characters, as defined by MAX_NAME_LENGTH

description - The option description, up to 100 characters, as defined by MAX_DESCRIPTION_LENGTH

isRequired - True, if this option is required

isAutoComplete - True, if auto-complete should be supported (requires OptionType.canSupportChoices())

Throws:

IllegalArgumentException - If any of the following checks fail

• type is not null
• name is alphanumeric (with dash), lowercase and between 1 and 32 characters long
• description is between 1 and 100 characters long
• OptionType.canSupportChoices() is false then isAutoComplete is also false

Method Details

getType

@Nonnull
public OptionType getType()

The OptionType for this option

Returns:

The OptionType

getName

@Nonnull
public String getName()

The name for this option

Returns:

The name

getDescription

@Nonnull
public String getDescription()

The description for this option

Returns:

The description

isRequired

public boolean isRequired()

Whether this option is required.
This can be configured with setRequired(boolean).

Required options must always be set by the command invocation.

Returns:

True, if this option is required

isAutoComplete

public boolean isAutoComplete()

Whether this option supports auto-complete interactions via CommandAutoCompleteInteractionEvent.

Returns:

True, if this option supports auto-complete

getChannelTypes

@Nonnull
public EnumSet<ChannelType> getChannelTypes()

The ChannelTypes this option is restricted to.
This is empty if the option is not of type CHANNEL or not restricted to specific types.

Returns:

EnumSet of ChannelType

getMinValue

@Nullable
public Number getMinValue()

The minimum value which can be provided for this option.
This returns null if the value is not set or if the option is not of type INTEGER or NUMBER.

Returns:

The minimum value for this option

getMaxValue

@Nullable
public Number getMaxValue()

The maximum value which can be provided for this option.
This returns null if the value is not set or if the option is not of type INTEGER or NUMBER.

Returns:

The maximum value for this option

getChoices

@Nonnull
public List<Command.Choice> getChoices()

The choices for this option.
This is empty by default and can only be configured for specific option types.

Returns:

Immutable list of Choices

See Also:

• addChoice(String, long)
• addChoice(String, String)

setName

@Nonnull
public OptionData setName(@Nonnull
 String name)

Configure the name

Parameters:

name - The lowercase alphanumeric (with dash) name, 1-32 characters long

Returns:

The OptionData instance, for chaining

Throws:

IllegalArgumentException - If the name is null, empty, not alphanumeric, or not between 1-32 characters long, as defined by MAX_NAME_LENGTH

setDescription

@Nonnull
public OptionData setDescription(@Nonnull
 String description)

Configure the description

Parameters:

description - The description, 1-100 characters, as defined by MAX_DESCRIPTION_LENGTH

Returns:

The OptionData instance, for chaining

Throws:

IllegalArgumentException - If the name is null or larger than MAX_DESCRIPTION_LENGTH

setRequired

@Nonnull
public OptionData setRequired(boolean required)

Configure whether the user must set this option.
Required options must always be filled out when using the command.

Parameters:

required - True, if this option is required

Returns:

The OptionData instance, for chaining

setAutoComplete

@Nonnull
public OptionData setAutoComplete(boolean autoComplete)

Configure whether this option should support auto-complete interactions via CommandAutoCompleteInteractionEvent.

This is only supported for options which support choices. See OptionType.canSupportChoices().

Parameters:

autoComplete - True, if auto-complete should be supported

Returns:

The OptionData instance, for chaining

Throws:

IllegalStateException - If this option is already configured to use choices or the option type does not support auto-complete

setChannelTypes

@Nonnull
public OptionData setChannelTypes(@Nonnull
 ChannelType... channelTypes)

Configure the ChannelTypes to restrict this option to. This only applies to options of type CHANNEL.

Parameters:

channelTypes - The ChannelTypes to restrict this option to or empty array to accept all ChannelTypes

Returns:

The OptionData instance, for chaining

Throws:

IllegalArgumentException - If any of the following checks fail

• type of this option is CHANNEL
• channelTypes doesn't contain null
• channelTypes only contains guild channels

setChannelTypes

@Nonnull
public OptionData setChannelTypes(@Nonnull
 Collection<ChannelType> channelTypes)

Configure the ChannelTypes to restrict this option to. This only applies to options of type CHANNEL.

Parameters:

channelTypes - The ChannelTypes to restrict this option to or empty collection to accept all ChannelTypes

Returns:

The OptionData instance, for chaining

Throws:

IllegalArgumentException - If any of the following checks fail

• type of this option is CHANNEL
• channelTypes is not null
• channelTypes doesn't contain null
• channelTypes only contains guild channels

setMinValue

@Nonnull
public OptionData setMinValue(long value)

Configure the minimal value which can be provided for this option.

Parameters:

value - The minimal value which can be provided for this option.

Returns:

The OptionData instance, for chaining

Throws:

IllegalArgumentException - If any of the following checks fail

• type of this option is INTEGER or NUMBER
• value is larger than or equal to MIN_NEGATIVE_NUMBER

setMinValue

@Nonnull
public OptionData setMinValue(double value)

Configure the minimal value which can be provided for this option.

Parameters:

value - The minimal value which can be provided for this option.

Returns:

The OptionData instance, for chaining

Throws:

IllegalArgumentException - If any of the following checks fail

• type of this option is NUMBER
• value is larger than or equal to MIN_NEGATIVE_NUMBER

setMaxValue

@Nonnull
public OptionData setMaxValue(long value)

Configure the maximal value which can be provided for this option.

Parameters:

value - The maximal value which can be provided for this option.

Returns:

The OptionData instance, for chaining

Throws:

IllegalArgumentException - If any of the following checks fail

• type of this option is INTEGER or NUMBER
• value is lower than or equal to MAX_POSITIVE_NUMBER

setMaxValue

@Nonnull
public OptionData setMaxValue(double value)

Configure the maximal value which can be provided for this option.

Parameters:

value - The maximal value which can be provided for this option.

Returns:

The OptionData instance, for chaining

Throws:

IllegalArgumentException - If any of the following checks fail

• type of this option is NUMBER
• value is lower than or equal to MAX_POSITIVE_NUMBER

setRequiredRange

@Nonnull
public OptionData setRequiredRange(long minValue,
 long maxValue)

Configure the minimal and maximal value which can be provided for this option.

Parameters:

minValue - The minimal value which can be provided for this option.

maxValue - The maximal value which can be provided for this option.

Returns:

The OptionData instance, for chaining

Throws:

IllegalArgumentException - If any of the following checks fail

• type of this option is INTEGER or NUMBER
• minValue is larger than or equal to MIN_NEGATIVE_NUMBER
• maxValue is lower than or equal to MAX_POSITIVE_NUMBER

setRequiredRange

@Nonnull
public OptionData setRequiredRange(double minValue,
 double maxValue)

Configure the minimal and maximal value which can be provided for this option.

Parameters:

minValue - The minimal value which can be provided for this option.

maxValue - The maximal value which can be provided for this option.

Returns:

The OptionData instance, for chaining

Throws:

IllegalArgumentException - If any of the following checks fail

• type of this option is NUMBER
• minValue is larger than or equal to MIN_NEGATIVE_NUMBER
• maxValue is lower than or equal to MAX_POSITIVE_NUMBER

addChoice

@Nonnull
public OptionData addChoice(@Nonnull
 String name,
 double value)

Add a predefined choice for this option.
The user can only provide one of the choices and cannot specify any other value.

Parameters:

name - The name used in the client, up to 100 characters long, as defined by MAX_CHOICE_NAME_LENGTH

value - The value received in OptionMapping

Returns:

The OptionData instance, for chaining

Throws:

IllegalArgumentException - If any of the following checks fail

• name is not null, empty and less or equal to 100 characters long
• value is not less than MIN_NEGATIVE_NUMBER and not larger than MAX_POSITIVE_NUMBER
• The amount of already set choices is less than MAX_CHOICES
• The OptionType is OptionType.NUMBER
• The option is not auto-complete enabled

addChoice

@Nonnull
public OptionData addChoice(@Nonnull
 String name,
 long value)

Add a predefined choice for this option.
The user can only provide one of the choices and cannot specify any other value.

Parameters:

name - The name used in the client

value - The value received in OptionMapping

Returns:

The OptionData instance, for chaining

Throws:

IllegalArgumentException - If any of the following checks fail

• name is not null, empty and less or equal to 100 characters long
• value is not less than MIN_NEGATIVE_NUMBER and not larger than MAX_POSITIVE_NUMBER
• The amount of already set choices is less than MAX_CHOICES
• The OptionType is OptionType.INTEGER
• The option is not auto-complete enabled

addChoice

@Nonnull
public OptionData addChoice(@Nonnull
 String name,
 @Nonnull
 String value)

Add a predefined choice for this option.
The user can only provide one of the choices and cannot specify any other value.

Parameters:

name - The name used in the client

value - The value received in OptionMapping

Returns:

The OptionData instance, for chaining

Throws:

IllegalArgumentException - If any of the following checks fail

• name is not null, empty and less or equal to 100 characters long
• value is not null, empty and less or equal to 100 characters long
• The amount of already set choices is less than MAX_CHOICES
• The OptionType is OptionType.STRING
• The option is not auto-complete enabled

addChoices

@Nonnull
public OptionData addChoices(@Nonnull
 Command.Choice... choices)

Adds up to 25 predefined choices for this option.
The user can only provide one of the choices and cannot specify any other value.

Parameters:

choices - The choices to add

Returns:

The OptionData instance, for chaining

Throws:

IllegalArgumentException - If any of the following checks fail

• The OptionType does support choices
• The provided choices are not null
• The amount of choices provided is smaller than MAX_CHOICES when combined with already set choices
• The OptionType of the choices is either OptionType.INTEGER, OptionType.STRING or OptionType.NUMBER
• The option is not auto-complete enabled

addChoices

@Nonnull
public OptionData addChoices(@Nonnull
 Collection<? extends Command.Choice> choices)

Adds up to 25 predefined choices for this option.
The user can only provide one of the choices and cannot specify any other value.

Parameters:

choices - The choices to add

Returns:

The OptionData instance, for chaining

Throws:

IllegalArgumentException - If any of the following checks fail

• The OptionType does support choices
• The provided choices are not null
• The amount of choices provided is smaller than MAX_CHOICES when combined with already set choices
• The OptionType of the choices is either OptionType.INTEGER, OptionType.STRING or OptionType.NUMBER
• The option is not auto-complete enabled

toData

@Nonnull
public DataObject toData()

Description copied from interface: SerializableData

Serialized DataObject for this object.

Specified by:

toData in interface SerializableData

Returns:

DataObject

fromData

@Nonnull
public static OptionData fromData(@Nonnull
 DataObject json)

Parses the provided serialization back into an OptionData instance.
This is the reverse function for toData().

Parameters:

json - The serialized DataObject representing the option

Returns:

The parsed OptionData instance, which can be further configured through setters

Throws:

ParsingException - If the serialized object is missing required fields

IllegalArgumentException - If any of the values are failing the respective checks such as length

fromOption

@Nonnull
public static OptionData fromOption(@Nonnull
 Command.Option option)

Converts the provided Command.Option into a OptionData instance.

Parameters:

option - The option to convert

Returns:

An instance of OptionData

Throws:

IllegalArgumentException - If null is provided or the option has illegal configuration