Package org.apache.jmeter.protocol.ldap.sampler

# Class LDAPExtSampler

java.lang.Object
org.apache.jmeter.testelement.AbstractTestElement
org.apache.jmeter.samplers.AbstractSampler
org.apache.jmeter.protocol.ldap.sampler.LDAPExtSampler

All Implemented Interfaces:
  `Serializable`, `Cloneable`, `ConfigMergabilityIndicator`, `Searchable`, `Sampler`, `org.apache.jmeter.testelement.TestElement`, `TestStateListener`

public class LDAPExtSampler extends AbstractSampler implements TestStateListener
Ldap Sampler class is main class for the LDAP test. This will control all the test available in the LDAP Test.

See Also:
  - Serialized Form

## Nested Class Summary

## Nested classes/interfaces inherited from interface org.apache.jmeter.testelement.TestElement

`org.apache.jmeter.testelement.TestElement.Companion`

## Field Summary

Fields
Modifier and Type
Field
Description
`static final String`
`ADD`
`static final String`
`ARGUMENTS`
`static final String`
`ATTRIBS`
`static final String`
`BASE_ENTRY_DN`
`static final String`
`BIND`
`static final String`
`COMPARE`
`static final String`
`COMPAREDN`
`static final String`
`COMPAREFILT`
`static final String`
`CONNTO`
`static final String`
`COUNTLIM`
`static final String`
`DELETE`
`static final String`
`DEREF`
`static final String`
`LDAPARGUMENTS`
`static final String`
`MODDDN`
`static final String`
`MODIFY`
`static final String`
`NEWDN`
`static final String`
`PARSEFLAG`
`static final String`
`PORT`
`static final String`
`RENAME`
`static final String`
`RETOBJ`
`static final String`
`ROOTDN`
`static final String`
`SBIND`
`static final String`
`SCOPE`
`static final String`
`SEARCH`
`static final String`
`SEARCHBASE`
`static final String`
`SEARCHFILTER`
`static final String`
`SECURE`
`static final String`
`SERVERNAME`
`static final String`
`TEST`
`static final String`
`TIMELIM`
`static final String`
`TRUSTALL`
`static final String`
`UNBIND`
`static final String`
`USERDN`
`static final String`
`USERPW`

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

`COMMENTS, Companion, ENABLED, GUI_CLASS, NAME, TEST_CLASS`

## Constructor Summary

Constructors
Constructor
Description
`LDAPExtSampler()`

## Method Summary

Modifier and Type
Method
Description
`boolean`
`applies(ConfigTestElement configElement)`
Does configElement apply to Sampler
`Arguments`
`getArguments()`
Gets the Arguments attribute of the LdapConfig object
`String`
`getAttrs()`
Gets the attributes of the LDAPSampler object
`String`
`getBaseEntryDN()`
Gets the BaseEntryDN attribute of the LDAPSampler object
`String`
`getConnTimeOut()`
`String`
`getCountlim()`
Gets the size limit attribute of the LDAPSampler object
`long`
`getCountlimAsLong()`
`String`
`getLabel()`
Returns a formatted string label describing this sampler Example output:
`LDAPArguments`
`getLDAPArguments()`
Gets the LDAPArguments attribute of the LdapConfig object
`String`
`getPort()`
Gets the Port attribute of the LDAPSampler object
`String`
`getRootdn()`
Gets the Rootdn attribute of the LDAPSampler object
`String`
`getScope()`
Gets the search scope attribute of the LDAPSampler object
`int`
`getScopeAsInt()`
`String`
`getServername()`
Gets the servername attribute of the LDAPSampler object
`String`
`getTest()`
Gets the test attribute of the LDAPSampler object
`String`
`getTimelim()`
Gets the time limit attribute of the LDAPSampler object
`int`
`getTimelimAsInt()`
`String`
`getUserDN()`
Gets the username attribute of the LDAP object
`String`
`getUserPw()`
Gets the password attribute of the LDAP object
`boolean`
`isDeref()`
Gets the deref attribute of the LDAPSampler object
`boolean`
`isParseFlag()`
`boolean`
`isRetobj()`
Gets the return objects attribute of the LDAPSampler object
`boolean`
`isSecure()`
`boolean`
`isTrustAll()`
`SampleResult`
`sample(Entry e)`
Obtains statistics about the given Entry, and packages the information into a SampleResult.
`void`
`setArguments(Arguments value)`
Sets the Arguments attribute of the LdapConfig object This will collect values from the table for user defined test case
`void`
`setAttrs(String newAttrs)`
Sets the attributes of the LdapConfig object
`void`
`setBaseEntryDN(String newbaseentry)`
Sets the Base Entry DN attribute of the LDAPSampler object
`void`
`setConnTimeOut(String connto)`
`void`
`setCountlim(String newClim)`
Sets the size limit attribute of the LDAPSampler object
`void`
`setDeref(String newDref)`
Sets the deref attribute of the LDAPSampler object
`void`
`setLDAPArguments(LDAPArguments value)`
Sets the Arguments attribute of the LdapConfig object This will collect values from the table for user defined test case
`void`
`setParseFlag(String parseFlag)`
`void`
`setPort(String port)`
Sets the Port attribute of the ServerConfig object
`void`
`setRetobj(String newRobj)`
Sets the return objects attribute of the LDAPSampler object
`void`
`setRootdn(String newRootdn)`
Sets the Rootdn attribute of the LDAPSampler object
`void`
`setScope(String newScope)`
Sets the search scope attribute of the LDAPSampler object
`void`
`setSecure(String sec)`
`void`
`setServername(String servername)`
Sets the Servername attribute of the ServerConfig object
`void`
`setTest(String newTest)`
Sets the Test attribute of the LdapConfig object
`void`
`setTimelim(String newTlim)`
Sets the time limit attribute of the LDAPSampler object
`void`
`setTrustAll(String trust)`
`void`
`setUserDN(String newUserDN)`
Sets the username attribute of the LDAP object
`void`
`setUserPw(String newUserPw)`
Sets the password attribute of the LDAP object
`void`
`testEnded()`
Called once for all threads after the end of a test.
`void`
`testEnded(String host)`
Called once for all threads after the end of a test.
`void`
`testStarted()`
Called just before the start of the test from the main engine thread.
`void`
`testStarted(String host)`
Called just before the start of the test from the main engine thread.

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

