org.apache.jmeter.config
Class Arguments

java.lang.Object
  org.apache.jmeter.testelement.AbstractTestElement
      org.apache.jmeter.config.ConfigTestElement
          org.apache.jmeter.config.Arguments

All Implemented Interfaces:

Serializable, Cloneable, ConfigElement, Searchable, TestElement

public class Arguments
extends ConfigTestElement
implements Serializable

A set of Argument objects.

See Also:

Serialized Form

Field Summary

static String

ARGUMENTS The name of the property used to store the arguments.

Fields inherited from class org.apache.jmeter.config.ConfigTestElement

PASSWORD, USERNAME

Fields inherited from interface org.apache.jmeter.testelement.TestElement

COMMENTS, ENABLED, GUI_CLASS, NAME, TEST_CLASS

Constructor Summary

Arguments()
Create a new Arguments object with no arguments.

Method Summary

void	addArgument(Argument arg) Add a new argument.
void	addArgument(String name, String value) Add a new argument with the given name and value.
void	addArgument(String name, String value, String metadata) Add a new argument with the given name, value, and metadata.
void	addEmptyArgument() Add a new empty argument to the list.
void	clear() Clear the arguments.
Argument	getArgument(int row) Get a single argument.
int	getArgumentCount() Get the number of arguments in the list.
CollectionProperty	getArguments() Get the arguments.
Map<String,String>	getArgumentsAsMap() Get the arguments as a Map.
PropertyIterator	iterator() Get a PropertyIterator of the arguments.
void	removeAllArguments() Remove all arguments from the list.
void	removeArgument(Argument arg) Remove the specified argument from the list.
void	removeArgument(int row) Remove the specified argument from the list.
void	removeArgument(String argName) Remove the argument with the specified name.
void	setArguments(List<Argument> arguments) Set the list of arguments.
String	toString() Create a string representation of the arguments.

Methods inherited from class org.apache.jmeter.config.ConfigTestElement

addConfigElement, addTestElement, expectsModification

Methods inherited from class org.apache.jmeter.testelement.AbstractTestElement

addPropertiesValues, addProperty, addProperty, canRemove, clearTemporary, clearTestElementChildren, clone, emptyTemporary, equals, getComment, getName, getProperty, getPropertyAsBoolean, getPropertyAsBoolean, getPropertyAsDouble, getPropertyAsFloat, getPropertyAsInt, getPropertyAsInt, getPropertyAsLong, getPropertyAsLong, getPropertyAsString, getPropertyAsString, getSearchableTokens, getThreadContext, getThreadName, hashCode, isEnabled, isRunningVersion, isTemporary, logProperties, mergeIn, propertyIterator, recoverRunningVersion, removeProperty, setComment, setName, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setRunningVersion, setTemporary, setThreadContext, setThreadName, traverse, traverseCollection, traverseMap, traverseProperty

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.jmeter.config.ConfigElement

clone

Field Detail

ARGUMENTS

public static final String ARGUMENTS

The name of the property used to store the arguments.

See Also:

Constant Field Values

Constructor Detail

Arguments

public Arguments()

Create a new Arguments object with no arguments.

Method Detail

getArguments

public CollectionProperty getArguments()

Get the arguments.

Returns:

the arguments

clear

public void clear()

Clear the arguments.

Specified by:

clear in interface 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

iterator

public PropertyIterator iterator()

Get a PropertyIterator of the arguments.

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

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.