org.apache.jmeter.protocol.http.control
Class AuthManager

java.lang.Object
  org.apache.jmeter.testelement.AbstractTestElement
      org.apache.jmeter.config.ConfigTestElement
          org.apache.jmeter.protocol.http.control.AuthManager

All Implemented Interfaces:

Serializable, Cloneable, ConfigElement, Searchable, TestElement

public class AuthManager
extends ConfigTestElement
implements Serializable

This class provides a way to provide Authorization in jmeter requests. The format of the authorization file is: URL user pass where URL is an HTTP URL, user a username to use and pass the appropriate password.

See Also:

Serialized Form

Field Summary

static int	COL_DOMAIN
static int	COL_PASSWORD
static int	COL_REALM
static int	COL_URL
static int	COL_USERNAME

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

AuthManager()
Default Constructor.

Method Summary

void	addAuth()
void	addAuth(Authorization auth)
void	addConfigElement(ConfigElement config) Add a configuration element to this one. This allows config elements to combine and give a "layered" effect. For example, HTTPConfigElements have properties for domain, path, method, and parameters. If element A has everything filled in, but null for domain, and element B is added, which has only domain filled in, then after adding B to A, A will have the domain from B. If A already had a domain, then the correct behavior is for A to ignore the addition of element B.
void	addFile(String authFile) Add authentication data from a file.
void	clear() Clear the TestElement of all data.
boolean	expectsModification() If your config element expects to be modified in the process of a test run, and you want those modifications to carry over from sample to sample (as in a cookie manager - you want to save all cookies that get set throughout the test), then return true for this method. Your config element will not be cloned for each sample. If your config elements are more static in nature, return false. If in doubt, return false.
Authorization	get(int i) Return the record at index i
int	getAuthCount() Return the number of records.
Authorization	getAuthForURL(URL url)
String	getAuthHeaderForURL(URL url)
Authorization	getAuthObjectAt(int row)
CollectionProperty	getAuthObjects()
Class<?>	getColumnClass(int column)
int	getColumnCount()
String	getColumnName(int column)
boolean	isEditable()
void	remove(int index) Remove an authentication record.
void	save(String authFile) Save the authentication data to a file.
void	set(int index, String url, String user, String pass, String domain, String realm) Update an authentication record.

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

addTestElement

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, toString, wait, wait, wait

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

clone

Field Detail

COL_URL

public static final int COL_URL

See Also:

Constant Field Values

COL_USERNAME

public static final int COL_USERNAME

See Also:

Constant Field Values

COL_PASSWORD

public static final int COL_PASSWORD

See Also:

Constant Field Values

COL_DOMAIN

public static final int COL_DOMAIN

See Also:

Constant Field Values

COL_REALM

public static final int COL_REALM

See Also:

Constant Field Values

Constructor Detail

AuthManager

public AuthManager()

Default Constructor.

Method Detail

clear

public void clear()

Clear the TestElement of all data.

Specified by:

clear in interface TestElement

Overrides:

clear in class AbstractTestElement

set

public void set(int index,
                String url,
                String user,
                String pass,
                String domain,
                String realm)

Update an authentication record.

getAuthObjects

public CollectionProperty getAuthObjects()

getColumnCount

public int getColumnCount()

getColumnName

public String getColumnName(int column)

getColumnClass

public Class<?> getColumnClass(int column)

getAuthObjectAt

public Authorization getAuthObjectAt(int row)

isEditable

public boolean isEditable()

get

public Authorization get(int i)

Return the record at index i

getAuthHeaderForURL

public String getAuthHeaderForURL(URL url)

getAuthForURL

public Authorization getAuthForURL(URL url)

addConfigElement

public void addConfigElement(ConfigElement config)

Add a configuration element to this one. This allows config elements to combine and give a "layered" effect. For example, HTTPConfigElements have properties for domain, path, method, and parameters. If element A has everything filled in, but null for domain, and element B is added, which has only domain filled in, then after adding B to A, A will have the domain from B. If A already had a domain, then the correct behavior is for A to ignore the addition of element B.

Specified by:

addConfigElement in interface ConfigElement

Overrides:

addConfigElement in class ConfigTestElement

Parameters:

config - the element to be added to this ConfigElement

addAuth

public void addAuth(Authorization auth)

addAuth

public void addAuth()

expectsModification

public boolean expectsModification()

If your config element expects to be modified in the process of a test run, and you want those modifications to carry over from sample to sample (as in a cookie manager - you want to save all cookies that get set throughout the test), then return true for this method. Your config element will not be cloned for each sample. If your config elements are more static in nature, return false. If in doubt, return false.

Specified by:

expectsModification in interface ConfigElement

Overrides:

expectsModification in class ConfigTestElement

Returns:

true if the element expects to be modified over the course of a test run

save

public void save(String authFile)
          throws IOException

Save the authentication data to a file.

Throws:

IOException

addFile

public void addFile(String authFile)
             throws IOException

Add authentication data from a file.

Throws:

IOException

remove

public void remove(int index)

Remove an authentication record.

getAuthCount

public int getAuthCount()

Return the number of records.