`addPropertiesValues, addProperty, addProperty, addTestElement, canRemove, clear, clearTemporary, clearTestElementChildren, clone, emptyTemporary, equals, getComment, getName, getProperty, getPropertyAsBoolean, getPropertyAsBoolean, getPropertyAsDouble, getPropertyAsFloat, getPropertyAsInt, getPropertyAsInt, getPropertyAsLong, getPropertyAsLong, getPropertyAsString, getPropertyAsString, getPropertyOrNull, getSearchableTokens, getThreadContext, getThreadName, hashCode, isEnabled, isRunningVersion, isTemporary, logProperties, mergeIn, propertyIterator, recoverRunningVersion, removeProperty, setComment, setEnabled, setName, setProperty, setProperty, 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, toString, wait, wait, wait`

### Methods inherited from interface org.apache.jmeter.testelement.TestElement

`addTestElement, canRemove, clear, clearTestElementChildren, clone, get, get, get, get, get, get, get, get, get, getComment, getName, getOrCreate, getOrCreate, getOrNull, getOrNull, getOrNull, getProperty, getPropertyAsBoolean, getPropertyAsBoolean, getPropertyAsDouble, getPropertyAsFloat, getPropertyAsInt, getPropertyAsInt, getPropertyAsLong, getPropertyAsLong, getPropertyAsString, getPropertyAsString, getPropertyOrNull, getPropertyOrNull, getProps, getSchema, getString, getThreadContext, getThreadName, isEnabled, isRunningVersion, isTemporary, propertyIterator, recoverRunningVersion, removed, removeProperty, removeProperty, set, set, set, set, set, set, set, set, set, setComment, setEnabled, setName, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setRunningVersion, setTemporary, setThreadContext, setThreadName, traverse`

## Field Details

### SERVERNAME

public static final String SERVERNAME

See Also:
  - Constant Field Values

### PORT

public static final String PORT

See Also:
  - Constant Field Values

### SECURE

public static final String SECURE

See Also:
  - Constant Field Values

### TRUSTALL

public static final String TRUSTALL

See Also:
  - Constant Field Values

### ROOTDN

public static final String ROOTDN

See Also:
  - Constant Field Values

### TEST

public static final String TEST

See Also:
  - Constant Field Values

### ADD

public static final String ADD

See Also:
  - Constant Field Values

### MODIFY

public static final String MODIFY

See Also:
  - Constant Field Values

### BIND

public static final String BIND

See Also:
  - Constant Field Values

### UNBIND

public static final String UNBIND

See Also:
  - Constant Field Values

### DELETE

public static final String DELETE

See Also:
  - Constant Field Values

### SEARCH

public static final String SEARCH

See Also:
  - Constant Field Values

### SEARCHBASE

public static final String SEARCHBASE

See Also:
  - Constant Field Values

### SEARCHFILTER

public static final String SEARCHFILTER

