com.meterware.httpunit
Class WebLink

java.lang.Object
  com.meterware.httpunit.ParameterHolder
      com.meterware.httpunit.WebRequestSource
          com.meterware.httpunit.FixedURLWebRequestSource
              com.meterware.httpunit.WebLink

All Implemented Interfaces:

HTMLElement

public class WebLink

extends com.meterware.httpunit.FixedURLWebRequestSource

This class represents a link in an HTML page. Users of this class may examine the structure of the link (as a DOM), or create a WebRequest to simulate clicking on the link.

Author:

Russell Gold,

Nested Class Summary

class

WebLink.Scriptable

Field Summary

static HTMLElementPredicate	MATCH_CONTAINED_TEXT Predicate to match part or all of a link's contained text.
static HTMLElementPredicate	MATCH_ID Predicate to match a link's ID.
static HTMLElementPredicate	MATCH_NAME Predicate to match a link's name.
static HTMLElementPredicate	MATCH_TEXT Predicate to match a link's text exactly.
static HTMLElementPredicate	MATCH_URL_STRING Predicate to match part or all of a link's URL string.

Method Summary

protected void	addPresetParameter(java.lang.String name, java.lang.String value) Records a parameter defined by including it in the destination URL.
java.lang.String	asText() Returns the text value of this link.
WebResponse	click() Submits a request as though the user had clicked on this link.
protected java.lang.String	getEmptyParameterValue()
java.lang.String[]	getParameterNames() Returns an array containing the names of any parameters defined as part of this link's URL.
java.lang.String[]	getParameterValues(java.lang.String name) Returns the multiple default values of the named parameter.
WebRequest	getRequest() Creates and returns a web request which will simulate clicking on this link.
com.meterware.httpunit.scripting.ScriptableDelegate	getScriptableDelegate() Returns the scriptable delegate.
java.lang.String	getURLString() Returns the URL referenced by this link.
void	mouseOver() Simulates moving the mouse over the link.
protected void	setDestination(java.lang.String destination)

Methods inherited from class com.meterware.httpunit.WebRequestSource

getBaseResponse, getBaseURL, getClassName, getCurrentFrameContents, getDestination, getDOMSubtree, getFragmentIdentifier, getHTMLPage, getID, getName, getNode, getPageFrame, getRelativeURL, getTarget, getTitle, loadDestinationParameters, setTargetAttribute, submitRequest, submitRequest

Methods inherited from class java.lang.Object

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

Field Detail

MATCH_URL_STRING

public static final HTMLElementPredicate MATCH_URL_STRING

Predicate to match part or all of a link's URL string.

MATCH_TEXT

public static final HTMLElementPredicate MATCH_TEXT

Predicate to match a link's text exactly.

MATCH_CONTAINED_TEXT

public static final HTMLElementPredicate MATCH_CONTAINED_TEXT

Predicate to match part or all of a link's contained text.

MATCH_ID

public static final HTMLElementPredicate MATCH_ID

Predicate to match a link's ID.

MATCH_NAME

public static final HTMLElementPredicate MATCH_NAME

Predicate to match a link's name.

Method Detail

getURLString

public java.lang.String getURLString()

Returns the URL referenced by this link. This may be a relative URL. It will not include any fragment identifier.

asText

public java.lang.String asText()

Returns the text value of this link.

click

public WebResponse click()
                  throws java.io.IOException,
                         org.xml.sax.SAXException

Submits a request as though the user had clicked on this link. Will also fire the 'onClick' event if defined. If clicking results in submitting a request (that is, there is no 'onClick' event or it returns true, this method will return the result of that submission; otherwise, it will return the updated contents of the frame containing this link. Note that if an event updates a different frame that frame will not be returned by this method.

Throws:

java.io.IOException

org.xml.sax.SAXException

mouseOver

public void mouseOver()

Simulates moving the mouse over the link. Will fire the 'onMouseOver' event if defined.

getScriptableDelegate

public com.meterware.httpunit.scripting.ScriptableDelegate getScriptableDelegate()

Returns the scriptable delegate.

getRequest

public WebRequest getRequest()

Creates and returns a web request which will simulate clicking on this link.

Specified by:

getRequest in class WebRequestSource

getParameterNames

public java.lang.String[] getParameterNames()

Returns an array containing the names of any parameters defined as part of this link's URL.

Specified by:

getParameterNames in class WebRequestSource

getParameterValues

public java.lang.String[] getParameterValues(java.lang.String name)

Returns the multiple default values of the named parameter.

Specified by:

getParameterValues in class WebRequestSource

addPresetParameter

protected void addPresetParameter(java.lang.String name,
                                  java.lang.String value)

Description copied from class: WebRequestSource

Records a parameter defined by including it in the destination URL. The value can be null, if the parameter name was not specified with an equals sign.

Specified by:

addPresetParameter in class WebRequestSource

getEmptyParameterValue

protected java.lang.String getEmptyParameterValue()

Specified by:

getEmptyParameterValue in class WebRequestSource

setDestination

protected void setDestination(java.lang.String destination)

Overrides:

setDestination in class WebRequestSource