You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by di...@apache.org on 2002/01/27 05:45:41 UTC
cvs commit: jakarta-commons/latka/webpages xml-reference.html users-guide.html status.html proposal.html index.html RELEASE_NOTES.txt
dion 02/01/26 20:45:41
Added: latka/webpages xml-reference.html users-guide.html
status.html proposal.html index.html
RELEASE_NOTES.txt
Log:
Initial build
Revision Changes Path
1.1 jakarta-commons/latka/webpages/xml-reference.html
Index: xml-reference.html
===================================================================
<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>Latka - Latka XML Reference</title><meta value="Morgan Delagrange" name="author"><meta value="mdelagra@yahoo.com" name="email"><meta value="
Commons Documentation Team
" name="author"><meta value="commons-dev@jakarta.apache.org" name="email"></head><body vlink="#525D76" alink="#525D76" link="#525D76" text="#000000" bgcolor="#ffffff"><table cellspacing="4" width="100%" border="0"><!--PAGE HEADER--><tr><td colspan="2"><!--JAKARTA LOGO--><a href="http://jakarta.apache.org/"><img border="0" alt="The Jakarta Project" align="left" src="http://jakarta.apache.org/images/jakarta-logo.gif"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade=""></td></tr><tr><!--LEFT SIDE NAVIGATION--><td nowrap="true" valign="top" width="20%"><p><strong>Home</strong></p><ul><li><a href="./index.html">Latka</a></li><li><a href="http://jakarta.apache.org/commons/index.html">Jakarta Commons</a></li><li><a href="http://jakarta.apache.org/">Jakarta</a></li></ul><p><strong>Documentation</strong></p><ul><li><a href="./index.html">Overview</a></li><li><a href="./xml-reference.html">XML Reference</a></li><li><a href="./api/index.html">API Documentation</a></li></ul><p><strong>Download</strong></p><ul><li><a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-latka/1.0/">Latest Release</a></li><li><a href="http://jakarta.apache.org/builds/jakarta-commons/nightly/commons-latka/">Nightly Build</a></li></ul><p><strong>Project Files</strong></p><ul><li><a href="./status.html">Status</a></li><li><a href="http://cvs.apache.org/viewcvs/jakarta-commons/latka/">CVS</a></li><li><a href="./proposal.html">Original Proposal</a></li><li><a href="http://jakarta.apache.org/commons/license.html">License</a></li></ul><p><strong>Jakarta Community</strong></p><ul><li><a href="http://jakarta.apache.org/site/getinvolved.html">Get Involved</a></li><li><a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a></li><li><a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a></li><li><a href="http://jakarta.apache.org/site/library.html">Reference Library</a></li><li><a href="http://jakarta.apache.org/site/bugs.html">Bugs</a></li></ul></td><!--RIGHT SIDE MAIN BODY--><td align="left" valign="top" width="80%"><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Latka%20XML%20Reference"><strong>Latka XML Reference</strong></a></font></td></tr><tr><td><blockquote>
<a name="latka.ref.byteLength"></a><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="byteLength"><strong>byteLength</strong></a></font></td></tr><tr><td><blockquote>
<p>
validates the length of an HTTP(S) response
</p>
<p><a name=""><strong>DTD</strong></a><br>
<div align="left"><table border="0" cellpadding="0" cellspacing="4"><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff"><pre><!ELEMENT byteLength EMPTY>
<!ATTLIST byteLength min CDATA "0"
max CDATA #IMPLIED
label CDATA #IMPLIED></pre></td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr></table></div>
</p>
<p><a name=""><strong>Attributes</strong></a><br>
<table>
<tr><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Name</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Type</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Default</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Description</font></td></tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>min</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">NUMBER</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>0</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
Minimum number of bytes required for a valid
response. Implied. Defaults to
<code>0</code>.
</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>max</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">NUMBER</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
Maximum number of bytes required for a valid
response. Optional. When absent, there is no
upper limit on the number of bytes in a valid
response.
</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>label</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">CDATA</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
Label associated with this validation, which may
be used in programatically generated documentation
or reports. Optional.
</font></td>
</tr>
</table>
</p>
<p><a name=""><strong>Parents</strong></a><br>
<ul>
<li><a href="#latka.ref.validate">validate</a></li>
</ul>
</p>
<p><a name=""><strong>Description</strong></a><br>
<p>
A <code>byteLength</code> validation
passes if the HTTP(S) response is at least
<code>min</code>
bytes long, and (when specified) at most
<code>max</code> bytes long.
</p>
</p>
</blockquote></td></tr></table>
<a name="latka.ref.cookie"></a><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="cookie"><strong>cookie</strong></a></font></td></tr><tr><td><blockquote>
<p>
validates the presence of an HTTP(S) cookie in a response
</p>
<p><a name=""><strong>DTD</strong></a><br>
<div align="left"><table border="0" cellpadding="0" cellspacing="4"><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff"><pre><!ELEMENT cookie EMPTY>
<!ATTLIST cookie name CDATA #REQUIRED
value CDATA #IMPLIED
label CDATA #IMPLIED></pre></td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr></table></div>
</p>
<p><a name=""><strong>Attributes</strong></a><br>
<table>
<tr><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Name</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Type</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Default</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Description</font></td></tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>name</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">CDATA</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none, but required</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
The name of the cookie to look for.
Required.
</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>value</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">CDATA</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none, optional</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
The value that the cookie with the specified name should
have (if any).
</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>label</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">CDATA</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
Label associated with this validation, which may
be used in programatically generated documentation
or reports. Optional.
</font></td>
</tr>
</table>
</p>
<p><a name=""><strong>Parents</strong></a><br>
<ul>
<li><a href="#latka.ref.validate">validate</a></li>
</ul>
</p>
<p><a name=""><strong>Description</strong></a><br>
<p>
A <code>cookie</code> validation
passes if the HTTP(S) response contains a cookie with the
specified <code>name</code>.
If a <code>value</code> is provided,
the cookie must also have the specified value.
</p>
</p>
</blockquote></td></tr></table>
<a name="latka.ref.credentials"></a><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="credentials"><strong>credentials</strong></a></font></td></tr><tr><td><blockquote>
<p>
username/password credentials for Basic HTTP authentication.
</p>
<p><a name=""><strong>DTD</strong></a><br>
<div align="left"><table border="0" cellpadding="0" cellspacing="4"><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff"><pre><!ELEMENT credentials EMPTY>
<!ATTLIST credentials userName CDATA #REQUIRED
password CDATA #REQUIRED></pre></td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr></table></div>
</p>
<p><a name=""><strong>Attributes</strong></a><br>
<table>
<tr><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Name</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Type</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Default</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Description</font></td></tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>userName</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">CDATA</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none, required</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">User name. Required.</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>password</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">CDATA</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none, required</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Password. Required.</font></td>
</tr>
</table>
</p>
<p><a name=""><strong>Parents</strong></a><br>
<ul>
<li><a href="#latka.ref.request">request</a></li>
</ul>
</p>
<p><a name=""><strong>Description</strong></a><br>
<p>
Contains credentials for HTTP Basic Authentication.
</p>
</p>
</blockquote></td></tr></table>
<a name="latka.ref.maxRequestTime"></a><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="maxRequestTime"><strong>maxRequestTime</strong></a></font></td></tr><tr><td><blockquote>
<p>validates the response time for an HTTP(S) request</p>
<p><a name=""><strong>DTD</strong></a><br>
<div align="left"><table border="0" cellpadding="0" cellspacing="4"><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff"><pre><!ELEMENT maxRequestTime EMPTY>
<!ATTLIST maxRequestTime millis CDATA "30000"
message CDATA #IMPLIED></pre></td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr></table></div>
</p>
<p><a name=""><strong>Attributes</strong></a><br>
<table>
<tr><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Name</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Type</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Default</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Description</font></td></tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>millis</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">NUMBER</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>30000</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
Maximum amount of time, in milliseconds, in which
a response must be returned to be considered a
valid response. Implied. Defaults to
<code>30000</code> milliseconds,
or 30 seconds.
</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>label</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">CDATA</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
Label associated with this validation, which may
be used in programatically generated documentation
or reports. Optional.
</font></td>
</tr>
</table>
</p>
<p><a name=""><strong>Parents</strong></a><br>
<ul>
<li><a href="#latka.ref.validate">validate</a></li>
</ul>
</p>
<p><a name=""><strong>Description</strong></a><br>
<p>
A <code>maxRequestTime</code> validation
passes if the HTTP(S) response is obtained in no more than
<code>millis</code> milliseconds.
</p>
</p>
</blockquote></td></tr></table>
<a name="latka.ref.param"></a><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="param"><strong>param</strong></a></font></td></tr><tr><td><blockquote>
<p>indicates a request parameter as part of an HTTP(S) request to be executed</p>
<p><a name=""><strong>DTD</strong></a><br>
<div align="left"><table border="0" cellpadding="0" cellspacing="4"><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff"><pre><!ELEMENT request (paramName, paramValue)></pre></td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr></table></div>
</p>
<p><a name=""><strong>Attributes</strong></a><br>
<p>
<em>None.</em>
</p>
</p>
<p><a name=""><strong>Parents</strong></a><br>
<ul>
<li><a href="#latka.ref.request">request</a></li>
</ul>
</p>
<p><a name=""><strong>Description</strong></a><br>
<p>
A parameter to be submitted as part of a <a href="#latka.ref.request">request</a>.
</p>
</p>
</blockquote></td></tr></table>
<a name="latka.ref.paramName"></a><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="paramName"><strong>paramName</strong></a></font></td></tr><tr><td><blockquote>
<p>the name part of a name/value pair parameter</p>
<p><a name=""><strong>DTD</strong></a><br>
<div align="left"><table border="0" cellpadding="0" cellspacing="4"><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff"><pre><!ELEMENT paramName (#PCDATA)></pre></td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr></table></div>
</p>
<p><a name=""><strong>Attributes</strong></a><br>
<p>
<em>None.</em>
</p>
</p>
<p><a name=""><strong>Parents</strong></a><br>
<ul>
<li><a href="#latka.ref.param">param</a></li>
</ul>
</p>
<p><a name=""><strong>Description</strong></a><br>
<p>
The name part of <a href="#latka.ref.param">param</a>
to be submitted as part of a <a href="#latka.ref.request">request</a>.
</p>
</p>
</blockquote></td></tr></table>
<a name="latka.ref.paramValue"></a><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="paramValue"><strong>paramValue</strong></a></font></td></tr><tr><td><blockquote>
<p>the value part of a name/value pair parameter</p>
<p><a name=""><strong>DTD</strong></a><br>
<div align="left"><table border="0" cellpadding="0" cellspacing="4"><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff"><pre><!ELEMENT paramValue (#PCDATA)></pre></td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr></table></div>
</p>
<p><a name=""><strong>Attributes</strong></a><br>
<p>
<em>None.</em>
</p>
</p>
<p><a name=""><strong>Parents</strong></a><br>
<ul>
<li><a href="#latka.ref.param">param</a></li>
</ul>
</p>
<p><a name=""><strong>Description</strong></a><br>
<p>
The value part of <a href="#latka.ref.param">param</a>
to be submitted as part of a <a href="#latka.ref.request">request</a>.
</p>
</p>
</blockquote></td></tr></table>
<a name="latka.ref.regexp"></a><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="regexp"><strong>regexp</strong></a></font></td></tr><tr><td><blockquote>
<p>
validates the presence or absence of a regular expression within an HTTP(S) response
</p>
<p><a name=""><strong>DTD</strong></a><br>
<div align="left"><table border="0" cellpadding="0" cellspacing="4"><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff"><pre><!ELEMENT regexp EMPTY>
<!ATTLIST regexp pattern CDATA #REQUIRED
cond (true | false) "true"
ignoreCase (true | false) "false"
label CDATA #IMPLIED></pre></td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr></table></div>
</p>
<p><a name=""><strong>Attributes</strong></a><br>
<table>
<tr><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Name</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Type</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Default</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Description</font></td></tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>pattern</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">CDATA</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none, but required.</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
The regular expression to look for.
</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>cond</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
<em>Enumeration:</em>
<ul>
<li><code>true</code></li>
<li><code>false</code></li>
</ul>
</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>true</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
When <code>true</code>,
the given <code>pattern</code>
must match within the response.
When <code>false</code>,
the given <code>pattern</code>
must not match within the response.
</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>ignoreCase</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
<em>Enumeration:</em>
<ul>
<li><code>true</code></li>
<li><code>false</code></li>
</ul>
</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>false</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
When <code>true</code>,
case is ignored within the
given <code>pattern</code>.
</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>label</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">CDATA</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
Label associated with this validation, which may
be used in programatically generated documentation
or reports. Optional.
</font></td>
</tr>
</table>
</p>
<p><a name=""><strong>Parents</strong></a><br>
<ul>
<li><a href="#latka.ref.validate">validate</a></li>
</ul>
</p>
<p><a name=""><strong>Description</strong></a><br>
<p>
A <code>maxRequestTime</code> validation
passes if the HTTP(S) response is obtained in no more than
<code>millis</code> milliseconds.
</p>
</p>
</blockquote></td></tr></table>
<a name="latka.ref.request"></a><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="request"><strong>request</strong></a></font></td></tr><tr><td><blockquote>
<p>indicates an HTTP(S) request to be executed</p>
<p><a name=""><strong>DTD</strong></a><br>
<div align="left"><table border="0" cellpadding="0" cellspacing="4"><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff"><pre><!ELEMENT request (credentials?, param*, validate?)>
<!ATTLIST request path CDATA #REQUIRED
method (post | get) "get"
host CDATA #IMPLIED
port CDATA #IMPLIED
label CDATA #IMPLIED></pre></td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr></table></div>
</p>
<p><a name=""><strong>Attributes</strong></a><br>
<p>
<table>
<tr><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Name</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Type</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Default</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Description</font></td></tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>path</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">CDATA</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none, but required</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Request path. Required.</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>method</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
<em>enumeration:</em>
<ul>
<li><code>get</code></li>
<li><code>post</code></li>
</ul>
</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>get</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">HTTP method. Implied. Defaults to <code>get</code>.</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>host</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">CDATA</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
Host to submit request to.
Optional.
When absent, uses default from <a href="#latka.ref.suite">suite</a>.
</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>port</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">NUMBER</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>depends upon protocol</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
Port to submit request to.
Optional.
When absent, uses default from <a href="#latka.ref.suite">suite</a>.
</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>label</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">CDATA</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
Label associated with this validation, which may
be used in programatically generated documentation
or reports. Optional.
</font></td>
</tr>
</table>
</p>
</p>
<p><a name=""><strong>Parents</strong></a><br>
<ul>
<li><a href="#latka.ref.suite">suite</a></li>
<li><a href="#latka.ref.session">session</a></li>
</ul>
</p>
<p><a name=""><strong>Description</strong></a><br>
<p>
An HTTP(S) request to be executed.
</p>
</p>
</blockquote></td></tr></table>
<a name="latka.ref.session"></a><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="session"><strong>session</strong></a></font></td></tr><tr><td><blockquote>
<p>wrapper for a sequence of <a href="#latka.ref.request">request</a>s associated with the same state (session)</p>
<p><a name=""><strong>DTD</strong></a><br>
<div align="left"><table border="0" cellpadding="0" cellspacing="4"><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff"><pre><!ELEMENT session (request+)>
<!ATTLIST session sessionId CDATA #IMPLIED
label CDATA #IMPLIED></pre></td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr></table></div>
</p>
<p><a name=""><strong>Attributes</strong></a><br>
<table>
<tr><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Name</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Type</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Default</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Description</font></td></tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>sessionId</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">CDATA</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
Unique identifier for this <code>session</code>.
Sessions with the same <code>sessionId</code>
will share the same underlying state (e.g., cookies, etc.)
</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>label</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">CDATA</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
Label associated with this <code>session</code>, which may
be used in programatically generated documentation
or reports. Optional.
</font></td>
</tr>
</table>
</p>
<p><a name=""><strong>Parents</strong></a><br>
<ul>
<li><a href="#latka.ref.suite">suite</a></li>
</ul>
</p>
<p><a name=""><strong>Description</strong></a><br>
<p>
A <code>session</code> is a collection of
<a href="#latka.ref.request">request</a>s
that share the same underlying state. For example,
a cookie that returned in the response to one
<a href="#latka.ref.request">request</a>
will be included in subsequent
<a href="#latka.ref.request">request</a>s.
</p>
</p>
</blockquote></td></tr></table>
<a name="latka.ref.statusCode"></a><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="statusCode"><strong>statusCode</strong></a></font></td></tr><tr><td><blockquote>
<p>validates an HTTP response code</p>
<p><a name=""><strong>DTD</strong></a><br>
<div align="left"><table border="0" cellpadding="0" cellspacing="4"><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff"><pre><!ELEMENT statusCode EMPTY>
<!ATTLIST statusCode code CDATA "200"
label CDATA #IMPLIED></pre></td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr></table></div>
</p>
<p><a name=""><strong>Attributes</strong></a><br>
<table>
<tr><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Name</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Type</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Default</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Description</font></td></tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>code</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">NUMBER</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>200</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
Numeric HTTP response code to expect.
Implied. Defaults to
<code>200</code>.
</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>label</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">CDATA</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
Label associated with this validation, which may
be used in programatically generated documentation
or reports. Optional.
</font></td>
</tr>
</table>
</p>
<p><a name=""><strong>Parents</strong></a><br>
<ul>
<li><a href="#latka.ref.validate">validate</a></li>
</ul>
</p>
<p><a name=""><strong>Description</strong></a><br>
<p>
A <code>statusCode</code> validation
passes if the HTTP(S) response code for the given request
matches the value specified by
<code>code</code>.
</p>
</p>
</blockquote></td></tr></table>
<a name="latka.ref.suite"></a><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="suite"><strong>suite</strong></a></font></td></tr><tr><td><blockquote>
<p>root element for a suite of tests</p>
<p><a name=""><strong>DTD</strong></a><br>
<div align="left"><table border="0" cellpadding="0" cellspacing="4"><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff"><pre><!ELEMENT suite ( (session | request)+ )>
<!ATTLIST suite defaultHost CDATA #IMPLIED
defaultPort CDATA #IMPLIED
label CDATA #IMPLIED></pre></td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr></table></div>
</p>
<p><a name=""><strong>Attributes</strong></a><br>
<table>
<tr><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Name</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Type</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Default</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Description</font></td></tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>defaultHost</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">CDATA</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
Default hostname for <a href="#latka.ref.request">request</a>s. Optional.
</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>defaultPort</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">NUMBER</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
Default port for <a href="#latka.ref.request">request</a>s. Optional.
</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>label</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">CDATA</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
Label associated with this <code>suite</code>, which may
be used in programatically generated documentation
or reports. Optional.
</font></td>
</tr>
</table>
</p>
<p><a name=""><strong>Parents</strong></a><br>
<p>
<em>None.</em>
</p>
</p>
<p><a name=""><strong>Description</strong></a><br>
<p>
A <code>suite</code> is a collection of
<a href="#latka.ref.request">request</a>s
and <a href="#latka.ref.session">session</a>s
to execute.
</p>
</p>
</blockquote></td></tr></table>
<a name="latka.ref.validate"></a><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="validate"><strong>validate</strong></a></font></td></tr><tr><td><blockquote>
<p>
indicates the suite of validations to apply to the
current <a href="#latka.ref.request">request</a> (and its response)
</p>
<p><a name=""><strong>DTD</strong></a><br>
<div align="left"><table border="0" cellpadding="0" cellspacing="4"><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff"><pre><!ELEMENT validate (byteLength | cookie | maxRequestTime | regexp | statusCode | xpath )+></pre></td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr></table></div>
</p>
<p><a name=""><strong>Attributes</strong></a><br>
<p>
<em>None.</em>
</p>
</p>
<p><a name=""><strong>Parents</strong></a><br>
<ul>
<li><a href="#latka.ref.request">request</a></li>
</ul>
</p>
<p><a name=""><strong>Description</strong></a><br>
<p>
Contains the set of validations to apply to the
current <a href="#latka.ref.request">request</a>
(and its response).
</p>
</p>
</blockquote></td></tr></table>
<a name="latka.ref.xpath"></a><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="xpath"><strong>xpath</strong></a></font></td></tr><tr><td><blockquote>
<p>
xpath - assuming the HTTP(s) response contains XML, checks if an
<a href="http://www.w3.org/TR/xpath">XPath</a> expression matches
</p>
<p><a name=""><strong>DTD</strong></a><br>
<div align="left"><table border="0" cellpadding="0" cellspacing="4"><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff"><pre><!ELEMENT xpath EMPTY>
<!ATTLIST xpath select CDATA #REQUIRED
cond (true | false) "true"
value CDATA #IMPLIED
label CDATA #IMPLIED></pre></td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr><tr><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td></tr></table></div>
</p>
<p><a name=""><strong>Attributes</strong></a><br>
<table>
<tr><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Name</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Type</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Default</font></td><td valign="top" bgcolor="#039acc"><font face="arial,helvetica,sanserif" size="-1" color="#000000">Description</font></td></tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>select</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">CDATA</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><em>none</em></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
An XPath expression, designed to match a node in the
XML body of the response.
</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>cond</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
<em>Enumeration:</em>
<ul>
<li><code>true</code></li>
<li><code>false</code></li>
</ul>
</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
<code>true</code>
</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
When <code>true</code>, the given XPath expression must match within the
response. When <code>false</code>, the given XPath expression must not
match within the response.
</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>value</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
CDATA
</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
<em>none, optional</em>
</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
The value that the matched node should have, if any.
</font></td>
</tr>
<tr>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000"><code>label</code></font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
CDATA
</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
<em>none</em>
</font></td>
<td align="left" valign="top" bgcolor="#a0ddf0"><font face="arial,helvetica,sanserif" size="-1" color="#000000">
Label associated with this validation, which may be used
in programatically generated documentation or reports. Optional.
</font></td>
</tr>
</table>
</p>
<p><a name=""><strong>Parents</strong></a><br>
<ul>
<li><a href="#latka.ref.validate">validate</a></li>
</ul>
</p>
<p><a name=""><strong>Description</strong></a><br>
<p>
A xpath validation passes if the HTTP(S) response body contains XML,
and the specified XPath expression matches (or not, depending on cond)
</p>
</p>
</blockquote></td></tr></table>
</blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade=""></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font size="-1" color="#525D76"><em>
Copyright © 1999-2002, Apache Software Foundation
</em></font></div></td></tr></table></body></html>
1.1 jakarta-commons/latka/webpages/users-guide.html
Index: users-guide.html
===================================================================
<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>Latka - Latka User's Guide</title><meta value="
Commons Documentation Team
" name="author"><meta value="commons-dev@jakarta.apache.org" name="email"></head><body vlink="#525D76" alink="#525D76" link="#525D76" text="#000000" bgcolor="#ffffff"><table cellspacing="4" width="100%" border="0"><!--PAGE HEADER--><tr><td colspan="2"><!--JAKARTA LOGO--><a href="http://jakarta.apache.org/"><img border="0" alt="The Jakarta Project" align="left" src="http://jakarta.apache.org/images/jakarta-logo.gif"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade=""></td></tr><tr><!--LEFT SIDE NAVIGATION--><td nowrap="true" valign="top" width="20%"><p><strong>Home</strong></p><ul><li><a href="./index.html">Latka</a></li><li><a href="http://jakarta.apache.org/commons/index.html">Jakarta Commons</a></li><li><a href="http://jakarta.apache.org/">Jakarta</a></li></ul><p><strong>Documentation</strong></p><ul><li><a href="./index.html">Overview</a></li><li><a href="./xml-reference.html">XML Reference</a></li><li><a href="./api/index.html">API Documentation</a></li></ul><p><strong>Download</strong></p><ul><li><a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-latka/1.0/">Latest Release</a></li><li><a href="http://jakarta.apache.org/builds/jakarta-commons/nightly/commons-latka/">Nightly Build</a></li></ul><p><strong>Project Files</strong></p><ul><li><a href="./status.html">Status</a></li><li><a href="http://cvs.apache.org/viewcvs/jakarta-commons/latka/">CVS</a></li><li><a href="./proposal.html">Original Proposal</a></li><li><a href="http://jakarta.apache.org/commons/license.html">License</a></li></ul><p><strong>Jakarta Community</strong></p><ul><li><a href="http://jakarta.apache.org/site/getinvolved.html">Get Involved</a></li><li><a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a></li><li><a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a></li><li><a href="http://jakarta.apache.org/site/library.html">Reference Library</a></li><li><a href="http://jakarta.apache.org/site/bugs.html">Bugs</a></li></ul></td><!--RIGHT SIDE MAIN BODY--><td align="left" valign="top" width="80%"><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="What%20is%20Latka"><strong>What is Latka</strong></a></font></td></tr><tr><td><blockquote>
<p>Latka is a functional (end-to-end) testing tool. It is implemented
in Java, and uses an XML syntax to define a series of HTTP (or HTTPS)
requests and a set of <i>validations</i> used to verify
that the request was processed correctly.
</p>
<p><b>Note:</b>
Although Latka currently supports only HTTP and HTTPS
request/response validations, it may be expanded to perform other
sorts of functional testing as warranted.
</p>
<p>
A simple example of a Latka XML test suite is shown in our
<a href="TestCommonsWebsite.xml">sample Latka test suite</a>.
When processed, this example would verify that the Jakarta Commons
homepage is present and that all the Commons Components have online documenation.
</p>
</blockquote></td></tr></table><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Running%20Latka"><strong>Running Latka</strong></a></font></td></tr><tr><td><blockquote>
<p>There are two ways that a Latka suite can be run:
<ul>
<li><p>From a command prompt</p></li>
<li><p>From the Latka web application</p></li>
</ul>
<p><b>Note:</b>How about an ant task?</p>
</p>
<table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Running%20Latka%20from%20the%20command%20prompt"><strong>Running Latka from the command prompt</strong></a></font></td></tr><tr><td><blockquote>
<p>There are two scripts (or batch files) shipped with latka:</p>
<ul>
<li><p>latka.bat - for Windows machines</p></li>
<li><p>latka.sh - for Unix machines</p></li>
</ul>
<p>Both of the scripts take the following parameters: </p>
<ul>
<li><p></p></li>
</ul>
</blockquote></td></tr></table>
</blockquote></td></tr></table><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Anatomy%20of%20a%20test%20suite"><strong>Anatomy of a test suite</strong></a></font></td></tr><tr><td><blockquote>
<p>A Latka test suite is an XML document</p>
</blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade=""></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font size="-1" color="#525D76"><em>
Copyright © 1999-2002, Apache Software Foundation
</em></font></div></td></tr></table></body></html>
1.1 jakarta-commons/latka/webpages/status.html
Index: status.html
===================================================================
<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>Latka - Status File for Jakarta Commons "Latka" Application</title><meta value="Morgan Delagrange" name="author"><meta value="mdelagra@yahoo.com" name="email"><meta value="Doug Sale" name="author"><meta value="dsale@us.britannica.com" name="email"><meta value="Rodney Waldhoff" name="author"><meta value="rwaldhof@us.britannica.com" name="email"><meta value="
Commons Documentation Team
" name="author"><meta value="commons-dev@jakarta.apache.org" name="email"></head><body vlink="#525D76" alink="#525D76" link="#525D76" text="#000000" bgcolor="#ffffff"><table cellspacing="4" width="100%" border="0"><!--PAGE HEADER--><tr><td colspan="2"><!--JAKARTA LOGO--><a href="http://jakarta.apache.org/"><img border="0" alt="The Jakarta Project" align="left" src="http://jakarta.apache.org/images/jakarta-logo.gif"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade=""></td></tr><tr><!--LEFT SIDE NAVIGATION--><td nowrap="true" valign="top" width="20%"><p><strong>Home</strong></p><ul><li><a href="./index.html">Latka</a></li><li><a href="http://jakarta.apache.org/commons/index.html">Jakarta Commons</a></li><li><a href="http://jakarta.apache.org/">Jakarta</a></li></ul><p><strong>Documentation</strong></p><ul><li><a href="./index.html">Overview</a></li><li><a href="./xml-reference.html">XML Reference</a></li><li><a href="./api/index.html">API Documentation</a></li></ul><p><strong>Download</strong></p><ul><li><a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-latka/1.0/">Latest Release</a></li><li><a href="http://jakarta.apache.org/builds/jakarta-commons/nightly/commons-latka/">Nightly Build</a></li></ul><p><strong>Project Files</strong></p><ul><li><a href="./status.html">Status</a></li><li><a href="http://cvs.apache.org/viewcvs/jakarta-commons/latka/">CVS</a></li><li><a href="./proposal.html">Original Proposal</a></li><li><a href="http://jakarta.apache.org/commons/license.html">License</a></li></ul><p><strong>Jakarta Community</strong></p><ul><li><a href="http://jakarta.apache.org/site/getinvolved.html">Get Involved</a></li><li><a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a></li><li><a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a></li><li><a href="http://jakarta.apache.org/site/library.html">Reference Library</a></li><li><a href="http://jakarta.apache.org/site/bugs.html">Bugs</a></li></ul></td><!--RIGHT SIDE MAIN BODY--><td align="left" valign="top" width="80%"><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="INTRODUCTION"><strong>INTRODUCTION</strong></a></font></td></tr><tr><td><blockquote>
<p>Testing websites is a pain. Many regression tests for a website can
be verified automatically, speeding up the quality assurance process
and allowing the engineers to focus on the more important issues.
Additionally developers may want to monitor their development, QA
and production environment, so that they can be sure that everything
is running as they expect.</p>
<p>Latka is an HTTP functional testing suite for automated QA, acceptance and
regression testing. Latka suites are XML documents, which
can be written and/or modified without writing Java code. Latka tests can be
created quickly and modified easily, even by engineers without Java experience.</p>
</blockquote></td></tr></table><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="2. DEPENDENCIES"><strong>2. DEPENDENCIES</strong></a></font></td></tr><tr><td><blockquote>
<p><em>Latka</em> relies on:</p>
<ul>
<li><p>Java Development Kit (Version 1.3 or later)</p></li>
<li><p>A JAXP 1.1 implementation</p></li>
<li><p>A SAX 2.0 parser conforming to the JAXP 1.1 APIs</p></li>
<li><p>An XSLT parser conforming to JAXP 1.1</p></li>
<li><p>HttpClient from Commons - for HTTP communcation</p></li>
<li><p>Jakarta Log4J logging package</p></li>
<li><p>JUnit - for testing</p></li>
<li><p>JSSE - SSL support (optional at runtime)</p></li>
<li><p>Jakarta-Regexp - regular expression tests and XML preprocessing (for variable support)</p></li>
<li><p>JDOM - for building XML reports</p></li>
</ul>
</blockquote></td></tr></table><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="3. RELEASE INFO"><strong>3. RELEASE INFO</strong></a></font></td></tr><tr><td><blockquote>
<p>Current Release: <a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-latka/1.0/">
1.0 alpha 2</a></p>
<p>Planned Next Release: 1.0, timeframe: None defined</p>
</blockquote></td></tr></table><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="4. COMMITTERS"><strong>4. COMMITTERS</strong></a></font></td></tr><tr><td><blockquote>
<p>The following individuals are the primary developers and
maintainers of this component. Developers who plan to use
<em>Latka</em> in their own projects are encouraged to collaborate
on the future development of this component to ensure that it continues to meet
a variety of needs.</p>
<ul>
<li><p>Morgan Delagrange</p></li>
<li><p>Doug Sale</p></li>
<li><p>Rodney Waldhoff</p></li>
<li><p>Jeff Turner (part-time)</p></li>
</ul>
</blockquote></td></tr></table><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="5. DEVELOPMENT STATUS"><strong>5. DEVELOPMENT STATUS</strong></a></font></td></tr><tr><td><blockquote>
<p>Latka development status:</p>
<ul>
<li><p>Latka 1.0 Alpha 1 released</p></li>
<li><p>Latka library and command line interface:</p>
<p> Fully functional, but with potential interface changes
forthcoming.</p></li>
<li><p>Latka tag library (in Jakarta Taglibs):</p>
<p> Experimental, unstable.</p></li>
<li><p>Latka web application (in Commons Sandbox):</p>
<p> Experimental, promising but unstable.</p></li>
</ul>
<table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Todo items:"><strong>Todo items:</strong></a></font></td></tr><tr><td><blockquote>
<ul>
<li><p>Fix the documentation system :) It's currently
horrible; a single HTML file, created by some GUI editor. I would very much
recommend the XML DTD + stylesheet in the Anteater project (see <a href="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/aft/Anteater/doc/">
http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/aft/Anteater/doc/</a>), whose
styled output may be (temporarily) viewed <a href="http://opensource.socialchange.net.au/latka/Anteater.html">here</a>.
</p></li>
<li><p>Add a universal mechanism for negating
validators. Currently regexp and xpath validators implement negation internally
as a special <literal moreinfo="none">cond</literal> attribute. This adds somewhat to the
internal complexity. It would be better to have the framework handle negation by
being able to wrap tests in a <not/> element.</p></li>
<li><p>Make the inclusion of individual validators
optional at build time.</p></li>
<li><p>Write unit tests for each validator, with a mock
object implementing the Response interface</p></li>
</ul>
</blockquote></td></tr></table>
</blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade=""></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font size="-1" color="#525D76"><em>
Copyright © 1999-2002, Apache Software Foundation
</em></font></div></td></tr></table></body></html>
1.1 jakarta-commons/latka/webpages/proposal.html
Index: proposal.html
===================================================================
<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>Latka - Proposal for Latka Package</title><meta value="Morgan Delagrange" name="author"><meta value="mdelagra@yahoo.com" name="email"><meta value="Doug Sale" name="author"><meta value="dsale@us.britannica.com" name="email"><meta value="Rodney Waldhoff" name="author"><meta value="rwaldhof@us.britannica.com" name="email"><meta value="
Commons Documentation Team
" name="author"><meta value="commons-dev@jakarta.apache.org" name="email"></head><body vlink="#525D76" alink="#525D76" link="#525D76" text="#000000" bgcolor="#ffffff"><table cellspacing="4" width="100%" border="0"><!--PAGE HEADER--><tr><td colspan="2"><!--JAKARTA LOGO--><a href="http://jakarta.apache.org/"><img border="0" alt="The Jakarta Project" align="left" src="http://jakarta.apache.org/images/jakarta-logo.gif"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade=""></td></tr><tr><!--LEFT SIDE NAVIGATION--><td nowrap="true" valign="top" width="20%"><p><strong>Home</strong></p><ul><li><a href="./index.html">Latka</a></li><li><a href="http://jakarta.apache.org/commons/index.html">Jakarta Commons</a></li><li><a href="http://jakarta.apache.org/">Jakarta</a></li></ul><p><strong>Documentation</strong></p><ul><li><a href="./index.html">Overview</a></li><li><a href="./xml-reference.html">XML Reference</a></li><li><a href="./api/index.html">API Documentation</a></li></ul><p><strong>Download</strong></p><ul><li><a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-latka/1.0/">Latest Release</a></li><li><a href="http://jakarta.apache.org/builds/jakarta-commons/nightly/commons-latka/">Nightly Build</a></li></ul><p><strong>Project Files</strong></p><ul><li><a href="./status.html">Status</a></li><li><a href="http://cvs.apache.org/viewcvs/jakarta-commons/latka/">CVS</a></li><li><a href="./proposal.html">Original Proposal</a></li><li><a href="http://jakarta.apache.org/commons/license.html">License</a></li></ul><p><strong>Jakarta Community</strong></p><ul><li><a href="http://jakarta.apache.org/site/getinvolved.html">Get Involved</a></li><li><a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a></li><li><a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a></li><li><a href="http://jakarta.apache.org/site/library.html">Reference Library</a></li><li><a href="http://jakarta.apache.org/site/bugs.html">Bugs</a></li></ul></td><!--RIGHT SIDE MAIN BODY--><td align="left" valign="top" width="80%"><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="(0) Rationale"><strong>(0) Rationale</strong></a></font></td></tr><tr><td><blockquote>
<p>Testing websites is a pain. Many regression tests for a website can
be verified automatically, speeding up the quality assurance process and
allowing the engineers to focus on the more important issues. Additionally
developers may want to monitor their development, QA and production environment,
so that they can be sure that everything is running as they expect.</p>
<p>Latka is an HTTP functional testing suite for automated QA. Latka
suites are XML documents, which can be written and/or modified without writing
Java code. Latka tests can be created quickly and modified easily, even by
engineers without Java experience.</p>
</blockquote></td></tr></table><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="(1) Scope of the Package"><strong>(1) Scope of the Package</strong></a></font></td></tr><tr><td><blockquote>
<p>The <em>Latka</em> project shall develop an
XML-based syntax for HTTP-based functional tests. Latka will support, at the
least, SSL communication and cookies.</p>
<p>Included within Latka are classes that simulate a user agent.
While the backend HTTP communication is handled by the HttpClient Commons
component, the Latka interfaces simulate some of the behaviour of an actual web
browser, including automatically passing cookies from request to request in a
session. We hope to integrate these classes into a "useragent" package in
HttpClient at some point, since they are a useful abstraction and not tied to
Latka in any way, nor do they modify the core HttpClient classes.</p>
<p>Latka also includes several validations that can be performed
on the HTTP responses, including checking the status code, byte length, or
request timing. In addition you will be able to customize Latka with your own
validators by writing a couple of simple classes.</p>
</blockquote></td></tr></table><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="(1.5) Interaction With Other Packages"><strong>(1.5) Interaction With Other Packages</strong></a></font></td></tr><tr><td><blockquote>
<p><em>Latka</em> relies on:</p>
<ul>
<li><p>Java Development Kit (Version 1.3 or later)</p></li>
<li><p>A JAXP 1.1 implementation</p></li>
<li><p>A SAX 2.0 parser conforming to the JAXP 1.1 APIs</p></li>
<li><p>An XSLT parser conforming to JAXP 1.1</p></li>
<li><p>HttpClient from Commons - for HTTP communcation</p></li>
<li><p>Logging component from Commons (not yet implemented)</p></li>
<li><p>JUnit - for testing</p></li>
<li><p>JSSE - SSL support (optional at runtime)</p></li>
<li><p>Jakarta-Regexp - regular expression tests and XML preprocessing (for variable support)</p></li>
<li><p>JDOM - for building XML reports</p></li>
</ul>
</blockquote></td></tr></table><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="(2) Initial Source of the Package"><strong>(2) Initial Source of the Package</strong></a></font></td></tr><tr><td><blockquote>
<p>The initial source has been committed to the Sandbox, and includes
almost all of the functionality described above.</p>
</blockquote></td></tr></table><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="(3) Required Jakarta-Commons Resources"><strong>(3) Required Jakarta-Commons Resources</strong></a></font></td></tr><tr><td><blockquote>
<ul>
<li>
<p>CVS Repository - New directory <em>latka
</em> in the <em>jakarta-commons</em> CVS repository.</p>
</li>
<li><p>Mailing List - Discussions will take place on
the general <em>jakarta-commons@jakarta.apache.org</em> mailing
list. To help list subscribers identify messages of interest, it is suggested
that the message subject of messages about this component be prefixed with
[Latka].</p></li>
<li><p>Bugzilla - New component "Latka" under the
"Commons" product category, with appropriate version identifiers as needed.
</p></li>
<li><p>Jyve FAQ - New category "commons-latka" (when
available).</p></li>
</ul>
</blockquote></td></tr></table><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="(4) Initial Committers"><strong>(4) Initial Committers</strong></a></font></td></tr><tr><td><blockquote>
<p>The initial committers on the Latka component shall be:</p>
<ul>
<li><p>Morgan Delagrange</p></li>
<li><p>Doug Sale</p></li>
<li><p>Rodney Waldhoff</p></li>
<li><p>TBD</p></li>
</ul>
</blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade=""></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font size="-1" color="#525D76"><em>
Copyright © 1999-2002, Apache Software Foundation
</em></font></div></td></tr></table></body></html>
1.1 jakarta-commons/latka/webpages/index.html
Index: index.html
===================================================================
<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>Latka - Latka (Version 1.0 Alpha 2)</title><meta value="Morgan Delagrange" name="author"><meta value="mdelagra@yahoo.com" name="email"><meta value="
Commons Documentation Team
" name="author"><meta value="commons-dev@jakarta.apache.org" name="email"></head><body vlink="#525D76" alink="#525D76" link="#525D76" text="#000000" bgcolor="#ffffff"><table cellspacing="4" width="100%" border="0"><!--PAGE HEADER--><tr><td colspan="2"><!--JAKARTA LOGO--><a href="http://jakarta.apache.org/"><img border="0" alt="The Jakarta Project" align="left" src="http://jakarta.apache.org/images/jakarta-logo.gif"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade=""></td></tr><tr><!--LEFT SIDE NAVIGATION--><td nowrap="true" valign="top" width="20%"><p><strong>Home</strong></p><ul><li><a href="./index.html">Latka</a></li><li><a href="http://jakarta.apache.org/commons/index.html">Jakarta Commons</a></li><li><a href="http://jakarta.apache.org/">Jakarta</a></li></ul><p><strong>Documentation</strong></p><ul><li><a href="./index.html">Overview</a></li><li><a href="./xml-reference.html">XML Reference</a></li><li><a href="./api/index.html">API Documentation</a></li></ul><p><strong>Download</strong></p><ul><li><a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-latka/1.0/">Latest Release</a></li><li><a href="http://jakarta.apache.org/builds/jakarta-commons/nightly/commons-latka/">Nightly Build</a></li></ul><p><strong>Project Files</strong></p><ul><li><a href="./status.html">Status</a></li><li><a href="http://cvs.apache.org/viewcvs/jakarta-commons/latka/">CVS</a></li><li><a href="./proposal.html">Original Proposal</a></li><li><a href="http://jakarta.apache.org/commons/license.html">License</a></li></ul><p><strong>Jakarta Community</strong></p><ul><li><a href="http://jakarta.apache.org/site/getinvolved.html">Get Involved</a></li><li><a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a></li><li><a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a></li><li><a href="http://jakarta.apache.org/site/library.html">Reference Library</a></li><li><a href="http://jakarta.apache.org/site/bugs.html">Bugs</a></li></ul></td><!--RIGHT SIDE MAIN BODY--><td align="left" valign="top" width="80%"><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="What%20is%20Latka?"><strong>What is Latka?</strong></a></font></td></tr><tr><td><blockquote>
<p>
<i>Latka</i> is a functional (end-to-end) testing
tool. It is implemented in Java, and uses an XML syntax to define
a series of HTTP (or HTTPS) requests and a set of
<i>validations</i> used to verify that the request
was processed correctly.
</p>
<p><b>Note:</b>
Although Latka currently supports only HTTP and HTTPS
request/response validations, it may be expanded to perform other
sorts of functional testing as warranted.
</p>
<p>
A simple example of a Latka XML test suite is shown in our
<a href="TestCommonsWebsite.xml">sample Latka test suite</a>.
When processed, this example would verify that the Jakarta Commons
homepage is present and that all the Commons Components have online documenation.
</p>
</blockquote></td></tr></table><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Installing%20Latka"><strong>Installing Latka</strong></a></font></td></tr><tr><td><blockquote>
<table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Requirements"><strong>Requirements</strong></a></font></td></tr><tr><td><blockquote>
<ul>
<li><p>JDK 1.3 or better</p></li>
<li><p>
(for optional web application)
Tomcat 4.0 B7 or better - does not work in Tomcat 3.2, untested in
other containers</p>
</li>
<li><p>
(for optional SSL support)
<a href="http://java.sun.com/security/index.html">Sun JSSE library</a>
</p>
</li>
</ul>
</blockquote></td></tr></table>
<table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="General%20installation"><strong>General installation</strong></a></font></td></tr><tr><td><blockquote>
<ol>
<li><p>
Download and uncompress the
<a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-latka">Latka distribution</a>.
</p>
</li>
<li><p>
If you wish to perform Latka test over SSL,
you need to configure your JVM with the
<a href="http://java.sun.com/security/index.html">Sun JSSE library</a>.
</p>
</li>
</ol>
</blockquote></td></tr></table>
<table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Optional%20web%20application%20installation%20"><strong>Optional web application installation </strong></a></font></td></tr><tr><td><blockquote>
<ol>
<li><p>
Copy the "webapp/latka-webapp.war" file from the
distribution to the "webapp" directory of Tomcat.</p>
</li>
<li><p>
If you have already configured log4j for Tomcat,
you should remove log4j.jar from the /WEB-INF/lib
directory of the Latka webapp. </p>
</li>
</ol>
</blockquote></td></tr></table>
</blockquote></td></tr></table><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Using%20Latka"><strong>Using Latka</strong></a></font></td></tr><tr><td><blockquote>
<table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Running%20the%20sample%20tests"><strong>Running the sample tests</strong></a></font></td></tr><tr><td><blockquote>
<p><b>Note:</b>Command-line interface</p>
<ol>
<li>
<p>Open a command prompt inside the "bin" directory of the
distribution.</p>
</li>
<li><p>
Run the Latka batch script on one of the sample XML test suites
(e.g. "latka file:../tests/samples/TestCommonsWebsite.xml ").
</p>
</li>
</ol>
<p><b>Note:</b>Web application</p>
<ol>
<li><p>
Go to the index page of the Latka web application.</p>
</li>
<li><p>Select "Run a test from the server"</p></li>
<li><p>
In the test directory dialog box, enter the directory:
<latka distrubution directory>/tests/samples
</p>
</li>
<li><p>
Click on one of the tests to execute it.</p>
</li>
</ol>
</blockquote></td></tr></table>
<table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Creating%20your%20own%20tests"><strong>Creating your own tests</strong></a></font></td></tr><tr><td><blockquote>
<p>
(More to come...) Examine the Latka DTD in the conf directory
for a list of all available elements. See the samples for typical syntax.
</p>
</blockquote></td></tr></table>
<table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Running%20tests"><strong>Running tests</strong></a></font></td></tr><tr><td><blockquote>
<p><b>Note:</b>Command-line interface</p>
<ol>
<li><p>
Open a command prompt inside the "bin" directory of the distribution.
</p>
</li>
<li>
<p>
Run the Latka script with no arguments for information on usage.
</p>
</li>
</ol>
<p><b>Note:</b>Web application</p>
<ol>
<li>
<p>Go to the index page of the Latka web application.</p>
</li>
<li><p>Select "Run a test from the server"</p></li>
<li><p>
In the test directory dialog box, enter the directory where your tests are located.
</p>
</li>
<li><p>Click on one of the tests to execute it.</p></li>
</ol>
</blockquote></td></tr></table>
<table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Creating%20your%20custom%20validations"><strong>Creating your custom validations</strong></a></font></td></tr><tr><td><blockquote>
<p><b>Note:</b>(More to come...)</p>
</blockquote></td></tr></table>
</blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade=""></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font size="-1" color="#525D76"><em>
Copyright © 1999-2002, Apache Software Foundation
</em></font></div></td></tr></table></body></html>
1.1 jakarta-commons/latka/webpages/RELEASE_NOTES.txt
Index: RELEASE_NOTES.txt
===================================================================
LATKA RELEASE NOTES
-------------------
Note: Alpha and beta releases are not frozen in terms of the API. There may be changes before the final release.
1.0 Alpha 2
-----------
Webapp interface
- Added last modified dates to the list of tests on the server
- Added more HTML-friendly stylesheet for test results
- Added servlet to view the XML of a Latka suite. This servlet
resolves all external entities.
Webapp and command-line interface
- Added ability to set default properties from the classpath using the
latka.properties file, and added default prop files to the command-line
and webapp distributions
- Removed unnecessary redundancy from labels for request failures and
errors.
- Removed labels from skipped requests, which were unnecessary and not
permitted by the DTD.
1.0 Alpha 1
-----------
- First Latka release
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>