See Also:
  - Constant Field Values

### ARGUMENTS

public static final String ARGUMENTS

See Also:
  - Constant Field Values

### LDAPARGUMENTS

public static final String LDAPARGUMENTS

See Also:
  - Constant Field Values

### BASE_ENTRY_DN

public static final String BASE_ENTRY_DN

See Also:
  - Constant Field Values

### SCOPE

public static final String SCOPE

See Also:
  - Constant Field Values

### COUNTLIM

public static final String COUNTLIM

See Also:
  - Constant Field Values

### TIMELIM

public static final String TIMELIM

See Also:
  - Constant Field Values

### ATTRIBS

public static final String ATTRIBS

See Also:
  - Constant Field Values

### RETOBJ

public static final String RETOBJ

See Also:
  - Constant Field Values

### DEREF

public static final String DEREF

See Also:
  - Constant Field Values

### USERDN

public static final String USERDN

See Also:
  - Constant Field Values

### USERPW

public static final String USERPW

See Also:
  - Constant Field Values

### SBIND

public static final String SBIND

See Also:
  - Constant Field Values

### COMPARE

public static final String COMPARE

See Also:
  - Constant Field Values

### CONNTO

public static final String CONNTO

See Also:
  - Constant Field Values

### COMPAREDN

public static final String COMPAREDN

See Also:
  - Constant Field Values

### COMPAREFILT

public static final String COMPAREFILT

See Also:
  - Constant Field Values

### PARSEFLAG

public static final String PARSEFLAG

See Also:
  - Constant Field Values

### RENAME

public static final String RENAME

See Also:
  - Constant Field Values

### MODDDN

public static final String MODDDN

See Also:
  - Constant Field Values

### NEWDN

public static final String NEWDN

See Also:
  - Constant Field Values

## Constructor Details

### LDAPExtSampler

public LDAPExtSampler()

## Method Details

### setConnTimeOut

public void setConnTimeOut(String connto)

### getConnTimeOut

public String getConnTimeOut()

### setSecure

public void setSecure(String sec)

### isSecure

public boolean isSecure()

### setTrustAll

public void setTrustAll(String trust)

### isTrustAll

public boolean isTrustAll()

### isParseFlag

public boolean isParseFlag()

### setParseFlag

public void setParseFlag(String parseFlag)

### getUserDN

public String getUserDN()
Gets the username attribute of the LDAP object

Returns:
  The username

### setUserDN

public void setUserDN(String newUserDN)
Sets the username attribute of the LDAP object

Parameters:
  `newUserDN` - distinguished name of the user

### getUserPw

public String getUserPw()
Gets the password attribute of the LDAP object

Returns:
  The password

### setUserPw

public void setUserPw(String newUserPw)
Sets the password attribute of the LDAP object

Parameters:
  `newUserPw` - password of the user

### setServername

public void setServername(String servername)
Sets the Servername attribute of the ServerConfig object

Parameters:
  `servername` - The new servername value

### setPort

public void setPort(String port)
Sets the Port attribute of the ServerConfig object

Parameters:
  `port` - The new Port value

### getServername

public String getServername()
Gets the servername attribute of the LDAPSampler object

Returns:
  The Servername value

### getPort

public String getPort()
Gets the Port attribute of the LDAPSampler object

Returns:
  The Port value

### setRootdn

public void setRootdn(String newRootdn)
Sets the Rootdn attribute of the LDAPSampler object

Parameters:
  `newRootdn` - The new rootdn value

### getRootdn

public String getRootdn()
Gets the Rootdn attribute of the LDAPSampler object

Returns:
  The Rootdn value

### getScope

public String getScope()
Gets the search scope attribute of the LDAPSampler object

Returns:
  The scope value

### getScopeAsInt

public int getScopeAsInt()

### setScope

public void setScope(String newScope)
Sets the search scope attribute of the LDAPSampler object

Parameters:
  `newScope` - The new scope value

### getCountlim

public String getCountlim()
Gets the size limit attribute of the LDAPSampler object

Returns:
  The size limit

### getCountlimAsLong

public long getCountlimAsLong()

### setCountlim

public void setCountlim(String newClim)
Sets the size limit attribute of the LDAPSampler object

Parameters:
  `newClim` - The new size limit value

### getTimelim

public String getTimelim()
Gets the time limit attribute of the LDAPSampler object

Returns:
  The time limit

### getTimelimAsInt

public int getTimelimAsInt()

### setTimelim

public void setTimelim(String newTlim)
Sets the time limit attribute of the LDAPSampler object

Parameters:
  `newTlim` - The new time limit value

### isRetobj

