Class Arguments

All Implemented Interfaces:
Serializable, Cloneable, Iterable<JMeterProperty>, ConfigElement, Searchable, org.apache.jmeter.testelement.TestElement

public class Arguments extends ConfigTestElement implements Serializable, Iterable<JMeterProperty>
A set of Argument objects.
See Also:
  • Field Details

    • ARGUMENTS

      public static final String ARGUMENTS
      The name of the property used to store the arguments.
      See Also:
  • Constructor Details

    • Arguments

      public Arguments()
      Create a new Arguments object with no arguments.
  • Method Details

    • getSchema

      public org.apache.jmeter.config.ArgumentsSchema getSchema()
      Specified by:
      getSchema in interface org.apache.jmeter.testelement.TestElement
      Overrides:
      getSchema in class ConfigTestElement
    • getProps

      public org.apache.jmeter.testelement.schema.PropertiesAccessor<? extends Arguments,? extends org.apache.jmeter.config.ArgumentsSchema> getProps()
      Specified by:
      getProps in interface org.apache.jmeter.testelement.TestElement
      Overrides:
      getProps in class ConfigTestElement
    • getArguments

      public CollectionProperty getArguments()
      Get the arguments.
      Returns:
      the arguments
    • clear

      public void clear()
      Clear the arguments.
      Specified by:
      clear in interface org.apache.jmeter.testelement.TestElement
      Overrides:
      clear in class AbstractTestElement
    • setArguments

      public void setArguments(List<Argument> arguments)
      Set the list of arguments. Any existing arguments will be lost.
      Parameters:
      arguments - the new arguments
    • getArgumentsAsMap

      public Map<String,String> getArgumentsAsMap()
      Get the arguments as a Map. Each argument name is used as the key, and its value as the value.
      Returns:
      a new Map with String keys and values containing the arguments
    • addArgument

      public void addArgument(String name, String value)
      Add a new argument with the given name and value.
      Parameters:
      name - the name of the argument
      value - the value of the argument
    • addArgument

      public void addArgument(Argument arg)
      Add a new argument.
      Parameters:
      arg - the new argument
    • addArgument

      public void addArgument(String name, String value, String metadata)
      Add a new argument with the given name, value, and metadata.
      Parameters:
      name - the name of the argument
      value - the value of the argument
      metadata - the metadata for the argument
    • addArgument

      public void addArgument(String name, String value, String metadata, String description)
      Add a new argument with the given name, value, metadata and description
      Parameters:
      name - the name of the argument
      value - the value of the argument
      metadata - the metadata for the argument
      description - the argument description
    • iterator

      public PropertyIterator iterator()
      Get a PropertyIterator of the arguments.
      Specified by:
      iterator in interface Iterable<JMeterProperty>
      Returns:
      an iteration of the arguments
    • toString

      public String toString()
      Create a string representation of the arguments.
      Overrides:
      toString in class Object
      Returns:
      the string representation of the arguments
    • removeArgument

      public void removeArgument(int row)
      Remove the specified argument from the list.
      Parameters:
      row - the index of the argument to remove
    • removeArgument

      public void removeArgument(Argument arg)
      Remove the specified argument from the list.
      Parameters:
      arg - the argument to remove
    • removeArgument

      public void removeArgument(String argName)
      Remove the argument with the specified name.
      Parameters:
      argName - the name of the argument to remove
    • removeArgument

      public void removeArgument(String argName, String argValue)
      Remove the argument with the specified name and value.
      Parameters:
      argName - the name of the argument to remove
      argValue - the value to compare - must not be null
    • removeAllArguments

      public void removeAllArguments()
      Remove all arguments from the list.
    • addEmptyArgument

      public void addEmptyArgument()
      Add a new empty argument to the list. The new argument will have the empty string as its name and value, and null metadata.
    • getArgumentCount

      public int getArgumentCount()
      Get the number of arguments in the list.
      Returns:
      the number of arguments
    • getArgument

      public Argument getArgument(int row)
      Get a single argument.
      Parameters:
      row - the index of the argument to return.
      Returns:
      the argument at the specified index, or null if no argument exists at that index.