org.apache.jmeter.protocol.http.control

Class CacheManager

java.lang.Object

org.apache.jmeter.testelement.AbstractTestElement

org.apache.jmeter.config.ConfigTestElement

org.apache.jmeter.protocol.http.control.CacheManager

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, org.apache.jmeter.config.ConfigElement, org.apache.jmeter.gui.Searchable, org.apache.jmeter.testelement.TestElement, org.apache.jmeter.testelement.TestIterationListener, org.apache.jmeter.testelement.TestStateListener

public class CacheManager
extends org.apache.jmeter.config.ConfigTestElement
implements org.apache.jmeter.testelement.TestStateListener, org.apache.jmeter.testelement.TestIterationListener, java.io.Serializable

Handles HTTP Caching.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CLEAR
static java.lang.String	MAX_SIZE
static java.lang.String	USE_EXPIRES

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

Constructors

Constructor and Description
CacheManager()

Method Summary

Modifier and Type	Method and Description
void	clear()
CacheManager	createCacheManagerProxy() create a cache manager that share the underlying cache of the current one it allows to use the same cache in different threads which does not inherit from each other
boolean	getClearEachIteration()
int	getMaxSize()
boolean	getUseExpires()
boolean	inCache(java.net.URL url) Deprecated. use a version of inCache(URL, Header[]) or inCache(URL, org.apache.jmeter.protocol.http.control.Header[])
boolean	inCache(java.net.URL url, org.apache.http.Header[] allHeaders)
boolean	inCache(java.net.URL url, Header[] allHeaders)
void	saveDetails(org.apache.http.HttpResponse method, HTTPSampleResult res) Save the Last-Modified, Etag, and Expires headers if the result is cacheable.
void	saveDetails(java.net.URLConnection conn, HTTPSampleResult res) Save the Last-Modified, Etag, and Expires headers if the result is cacheable.
void	setClearEachIteration(boolean clear)
void	setHeaders(java.net.HttpURLConnection conn, Header[] headers, java.net.URL url) Check the cache, and if there is a match, set the headers: If-Modified-Since If-None-Match
void	setHeaders(java.net.URL url, org.apache.http.client.methods.HttpRequestBase request) Check the cache, and if there is a match, set the headers: If-Modified-Since If-None-Match Apache HttpClient version.
void	setMaxSize(int size)
void	setUseExpires(boolean expires)
void	testEnded()
void	testEnded(java.lang.String host)
void	testIterationStart(org.apache.jmeter.engine.event.LoopIterationEvent event)
void	testStarted()
void	testStarted(java.lang.String host)

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, 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.config.ConfigElement

clone

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

removed

Field Detail

CLEAR

public static final java.lang.String CLEAR

See Also:

Constant Field Values

USE_EXPIRES

public static final java.lang.String USE_EXPIRES

See Also:

Constant Field Values

MAX_SIZE

public static final java.lang.String MAX_SIZE

See Also:

Constant Field Values

Constructor Detail

CacheManager

public CacheManager()

Method Detail

saveDetails

public void saveDetails(java.net.URLConnection conn,
                        HTTPSampleResult res)

Save the Last-Modified, Etag, and Expires headers if the result is cacheable. Version for Java implementation.

Parameters:

conn - connection

res - result

saveDetails

public void saveDetails(org.apache.http.HttpResponse method,
                        HTTPSampleResult res)

Save the Last-Modified, Etag, and Expires headers if the result is cacheable. Version for Apache HttpClient implementation.

Parameters:

method - HttpResponse to extract header information from

res - result to decide if result is cacheable

setHeaders

public void setHeaders(java.net.URL url,
                       org.apache.http.client.methods.HttpRequestBase request)

Check the cache, and if there is a match, set the headers:

• If-Modified-Since
• If-None-Match

Apache HttpClient version.

Parameters:

url - URL to look up in cache

request - where to set the headers

setHeaders

public void setHeaders(java.net.HttpURLConnection conn,
                       Header[] headers,
                       java.net.URL url)

Check the cache, and if there is a match, set the headers:

• If-Modified-Since
• If-None-Match

Parameters:

url - URL to look up in cache

headers - Array of Header

conn - where to set the headers

inCache

@Deprecated
public boolean inCache(java.net.URL url)

Deprecated. use a version of inCache(URL, Header[]) or inCache(URL, org.apache.jmeter.protocol.http.control.Header[])

Check the cache, if the entry has an expires header and the entry has not expired, return true

Parameters:

url - URL to look up in cache

Returns:

true if entry has an expires header and the entry has not expired, else false

inCache

public boolean inCache(java.net.URL url,
                       org.apache.http.Header[] allHeaders)

inCache

public boolean inCache(java.net.URL url,
                       Header[] allHeaders)

getClearEachIteration

public boolean getClearEachIteration()

setClearEachIteration

public void setClearEachIteration(boolean clear)

getUseExpires

public boolean getUseExpires()

setUseExpires

public void setUseExpires(boolean expires)

getMaxSize

public int getMaxSize()

Returns:

int cache max size

setMaxSize

public void setMaxSize(int size)

Parameters:

size - int cache max size

clear

public void clear()

Specified by:

clear in interface org.apache.jmeter.testelement.TestElement

Overrides:

clear in class org.apache.jmeter.testelement.AbstractTestElement

createCacheManagerProxy

public CacheManager createCacheManagerProxy()

create a cache manager that share the underlying cache of the current one it allows to use the same cache in different threads which does not inherit from each other

Returns:

a cache manager that share the underlying cache of the current one

Since:

3.0

testStarted

public void testStarted()

Specified by:

testStarted in interface org.apache.jmeter.testelement.TestStateListener

testEnded

public void testEnded()

Specified by:

testEnded in interface org.apache.jmeter.testelement.TestStateListener

testStarted

public void testStarted(java.lang.String host)

Specified by:

testStarted in interface org.apache.jmeter.testelement.TestStateListener

testEnded

public void testEnded(java.lang.String host)

Specified by:

testEnded in interface org.apache.jmeter.testelement.TestStateListener

testIterationStart

public void testIterationStart(org.apache.jmeter.engine.event.LoopIterationEvent event)

Specified by:

testIterationStart in interface org.apache.jmeter.testelement.TestIterationListener