org.apache.jmeter.functions

Class XPath

java.lang.Object

org.apache.jmeter.functions.AbstractFunction

org.apache.jmeter.functions.XPath

All Implemented Interfaces:

org.apache.jmeter.functions.Function

public class XPath
extends org.apache.jmeter.functions.AbstractFunction

The function represented by this class allows data to be read from XML files.

Syntax is similar to the CVSRead function. The function allows the test to line-thru the nodes in the XML file - one node per each test, e.g. inserting the following in the test scripts:

 ${_XPath(c:/BOF/abcd.xml,/xpath/)} // match the (first) node
 ${_XPath(c:/BOF/abcd.xml,/xpath/)} // Go to next match of '/xpath/' expression
 

NOTE: A single instance of each different file/expression combination is opened and used for all threads.

Since:

2.0.3

Constructor Summary

Constructors

Constructor and Description
XPath()

Method Summary

Modifier and Type	Method and Description
java.lang.String	execute(org.apache.jmeter.samplers.SampleResult previousResult, org.apache.jmeter.samplers.Sampler currentSampler)
java.util.List<java.lang.String>	getArgumentDesc()
java.lang.String	getReferenceKey()
void	setParameters(java.util.Collection<org.apache.jmeter.engine.util.CompoundVariable> parameters)

Methods inherited from class org.apache.jmeter.functions.AbstractFunction

addVariableValue, checkMinParameterCount, checkParameterCount, checkParameterCount, execute, getVariables

Methods inherited from class java.lang.Object

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

Constructor Detail

XPath

public XPath()

Method Detail

execute

public java.lang.String execute(org.apache.jmeter.samplers.SampleResult previousResult,
                                org.apache.jmeter.samplers.Sampler currentSampler)
                         throws org.apache.jmeter.functions.InvalidVariableException

Specified by:

execute in interface org.apache.jmeter.functions.Function

Specified by:

execute in class org.apache.jmeter.functions.AbstractFunction

Throws:

org.apache.jmeter.functions.InvalidVariableException

getArgumentDesc

public java.util.List<java.lang.String> getArgumentDesc()

getReferenceKey

public java.lang.String getReferenceKey()

Specified by:

getReferenceKey in interface org.apache.jmeter.functions.Function

Specified by:

getReferenceKey in class org.apache.jmeter.functions.AbstractFunction

setParameters

public void setParameters(java.util.Collection<org.apache.jmeter.engine.util.CompoundVariable> parameters)
                   throws org.apache.jmeter.functions.InvalidVariableException

Specified by:

setParameters in interface org.apache.jmeter.functions.Function

Specified by:

setParameters in class org.apache.jmeter.functions.AbstractFunction

Throws:

org.apache.jmeter.functions.InvalidVariableException