Package org.apache.jmeter.protocol.jms.sampler

# Class BaseJMSSampler

java.lang.Object
org.apache.jmeter.testelement.AbstractTestElement
org.apache.jmeter.samplers.AbstractSampler
org.apache.jmeter.protocol.jms.sampler.BaseJMSSampler

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

Direct Known Subclasses:
  `PublisherSampler`, `SubscriberSampler`

public abstract class BaseJMSSampler extends AbstractSampler
BaseJMSSampler is an abstract class which provides implementation for common properties. Rather than duplicate the code, it's contained in the base class.

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 inherited from interface org.apache.jmeter.testelement.TestElement

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

- ## Constructor Summary

  Constructors
  Modifier
  Constructor
  Description
  `protected`
  `BaseJMSSampler()`

- ## Method Summary

  Modifier and Type
  Method
  Description
  `protected void`
  `configureIsReconnectErrorCode()`
  `String`
  `getConnectionFactory()`
  return the connection factory parameter used to lookup the connection factory from the JMS server
  `String`
  `getDestination()`
  return the destination (topic or queue name)
  `Predicate<String>`
  `getIsReconnectErrorCode()`
  `int`
  `getIterationCount()`
  get the number of samples to aggregate
  `String`
  `getIterations()`
  get the number of samples to aggregate
  `String`
  `getJNDIInitialContextFactory()`
  method returns the initial context factory for jndi initial context lookup.
  `static String`
  `getMessageHeaders(javax.jms.Message message)`
  Returns a String with the JMS Message Header values.
  `String`
  `getPassword()`
  return the password used to login to the jms server
  `String`
  `getProviderUrl()`
  method returns the provider url for jndi to connect to
  `String`
  `getReadResponse()`
  return whether the sampler should store the response
  `boolean`
  `getReadResponseAsBoolean()`
  return whether the sampler should store the response
  `String`
  `getReconnectionErrorCodes()`
  `String`
  `getUseJNDIProperties()`
  return whether the sampler should use properties file instead of UI parameters.
  `boolean`
  `getUseJNDIPropertiesAsBoolean()`
  return the properties as boolean true/false.
  `String`
  `getUsername()`
  return the username used to login to the jms server
  `boolean`
  `isDestinationStatic()`
  return whether the sampler should use a static destination.
  `boolean`
  `isUseAuth()`
  return whether jndi requires authentication
  `abstract SampleResult`
  `sample()`
  `SampleResult`
  `sample(Entry e)`
  Obtains statistics about the given Entry, and packages the information into a SampleResult.
  `void`
  `setConnectionFactory(String factory)`
  set the connection factory for
  `void`
  `setDestination(String dest)`
  set the destination (topic or queue name)
  `void`
  `setDestinationStatic(boolean isStatic)`
  if the sampler should use a static destination, call the method with true
  `void`
  `setIterations(String count)`
  set the number of iterations the sampler should aggregate
  `void`
  `setJNDIIntialContextFactory(String icf)`
  set the initial context factory
  `void`
  `setPassword(String pwd)`
  Set the password to login to the jms server
  `void`
  `setProviderUrl(String url)`
  set the provider user for jndi
  `void`
  `setReadResponse(String read)`
  set whether the sampler should store the response or not
  `void`
  `setReconnectionErrorCodes(String reconnectionErrorCodes)`
  `void`
  `setUseAuth(boolean useAuth)`
  Set whether authentication is required for JNDI
  `void`
  `setUseJNDIProperties(String properties)`
  if the sampler should use jndi.properties file, call the method with the string "true"
  `void`
  `setUsername(String user)`
  set the username to login into the jms server if needed

  ### Methods inherited from class org.apache.jmeter.samplers.AbstractSampler

  `applies`

  ### 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`

- ## Constructor Details

  - ### BaseJMSSampler

    protected BaseJMSSampler()

