public class Assert extends PropertyCall
<assert method="[!]assertXXX" args="..." [class="..."]>
<assert method="[!](get|is|has)XXX" component="component_id" value="...">
<assert method="[!]XXX" args="..." class="...">
<wait ... [timeout="..."] [pollInterval="..."]>
The first example above invokes a core assertion provided by the
ComponentTester
class; the class tag is required for
assertions based on a class derived from
ComponentTester
; the class tag indicates the
Component
class, not the Tester class (the appropriate
tester class will be derived automatically).The second format indicates a property check on the given component, and an expected value must be provided; the method name must start with "is", "get", or "has". Finally, any arbitrary static boolean method may be used in the assertion; you must specify the class and arguments.
You can invert the sense of either form of assertion by inserting a '!'
character before the method name, or adding an invert="true"
attribute.
The default timeout for a wait is ten seconds; the default poll interval
(sleep time between checking the assertion) is 1/10 second. Both may be
set as XML attributes (pollInterval
and timeout
).
Modifier and Type | Field and Description |
---|---|
static int |
DEFAULT_INTERVAL
Default interval between checking the assertion in a wait.
|
static int |
DEFAULT_TIMEOUT
Default timeout before a wait will indicate failure.
|
TAG_ACTION, TAG_APPLETVIEWER, TAG_ARCHIVE, TAG_ARGS, TAG_ASSERT, TAG_AWT, TAG_AWTTESTSCRIPT, TAG_BORDER_TITLE, TAG_CALL, TAG_CLASS, TAG_CLASSPATH, TAG_CODE, TAG_CODEBASE, TAG_COMMENT, TAG_COMPONENT, TAG_COUNT, TAG_DELEGATE, TAG_DESC, TAG_DOCBASE, TAG_EVENT, TAG_EXPR, TAG_FILENAME, TAG_FIXTURE, TAG_FORKED, TAG_HEIGHT, TAG_HORDER, TAG_ICON, TAG_ID, TAG_INDEX, TAG_INVERT, TAG_INVOKER, TAG_KEYCHAR, TAG_KEYCODE, TAG_KIND, TAG_LABEL, TAG_LAUNCH, TAG_METHOD, TAG_MODIFIERS, TAG_NAME, TAG_PARAMS, TAG_PARENT, TAG_POLL_INTERVAL, TAG_PROPERTY, TAG_ROOT, TAG_SAMPLE, TAG_SCRIPT, TAG_SEQUENCE, TAG_SLOW, TAG_STOP_ON_ERROR, TAG_STOP_ON_FAILURE, TAG_TAG, TAG_TERMINATE, TAG_TEXT, TAG_THREADED, TAG_TIMEOUT, TAG_TITLE, TAG_TRIGGER, TAG_TYPE, TAG_VALUE, TAG_VMARGS, TAG_VORDER, TAG_WAIT, TAG_WEIGHTED, TAG_WIDTH, TAG_WINDOW, TAG_X, TAG_Y
Constructor and Description |
---|
Assert(Resolver resolver,
Map attributes)
Construct an assert step from XML.
|
Assert(Resolver resolver,
String desc,
String methodName,
String[] args,
Class testedClass,
String expectedResult,
boolean invert)
Assertion provided by a ComponentTester subclass which operates on a
Component subclass.
|
Assert(Resolver resolver,
String desc,
String targetClassName,
String methodName,
String[] args,
String expectedResult,
boolean invert)
Assertion provided by the ComponentTester class, or an arbitrary
static call.
|
Assert(Resolver resolver,
String desc,
String methodName,
String componentID,
String expectedResult,
boolean invert)
Property assertion on Component subclass.
|
Modifier and Type | Method and Description |
---|---|
protected void |
evaluateAssertion()
Check the assertion.
|
Map |
getAttributes()
Save attributes specific to this Step class.
|
String |
getDefaultDescription()
Return a reasonable default description for this script step.
|
String |
getExpectedResult() |
long |
getPollInterval() |
long |
getTimeout() |
String |
getUsage()
Provide a usage String for this step.
|
String |
getXMLTag()
Define the XML tag to use for this script step.
|
boolean |
isInverted() |
boolean |
isWait() |
protected void |
runStep()
Run this step.
|
void |
setExpectedResult(String result) |
void |
setInverted(boolean invert) |
void |
setPollInterval(long interval) |
void |
setTimeout(long timeout) |
void |
setWait(boolean wait)
Changes the behavior of this step between failing if the condition is
not met and waiting for the condition to be met.
|
getComponentID, getTarget, isPropertyMethod, setComponentID
disambiguateMethod, evaluateParameter, evaluateParameters, getArgs, getArguments, getArgumentsDescription, getEncodedArguments, getMethod, getMethodName, getMethods, getTargetClass, getTargetClassName, invoke, resolveMethod, resolveMethods, setArguments, setArguments, setMethodName, setTargetClassName
addAttributes, addContent, createAttributeMap, createStep, createStep, getDescription, getResolver, parseAttributes, resolveClass, resolveTester, run, setDescription, setScriptError, simpleClassName, toEditableString, toString, toXML, toXMLString, usage, usage
public static final int DEFAULT_INTERVAL
public static final int DEFAULT_TIMEOUT
public Assert(Resolver resolver, String desc, String targetClassName, String methodName, String[] args, String expectedResult, boolean invert)
public Assert(Resolver resolver, String desc, String methodName, String[] args, Class testedClass, String expectedResult, boolean invert)
public void setWait(boolean wait)
wait
- If true, this step returns from its runStep()
method only when its condition is met, throwing a
WaitTimedOutError
if the condition is not met within the
timeout interval.setPollInterval(long)
,
getPollInterval()
,
setTimeout(long)
,
getTimeout()
public boolean isWait()
public void setPollInterval(long interval)
public long getPollInterval()
public void setTimeout(long timeout)
public long getTimeout()
public String getExpectedResult()
public void setExpectedResult(String result)
public boolean isInverted()
public void setInverted(boolean invert)
public String getXMLTag()
Step
public String getUsage()
Step
public String getDefaultDescription()
Step
getDefaultDescription
in class PropertyCall
public Map getAttributes()
PropertyCall
getAttributes
in class PropertyCall
protected void evaluateAssertion() throws Throwable
Throwable
Abbot is hosted on