com.meterware.httpunit
Class ClientProperties

java.lang.Object
  com.meterware.httpunit.ClientProperties

public class ClientProperties

extends java.lang.Object

A class which represents the properties of a web client.

Author:

Russell Gold

Method Summary

java.lang.String	getApplicationCodeName()
java.lang.String	getApplicationName()
java.lang.String	getApplicationVersion()
int	getAvailableScreenWidth()
int	getAvailHeight()
static ClientProperties	getDefaultProperties() Returns the current defaults for newly created web clients.
java.lang.String	getOverrideContextType() Returns the context type (if any) to use instead of the one specified by the server.
java.lang.String	getPlatform()
java.lang.String	getUserAgent() Returns the user agent identification.
boolean	isAcceptCookies() Returns true if the client should accept and transmit cookies.
boolean	isAcceptGzip() Returns true if the client will accept GZIP encoding of responses.
boolean	isAutoRedirect() Returns true if the client should automatically follow page redirect requests (status 3xx).
boolean	isAutoRefresh() Returns true if the client should automatically follow page refresh requests.
boolean	isIframeSupported()
boolean	isSendReferer()
void	setAcceptCookies(boolean acceptCookies) Specifies whether the client should accept and send cookies.
void	setAcceptGzip(boolean acceptGzip) Specifies whether the client will accept GZIP encoded responses.
void	setApplicationCodeName(java.lang.String applicationCodeName)
void	setApplicationID(java.lang.String applicationName, java.lang.String applicationCodeName, java.lang.String applicationVersion) Specifies the ID information for a client.
void	setApplicationName(java.lang.String applicationName)
void	setApplicationVersion(java.lang.String applicationVersion)
void	setAutoRedirect(boolean autoRedirect) Determines whether the client should automatically follow page redirect requests (status 3xx).
void	setAutoRefresh(boolean autoRefresh) Specifies whether the client should automatically follow page refresh requests.
void	setAvailableScreenSize(int width, int height) A shortcut for setting both availableScreenWidth and availableScreenHeight at one time.
void	setAvailableScreenWidth(int availWidth)
void	setAvailHeight(int availHeight)
void	setDnsListener(DNSListener dnsListener) Specifies a listener for DNS requests from the client.
void	setIframeSupported(boolean iframeSupported)
void	setOverrideContextType(java.lang.String overrideContextType) All responses to this client will use the specified content type rather than the one specified by the server.
void	setPlatform(java.lang.String platform)
void	setSendReferer(boolean referer) set whether Referer information should be stripped
void	setUserAgent(java.lang.String userAgent)

Methods inherited from class java.lang.Object

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

Method Detail

getDefaultProperties

public static ClientProperties getDefaultProperties()

Returns the current defaults for newly created web clients.

setApplicationID

public void setApplicationID(java.lang.String applicationName,
                             java.lang.String applicationCodeName,
                             java.lang.String applicationVersion)

Specifies the ID information for a client.

getApplicationCodeName

public java.lang.String getApplicationCodeName()

setApplicationCodeName

public void setApplicationCodeName(java.lang.String applicationCodeName)

getApplicationName

public java.lang.String getApplicationName()

setApplicationName

public void setApplicationName(java.lang.String applicationName)

getApplicationVersion

public java.lang.String getApplicationVersion()

setApplicationVersion

public void setApplicationVersion(java.lang.String applicationVersion)

getUserAgent

public java.lang.String getUserAgent()

Returns the user agent identification. Unless this has been set explicitly, it will default to the application code name followed by a slash and the application version.

setUserAgent

public void setUserAgent(java.lang.String userAgent)

getPlatform

public java.lang.String getPlatform()

setPlatform

public void setPlatform(java.lang.String platform)

setAvailableScreenSize

public void setAvailableScreenSize(int width,
                                   int height)

A shortcut for setting both availableScreenWidth and availableScreenHeight at one time.

getAvailableScreenWidth

public int getAvailableScreenWidth()

setAvailableScreenWidth

public void setAvailableScreenWidth(int availWidth)

getAvailHeight

public int getAvailHeight()

setAvailHeight

public void setAvailHeight(int availHeight)

isAcceptCookies

public boolean isAcceptCookies()

Returns true if the client should accept and transmit cookies. The default is to accept them.

setAcceptCookies

public void setAcceptCookies(boolean acceptCookies)

Specifies whether the client should accept and send cookies.

isAcceptGzip

public boolean isAcceptGzip()

Returns true if the client will accept GZIP encoding of responses. The default is to accept GZIP encoding.

setAcceptGzip

public void setAcceptGzip(boolean acceptGzip)

Specifies whether the client will accept GZIP encoded responses. The default is true.

isAutoRedirect

public boolean isAutoRedirect()

Returns true if the client should automatically follow page redirect requests (status 3xx). By default, this is true.

setAutoRedirect

public void setAutoRedirect(boolean autoRedirect)

Determines whether the client should automatically follow page redirect requests (status 3xx). By default, this is true in order to simulate normal browser operation.

isAutoRefresh

public boolean isAutoRefresh()

Returns true if the client should automatically follow page refresh requests. By default, this is false, so that programs can verify the redirect page presented to users before the browser switches to the new page.

setAutoRefresh

public void setAutoRefresh(boolean autoRefresh)

Specifies whether the client should automatically follow page refresh requests. By default, this is false, so that programs can verify the redirect page presented to users before the browser switches to the new page. Setting this to true can cause an infinite loop on pages that refresh themselves.

isIframeSupported

public boolean isIframeSupported()

setIframeSupported

public void setIframeSupported(boolean iframeSupported)

getOverrideContextType

public java.lang.String getOverrideContextType()

Returns the context type (if any) to use instead of the one specified by the server. Defaults to null.

Returns:

the overriding context type, or null if none is specified.

setOverrideContextType

public void setOverrideContextType(java.lang.String overrideContextType)

All responses to this client will use the specified content type rather than the one specified by the server. Setting this to "text/html" will force all reponses to be interpreted as HTML.

Parameters:

overrideContextType - the new override to apply to context types.

setDnsListener

public void setDnsListener(DNSListener dnsListener)

Specifies a listener for DNS requests from the client.

Parameters:

dnsListener - the new listener.

isSendReferer

public boolean isSendReferer()

Returns:

the whether Referer information should be stripped from the header

setSendReferer

public void setSendReferer(boolean referer)

set whether Referer information should be stripped

Parameters:

referer - the _sendReferer to set