- ## Method Details

  - ### sample

    public SampleResult sample(Entry e)
    Obtains statistics about the given Entry, and packages the information into a SampleResult.
    Parameters:
      `e` - the Entry (TODO seems to be unused)
    Returns:
      information about the sample

  - ### sample

    public abstract SampleResult sample()

  - ### setJNDIIntialContextFactory

    public void setJNDIIntialContextFactory(String icf)
    set the initial context factory
    Parameters:
      `icf` - the initial context factory

  - ### getJNDIInitialContextFactory

    public String getJNDIInitialContextFactory()
    method returns the initial context factory for jndi initial context lookup.
    Returns:
      the initial context factory

  - ### setProviderUrl

    public void setProviderUrl(String url)
    set the provider user for jndi
    Parameters:
      `url` - the provider URL

  - ### getProviderUrl

    public String getProviderUrl()
    method returns the provider url for jndi to connect to
    Returns:
      the provider URL

  - ### setConnectionFactory

    public void setConnectionFactory(String factory)
    set the connection factory for
    Parameters:
      `factory` - the connection factory

  - ### getConnectionFactory

    public String getConnectionFactory()
    return the connection factory parameter used to lookup the connection factory from the JMS server
    Returns:
      the connection factory

  - ### setDestination

    public void setDestination(String dest)
    set the destination (topic or queue name)
    Parameters:
      `dest` - the destination

  - ### getDestination

    public String getDestination()
    return the destination (topic or queue name)
    Returns:
      the destination

  - ### setUsername

    public void setUsername(String user)
    set the username to login into the jms server if needed
    Parameters:
      `user` - the name of the user

  - ### getUsername

    public String getUsername()
    return the username used to login to the jms server
    Returns:
      the username used to login to the jms server

  - ### setPassword

    public void setPassword(String pwd)
    Set the password to login to the jms server
    Parameters:
      `pwd` - the password to use for login on the jms server

  - ### getPassword

    public String getPassword()
    return the password used to login to the jms server
    Returns:
      the password used to login to the jms server

  - ### setIterations

    public void setIterations(String count)
    set the number of iterations the sampler should aggregate
    Parameters:
      `count` - the number of iterations

  - ### getIterations

    public String getIterations()
    get the number of samples to aggregate
    Returns:
      String containing the number of samples to aggregate

  - ### getIterationCount

    public int getIterationCount()
    get the number of samples to aggregate
    Returns:
      int containing the number of samples to aggregate

  - ### setUseAuth

    public void setUseAuth(boolean useAuth)
    Set whether authentication is required for JNDI
    Parameters:
      `useAuth` - flag whether to use authentication

  - ### isUseAuth

    public boolean isUseAuth()
    return whether jndi requires authentication
    Returns:
      whether jndi requires authentication

  - ### setReadResponse

    public void setReadResponse(String read)
    set whether the sampler should store the response or not
    Parameters:
      `read` - whether the sampler should store the response or not

  - ### getReadResponse

    public String getReadResponse()
    return whether the sampler should store the response
    Returns:
      whether the sampler should store the response

  - ### getReadResponseAsBoolean

    public boolean getReadResponseAsBoolean()
    return whether the sampler should store the response
    Returns:
      boolean: whether the sampler should read the response

  - ### setUseJNDIProperties

    public void setUseJNDIProperties(String properties)
    if the sampler should use jndi.properties file, call the method with the string "true"
    Parameters:
      `properties` - flag whether to use jndi.properties file

  - ### getUseJNDIProperties

    public String getUseJNDIProperties()
    return whether the sampler should use properties file instead of UI parameters.
    Returns:
      the string "true" when the sampler should use properties file instead of UI parameters, the string "false" otherwise.

  - ### getUseJNDIPropertiesAsBoolean

    public boolean getUseJNDIPropertiesAsBoolean()
    return the properties as boolean true/false.
    Returns:
      whether the sampler should use properties file instead of UI parameters.

  - ### setDestinationStatic

    public void setDestinationStatic(boolean isStatic)
    if the sampler should use a static destination, call the method with true
    Parameters:
      `isStatic` - flag whether the destination is a static destination

  - ### isDestinationStatic

    public boolean isDestinationStatic()
    return whether the sampler should use a static destination.
    Returns:
      whether the sampler should use a static destination.

  - ### getMessageHeaders

    public static String getMessageHeaders(javax.jms.Message message)
    Returns a String with the JMS Message Header values.
    Parameters:
      `message` - JMS Message
    Returns:
      String with message header values.

  - ### getReconnectionErrorCodes

    public String getReconnectionErrorCodes()

  - ### setReconnectionErrorCodes

    public void setReconnectionErrorCodes(String reconnectionErrorCodes)

  - ### getIsReconnectErrorCode

    public Predicate<String> getIsReconnectErrorCode()

  - ### configureIsReconnectErrorCode

    protected void configureIsReconnectErrorCode()