Package dev.jorel.commandapi.executors

Record Class CommandArguments

java.lang.Object
java.lang.Record
dev.jorel.commandapi.executors.CommandArguments
Record Components:
args - The arguments for this command
argsMap - The arguments for this command mapped to their node names. This is an ordered map
rawArgs - The raw arguments for this command.
rawArgsMap - The raw arguments for this command mapped to their node names. This is an ordered map
fullInput - The command string a player has entered (including the /)
public record CommandArguments(Object[] args, Map<String,Object> argsMap, String[] rawArgs, Map<String,String> rawArgsMap, String fullInput) extends Record
This class stores the arguments for this command

  • Constructor Details

    • CommandArguments

      public CommandArguments(Object[] args, Map<String,Object> argsMap, String[] rawArgs, Map<String,String> rawArgsMap, String fullInput)
      Creates an instance of a CommandArguments record class.
      Parameters:
      args - the value for the args record component
      argsMap - the value for the argsMap record component
      rawArgs - the value for the rawArgs record component
      rawArgsMap - the value for the rawArgsMap record component
      fullInput - the value for the fullInput record component

  • Method Details

    • argsMap

      public Map<String,Object> argsMap()
      Returns the value of the argsMap record component.
      Returns:
      the value of the argsMap record component

    • rawArgsMap

      public Map<String,String> rawArgsMap()
      Returns the value of the rawArgsMap record component.
      Returns:
      the value of the rawArgsMap record component

    • getFullInput

      @Deprecated(since="9.1.0", forRemoval=true) public String getFullInput()
      Deprecated, for removal: This API element is subject to removal in a future version.
      This method has been deprecated in favour of fullInput()
      This returns the raw command string a player has entered
      Returns:
      The raw command string a player has entered

    • count

      public int count()
      Returns:
      The number of arguments for this command

    • get

      @Nullable public Object get(int index)
      Returns an argument by its position
      Parameters:
      index - The position of this argument
      Returns:
      An argument which is placed at the given index, or null if the provided index does not point to an argument.

    • get

      @Nullable public Object get(String nodeName)
      Returns an argument by its node name
      Parameters:
      nodeName - The node name of this argument. This was set when initializing an argument
      Returns:
      An argument which has the given node name. Can be null if nodeName was not found.

    • getOrDefault

      public Object getOrDefault(int index, Object defaultValue)
      Returns an argument by its index
      Parameters:
      index - The position of this argument
      defaultValue - The Object returned if the argument is not existent
      Returns:
      An argument which is placed at the given index, or the provided default value

    • getOrDefault

      public Object getOrDefault(String nodeName, Object defaultValue)
      Returns an argument by its node name
      Parameters:
      nodeName - The node name of this argument. This was set when initializing an argument
      defaultValue - The Object returned if the argument was not found.
      Returns:
      The argument with the specified node name or the provided default value

    • getOrDefault

      public Object getOrDefault(int index, Supplier<?> defaultValue)
      Returns an argument by its index
      Parameters:
      index - The position of this argument
      defaultValue - The Object returned if the argument is not existent
      Returns:
      An argument which is placed at the given index, or the provided default value

    • getOrDefault

      public Object getOrDefault(String nodeName, Supplier<?> defaultValue)
      Returns an argument by its node name
      Parameters:
      nodeName - The node name of this argument. This was set when initializing an argument
      defaultValue - The Object returned if the argument was not found.
      Returns:
      The argument with the specified node name or the provided default value

    • getOptional

      public Optional<Object> getOptional(int index)
      Returns an Optional holding the argument by its index
      Parameters:
      index - The position of this argument
      Returns:
      An optional holding the argument which is placed at the given index, or an empty optional if index is invalid

    • getOptional

      public Optional<Object> getOptional(String nodeName)
      Returns an argument by its node name
      Parameters:
      nodeName - The node name of this argument. This was set when initializing an argument
      Returns:
      An optional holding the argument with the specified node name or an empty optional if the node name was not found

    • getRaw

      @Nullable public String getRaw(int index)
      Returns a raw argument by its position

      A raw argument is the String form of an argument as written in a command. For example take this command:

      /mycommand @e 15.3

      When using this method to access these arguments, @e and 15.3 will be available as Strings and not as a Collection and Double

      Parameters:
      index - The position of this argument
      Returns:
      An argument which is placed at the given index, or null if the provided index does not point to an argument.

    • getRaw

      @Nullable public String getRaw(String nodeName)
      Returns a raw argument by its node name

      A raw argument is the String form of an argument as written in a command. For example take this command:

      /mycommand @e 15.3

      When using this method to access these arguments, @e and 15.3 will be available as Strings and not as a Collection and Double

      Parameters:
      nodeName - The node name of this argument. This was set when initializing an argument
      Returns:
      A raw argument which has the given node name. Can be null if nodeName was not found.

    • getOrDefaultRaw

      public String getOrDefaultRaw(int index, String defaultValue)
      Returns a raw argument by its index

      A raw argument is the String form of an argument as written in a command. For example take this command:

      /mycommand @e 15.3

      When using this method to access these arguments, @e and 15.3 will be available as Strings and not as a Collection and Double

      Parameters:
      index - The position of this argument
      defaultValue - The String returned if the raw argument is not existent
      Returns:
      A raw argument which is placed at the given index, or the provided default value

    • getOrDefaultRaw

      public String getOrDefaultRaw(String nodeName, String defaultValue)
      Returns a raw argument by its node name

      A raw argument is the String form of an argument as written in a command. For example take this command:

      /mycommand @e 15.3

      When using this method to access these arguments, @e and 15.3 will be available as Strings and not as a Collection and Double

      Parameters:
      nodeName - The node name of this argument. This was set when initializing an argument
      defaultValue - The String returned if the raw argument was not found.
      Returns:
      A raw argument with the specified node name or the provided default value

    • getOrDefaultRaw

      public String getOrDefaultRaw(int index, Supplier<String> defaultValue)
      Returns a raw argument by its index

      A raw argument is the String form of an argument as written in a command. For example take this command:

      /mycommand @e 15.3

      When using this method to access these arguments, @e and 15.3 will be available as Strings and not as a Collection and Double

      Parameters:
      index - The position of this argument
      defaultValue - The String returned if the raw argument is not existent
      Returns:
      A raw argument which is placed at the given index, or the provided default value

    • getOrDefaultRaw

      public String getOrDefaultRaw(String nodeName, Supplier<String> defaultValue)
      Returns a raw argument by its node name

      A raw argument is the String form of an argument as written in a command. For example take this command:

      /mycommand @e 15.3

      When using this method to access these arguments, @e and 15.3 will be available as Strings and not as a Collection and Double

      Parameters:
      nodeName - The node name of this raw argument. This was set when initializing an argument
      defaultValue - The String returned if the raw argument was not found.
      Returns:
      A raw argument with the specified node name or the provided default value

    • getRawOptional

      public Optional<String> getRawOptional(int index)
      Returns an Optional holding the raw argument by its index

      A raw argument is the String form of an argument as written in a command. For example take this command:

      /mycommand @e 15.3

      When using this method to access these arguments, @e and 15.3 will be available as Strings and not as a Collection and Double

      Parameters:
      index - The position of this argument
      Returns:
      An optional holding the raw argument which is placed at the given index, or an empty optional if index is invalid

    • getRawOptional

      public Optional<String> getRawOptional(String nodeName)
      Returns an Optional holding the raw argument by its node name

      A raw argument is the String form of an argument as written in a command. For example take this command:

      /mycommand @e 15.3

      When using this method to access these arguments, @e and 15.3 will be available as Strings and not as a Collection and Double

      Parameters:
      nodeName - The node name of this argument. This was set when initializing an argument
      Returns:
      An optional holding the argument with the specified node name or an empty optional if the node name was not found

    • getUnchecked

      @Nullable public <T> T getUnchecked(int index)
      Returns an argument by its position
      Parameters:
      index - The position of this argument
      Returns:
      An argument which is placed at the given index, or null if the provided index does not point to an argument.

    • getUnchecked

      @Nullable public <T> T getUnchecked(String nodeName)
      Returns an argument by its node name
      Parameters:
      nodeName - The node name of this argument. This was set when initializing an argument
      Returns:
      An argument which has the given node name. Can be null if nodeName was not found.

    • getOrDefaultUnchecked

      public <T> T getOrDefaultUnchecked(int index, T defaultValue)
      Returns an argument by its index
      Parameters:
      index - The position of this argument
      defaultValue - The Object returned if the argument is not existent
      Returns:
      An argument which is placed at the given index, or the provided default value

    • getOrDefaultUnchecked

      public <T> T getOrDefaultUnchecked(String nodeName, T defaultValue)
      Returns an argument by its node name
      Parameters:
      nodeName - The node name of this argument. This was set when initializing an argument
      defaultValue - The Object returned if the argument was not found.
      Returns:
      The argument with the specified node name or the provided default value

    • getOrDefaultUnchecked

      public <T> T getOrDefaultUnchecked(int index, Supplier<T> defaultValue)
      Returns an argument by its index
      Parameters:
      index - The position of this argument
      defaultValue - The Object returned if the argument is not existent
      Returns:
      An argument which is placed at the given index, or the provided default value

    • getOrDefaultUnchecked

      public <T> T getOrDefaultUnchecked(String nodeName, Supplier<T> defaultValue)
      Returns an argument by its node name
      Parameters:
      nodeName - The node name of this argument. This was set when initializing an argument
      defaultValue - The Object returned if the argument was not found.
      Returns:
      The argument with the specified node name or the provided default value

    • getOptionalUnchecked

      public <T> Optional<T> getOptionalUnchecked(int index)
      Returns an Optional holding the argument at its index
      Parameters:
      index - The position of this argument
      Returns:
      An optional holding the argument at its index, or an empty optional if the index was invalid

    • getOptionalUnchecked

      public <T> Optional<T> getOptionalUnchecked(String nodeName)
      Returns an Optional holding the argument by its node name
      Parameters:
      nodeName - The node name of this argument. This was set when initializing an argument
      Returns:
      An optional holding the argument with the specified node name, or an empty optional if the index was invalid

    • toString

      public final String toString()
      Returns a string representation of this record class. The representation contains the name of the class, followed by the name and value of each of the record components.
      Specified by:
      toString in class Record
      Returns:
      a string representation of this object

    • hashCode

      public final int hashCode()
      Returns a hash code value for this object. The value is derived from the hash code of each of the record components.
      Specified by:
      hashCode in class Record
      Returns:
      a hash code value for this object

    • equals

      public final boolean equals(Object o)
      Indicates whether some other object is "equal to" this one. The objects are equal if the other object is of the same class and if all the record components are equal. All components in this record class are compared with Objects::equals(Object,Object).
      Specified by:
      equals in class Record
      Parameters:
      o - the object with which to compare
      Returns:
      true if this object is the same as the o argument; false otherwise.

    • args

      public Object[] args()
      Returns the value of the args record component.
      Returns:
      the value of the args record component

    • rawArgs

      public String[] rawArgs()
      Returns the value of the rawArgs record component.
      Returns:
      the value of the rawArgs record component

    • fullInput

      public String fullInput()
      Returns the value of the fullInput record component.
      Returns:
      the value of the fullInput record component