public boolean isRetobj()
Gets the return objects attribute of the LDAPSampler object

Returns:
  if the object(s) are to be returned

### setRetobj

public void setRetobj(String newRobj)
Sets the return objects attribute of the LDAPSampler object

Parameters:
  `newRobj` - whether the objects should be returned

### isDeref

public boolean isDeref()
Gets the deref attribute of the LDAPSampler object

Returns:
  if dereferencing is required

### setDeref

public void setDeref(String newDref)
Sets the deref attribute of the LDAPSampler object

Parameters:
  `newDref` - The new deref value

### setTest

public void setTest(String newTest)
Sets the Test attribute of the LdapConfig object

Parameters:
  `newTest` - The new test value(Add,Modify,Delete and search)

### getTest

public String getTest()
Gets the test attribute of the LDAPSampler object

Returns:
  The test value (Add,Modify,Delete and search)

### setAttrs

public void setAttrs(String newAttrs)
Sets the attributes of the LdapConfig object

Parameters:
  `newAttrs` - The new attributes value

### getAttrs

public String getAttrs()
Gets the attributes of the LDAPSampler object

Returns:
  The attributes

### setBaseEntryDN

public void setBaseEntryDN(String newbaseentry)
Sets the Base Entry DN attribute of the LDAPSampler object

Parameters:
  `newbaseentry` - The new Base entry DN value

### getBaseEntryDN

public String getBaseEntryDN()
Gets the BaseEntryDN attribute of the LDAPSampler object

Returns:
  The Base entry DN value

### setArguments

public void setArguments(Arguments value)
Sets the Arguments attribute of the LdapConfig object This will collect values from the table for user defined test case

Parameters:
  `value` - The arguments

### getArguments

public Arguments getArguments()
Gets the Arguments attribute of the LdapConfig object

Returns:
  The arguments user defined test case

### setLDAPArguments

public void setLDAPArguments(LDAPArguments value)
Sets the Arguments attribute of the LdapConfig object This will collect values from the table for user defined test case

Parameters:
  `value` - The arguments

### getLDAPArguments

public LDAPArguments getLDAPArguments()
Gets the LDAPArguments attribute of the LdapConfig object

Returns:
  The LDAParguments user defined modify test case

### getLabel

public String getLabel()
Returns a formatted string label describing this sampler Example output:

Returns:
  a formatted string label describing this sampler

### sample

public SampleResult sample(Entry e)
Description copied from interface: `Sampler`
Obtains statistics about the given Entry, and packages the information into a SampleResult.

Specified by:
  `sample` in interface `Sampler`
Parameters:
  `e` - the Entry (TODO seems to be unused)
Returns:
  information about the sample

### testStarted

public void testStarted()
Description copied from interface: `TestStateListener`

Called just before the start of the test from the main engine thread. This is before the test elements are cloned. Note that not all the test variables will have been set up at this point.

N.B. testStarted() and testEnded() are called from different threads.

Specified by:
  `testStarted` in interface `TestStateListener`
See Also:
  - `StandardJMeterEngine.run()`

### testEnded

public void testEnded()
Description copied from interface: `TestStateListener`

Called once for all threads after the end of a test. This will use the same element instances as at the start of the test.

N.B. testStarted() and testEnded() are called from different threads.

Specified by:
  `testEnded` in interface `TestStateListener`
See Also:
  - `StandardJMeterEngine.stopTest()`

### testStarted

public void testStarted(String host)
Description copied from interface: `TestStateListener`

Called just before the start of the test from the main engine thread. This is before the test elements are cloned. Note that not all the test variables will have been set up at this point.

N.B. testStarted() and testEnded() are called from different threads.

Specified by:
  `testStarted` in interface `TestStateListener`
Parameters:
  `host` - name of host
See Also:
  - `StandardJMeterEngine.run()`

### testEnded

public void testEnded(String host)
Description copied from interface: `TestStateListener`

Called once for all threads after the end of a test. This will use the same element instances as at the start of the test.

N.B. testStarted() and testEnded() are called from different threads.

Specified by:
  `testEnded` in interface `TestStateListener`
Parameters:
  `host` - name of host
See Also:
  - `StandardJMeterEngine.stopTest()`

### applies

public boolean applies(ConfigTestElement configElement)
Description copied from class: `AbstractSampler`
Does configElement apply to Sampler

Specified by:
  `applies` in interface `ConfigMergabilityIndicator`
Overrides:
  `applies` in class `AbstractSampler`
Parameters:
  `configElement` - `ConfigTestElement`
Returns:
  boolean
See Also:
  - `AbstractSampler.applies(org.apache.jmeter.config.ConfigTestElement)`