net.sf.jameleon.plugin.watij.tags
Class WatijImageTag

java.lang.Object
  org.apache.commons.jelly.TagSupport
      net.sf.jameleon.LocationAwareTagSupport
          net.sf.jameleon.JameleonTagSupport
              net.sf.jameleon.function.FunctionTag
                  net.sf.jameleon.plugin.watij.WatijFunctionTag
                      net.sf.jameleon.plugin.watij.tags.AbstractWatijGetTag
                          net.sf.jameleon.plugin.watij.tags.WatijImageTag

All Implemented Interfaces:

BreakPoint, Attributable, Storable, DynaTag, LocationAware, Tag

public class WatijImageTag
extends AbstractWatijGetTag

Gets an image on the page and stores in the context. An example of its use might be to click on an image found via its alt text of 'Find Pets':

 <testcase xmlns="jelly:jameleon" xmlns:j="jelly:core">
     <watij-session baseUrl="http://jameleon.sourceforge.net" beginSession="true">
         <watij-image
             functionId="Get the 'Find Pets' image"
             how="alt"
             what="Find Pets"
             contextVar="watijImage"/>
         <watij-click
             functionId="Click on the image"
             element="${watijImage}"/>
     </watij-session>
 </testcase>
 

Or maybe there is no alt text so something like XPath is more appropriate and you want a more specific context variable:

 <testcase xmlns="jelly:jameleon" xmlns:j="jelly:core">
     <watij-session baseUrl="http://jameleon.sourceforge.net" beginSession="true">
         <watij-image
             functionId="Get the 'Find Pets' image"
             how="xpath"
             what="//TABLE[@id='nav_table']//'IMG[2]"
             contextVar="img_2"/>
         <watij-click
             functionId="Click on the image"
             element="${img_2}"/>
     </watij-session>
 </testcase>
 

See the javadocs on watij's SymbolFactory for a complete list of supported symbols.

Tag Name: <watij-image> Type: action

Field Summary

Fields inherited from class net.sf.jameleon.plugin.watij.tags.AbstractWatijGetTag

contextVar, failOnNotExists, how, what

Fields inherited from class net.sf.jameleon.plugin.watij.WatijFunctionTag

sessionTag, STORE_SOURCE_CONFIG_NAME, storeSourceOnStateChange

Fields inherited from class net.sf.jameleon.function.FunctionTag

addt, breakPoint, expectException, expectFailure, fResults, functionDelay, functionId, lastFileWritten, log, NO_DELAY, params, postcondition, precondition, st, state, tct, vpt

Fields inherited from class net.sf.jameleon.JameleonTagSupport

attributes, broker, contextVars, fp, unsupportedAttributes

Fields inherited from class net.sf.jameleon.LocationAwareTagSupport

columnNumber, elementTagName, lineNumber, scriptFileName

Fields inherited from class org.apache.commons.jelly.TagSupport

body, context, hasTrimmed, parent, shouldTrim

Constructor Summary

WatijImageTag()

Method Summary

HtmlElement	getHtmlElement(Symbol how, String what) Gets the HtmlElement of interest.
String	getTagName() The HTML Element name this tag is used to get.

Methods inherited from class net.sf.jameleon.plugin.watij.tags.AbstractWatijGetTag

getHtmlElement, getPrefixMsg, testBlock

Methods inherited from class net.sf.jameleon.plugin.watij.WatijFunctionTag

getParentBrowser, getSymbolFromString, ie, setCurrentIE, setupEnvironment, store

Methods inherited from class net.sf.jameleon.function.FunctionTag

addParam, addRequiredAttribute, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertFalse, assertFalse, assertMethod, assertMethodWithLevel, assertNotNull, assertNotNull, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNotSame, assertNotSame, assertNull, assertNull, assertNull, assertNull, assertRegexMatches, assertRegexMatches, assertRegexMatches, assertRegexMatches, assertSame, assertSame, assertSame, assertSame, assertTextContains, assertTextContains, assertTextContains, assertTextContains, assertTextEndsWith, assertTextEndsWith, assertTextEndsWith, assertTextEndsWith, assertTextStartsWith, assertTextStartsWith, assertTextStartsWith, assertTextStartsWith, assertTrue, assertTrue, assertTrue, assertTrue, checkParamTypes, cleanUp, cleanUpEnvironment, delay, delay, doTag, fail, fail, fail, fail, getFunctionId, getFunctionResults, getMatchingRegexText, getParam, getParamLength, getParams, getParentTags, getSessionTag, getStoreToFileName, getStringOrDefault, getTestCaseTag, getVariable, getVariableAsBoolean, getVariableAsList, getVariableAsString, isBreakPoint, isContextVariableNull, pluginTearDown, recordFunctionResult, regexMatches, removeFunctionResult, removeVariable, setDefaultVariableValue, setDefaultVariableValue, setExpectException, setExpectFailure, setFunctionDelay, setFunctionId, setup, setUpFunctionResults, setVariable, tearDown, traceMsg, validate

Methods inherited from class net.sf.jameleon.JameleonTagSupport

cleanVariablesInContext, createAttributes, describeAttributes, getAttributeBroker, getAttributes, getAttributeType, getClassAttributes, getFunctionalPoint, getUnsupportedAttributes, loadFunctionalPoint, resetFunctionalPoint, setAttribute, setVariableInContext, testForUnsupportedAttributesCaught

Methods inherited from class net.sf.jameleon.LocationAwareTagSupport

getColumnNumber, getElementName, getFileName, getLineNumber, setColumnNumber, setElementName, setFileName, setLineNumber

Methods inherited from class org.apache.commons.jelly.TagSupport

findAncestorWithClass, findAncestorWithClass, findAncestorWithClass, findAncestorWithClass, findAncestorWithClass, findAncestorWithClass, getBody, getBodyText, getBodyText, getContext, getParent, invokeBody, isEscapeText, isTrim, setBody, setContext, setEscapeText, setParent, setTrim, trimBody

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.commons.jelly.Tag

getBody, getContext, getParent, invokeBody, setBody, setContext, setParent

Constructor Detail

WatijImageTag

public WatijImageTag()

Method Detail

getHtmlElement

public HtmlElement getHtmlElement(Symbol how,
                                  String what)
                           throws Exception

Description copied from class: AbstractWatijGetTag

Gets the HtmlElement of interest. Each subclass will implement the code required to get the specific element of interest.

Specified by:

getHtmlElement in class AbstractWatijGetTag

Parameters:

how - - How to search for the element

what - - What to search for.

Returns:

HtmlElement

Throws:

Exception

getTagName

public String getTagName()

Description copied from class: AbstractWatijGetTag

The HTML Element name this tag is used to get. For example, if the tag is used to get an image, then this method might return something like img tag

Specified by:

getTagName in class AbstractWatijGetTag

Returns:

String