jmeter/docs/usermanual/build-adv-web-test-plan.html

331 lines
10 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<!-- Content Stylesheet for Site -->
<!-- start the processing -->
<!-- ====================================================================== -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<html>
<head>
<link rel="stylesheet" type="text/css" href="../css/style.css"/>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<title>Apache JMeter - User's Manual: Building an Advanced Web Test Plan</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
<table border="0" cellspacing="0">
<!-- TOP IMAGE -->
<tr>
<td>
<!-- Need to specify height otherwise iframe seems to grab extra -->
<iframe src="http://www.apache.org/ads/halfbanner.html" height="102"
style="border-width:0; float: left" frameborder="0" scrolling="no"></iframe>
</td>
<td align="left">
<a href="http://www.apache.org"><img title="Apache Software Foundation" width="387" height="100" src="../images/asf-logo.gif" border="0"/></a>
</td>
<td align="right">
<a href="http://jmeter.apache.org/"><img width="221" height="102" src="../images/logo.jpg" alt="Apache JMeter" title="Apache JMeter" border="0"/></a>
</td>
</tr>
</table>
<table border="0" width="100%" cellspacing="4">
<tr><td colspan="2">
<hr noshade size="1"/>
</td></tr>
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td width="20%" valign="top" nowrap="true">
<p><strong>About</strong></p>
<ul>
<li><a href="../index.html">Overview</a>
</li>
<li><a href="../changes.html">Changes</a>
</li>
<li><a href="http://projects.apache.org/feeds/rss/jmeter.xml">Subscribe to What's New</a>
</li>
<li><a href="../issues.html">Issues</a>
</li>
<li><a href="http://www.apache.org/licenses/">License</a>
</li>
<li><a href="http://wiki.apache.org/jmeter/JMeterCommitters">Contributors</a>
</li>
</ul>
<p><strong>Download</strong></p>
<ul>
<li><a href="../download_jmeter.cgi">Download Releases</a>
</li>
<li><a href="../nightly.html">Developer (Nightly) Builds</a>
</li>
</ul>
<p><strong>Documentation</strong></p>
<ul>
<li><a href="../usermanual/index.html">User Manual</a>
</li>
<li><a href="../usermanual/component_reference.html">Component Reference</a>
</li>
<li><a href="../usermanual/functions.html">Functions Reference</a>
</li>
<li><a href="../api/index.html">Javadocs</a>
</li>
<li><a href="../localising/index.html">Localisation (Translator's Guide)</a>
</li>
<li><a href="../building.html">Building JMeter and Add-Ons</a>
</li>
<li><a href="http://wiki.apache.org/jmeter">JMeter Wiki</a>
</li>
<li><a href="http://wiki.apache.org/jmeter/JMeterFAQ">FAQ (Wiki)</a>
</li>
</ul>
<p><strong>Tutorials (PDF format)</strong></p>
<ul>
<li><a href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed Testing</a>
</li>
<li><a href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording Tests</a>
</li>
<li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit Sampler</a>
</li>
<li><a href="../usermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a>
</li>
<li><a href="../extending/jmeter_tutorial.pdf">Extending JMeter</a>
</li>
</ul>
<p><strong>Community</strong></p>
<ul>
<li><a href="http://www.apache.org/foundation/getinvolved.html">Get Involved</a>
</li>
<li><a href="../mail.html">Mailing Lists</a>
</li>
<li><a href="../svnindex.html">SVN Repositories</a>
</li>
</ul>
<p><strong>Foundation</strong></p>
<ul>
<li><a href="http://www.apache.org/">ASF</a>
</li>
<li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
</li>
<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
</li>
</ul>
</td>
<td width="80%" align="left" valign="top">
<table>
<tr>
<td bgcolor="#525D76">
<div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div>
</td>
<td bgcolor="#525D76">
<div align="right"><a href="build-db-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
</td>
<td bgcolor="#525D76">
<div align="right"><a href="build-web-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
</td>
</tr>
</table>
<br>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="building"><strong>6. Building an Advanced Web Test Plan</strong></a><a class="sectionlink" href="#building" title="Link to here">&para;</a></font>
</td></tr>
<tr><td>
<blockquote>
<p>
In this section, you will learn how to create advanced
<a href="build-test-plan.html">
Test Plans
</a>
to test a Web site.
</p>
<p>
For an example of a basic Test Plan, see
<a href="build-web-test-plan.html">
Building a Web Test Plan
</a>
.
</p>
</blockquote>
</p>
</td></tr>
<tr><td><br></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="session_url_rewriting"><strong>6.1 Handling User Sessions With URL Rewriting</strong></a><a class="sectionlink" href="#session_url_rewriting" title="Link to here">&para;</a></font>
</td></tr>
<tr><td>
<blockquote>
<p>
If your web application uses URL rewriting rather than cookies to save session information,
then you'll need to do a bit of extra work to test your site.
</p>
<p>
To respond correctly to URL rewriting, JMeter needs to parse the HTML
received from the server and retrieve the unique session ID. Use the appropriate
<a href="../usermanual/component_reference.html#HTTP_URL_Re-writing_Modifier">HTTP URL Re-writing Modifier</a>
to accomplish this. Simply enter the name of your session ID parameter into the modifier, and it
will find it and add it to each request. If the request already has a value, it will be replaced.
If "Cache Session Id?" is checked, then the last found session id will be saved,
and will be used if the previous HTTP sample does not contain a session id.
</p>
<a name="url_rewriting_example"/>
<a class="sectionlink" href="#url_rewriting_example" title="Link to here">&para;</a><p><b>URL Rewriting Example</b></p>
<p>
Download
<a href="../demos/URLRewritingExample.jmx">
this example
</a>
. In Figure 1 is shown a
test plan using URL rewriting. Note that the URL Re-writing modifier is added to the SimpleController,
thus assuring that it will only affect requests under that SimpleController.
</p>
<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/url_rewrite_example_a.png"><br>
<font size="-1">Figure 1 - Test Tree
</font></td></tr></table></p>
<p>
In Figure 2, we see the URL Re-writing modifier GUI, which just has a field for the user to specify
the name of the session ID parameter. There is also a checkbox for indicating that the session ID should
be part of the path (separated by a ";"), rather than a request parameter
</p>
<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/url_rewrite_example_b.png"><br>
<font size="-1">Figure 2 - Request parameters
</font></td></tr></table></p>
</blockquote>
</p>
</td></tr>
<tr><td><br></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="header_manager"><strong>6.2 Using a Header Manager</strong></a><a class="sectionlink" href="#header_manager" title="Link to here">&para;</a></font>
</td></tr>
<tr><td>
<blockquote>
<p>
The
<a href="../usermanual/component_reference.html#HTTP_Header_Manager">HTTP Header Manager</a>
lets you customize what information
JMeter sends in the HTTP request header. This header includes properties like "User-Agent",
"Pragma", "Referer", etc.
</p>
<p>
The
<a href="../usermanual/component_reference.html#HTTP_Header_Manager">HTTP Header Manager</a>
, like the
<a href="../usermanual/component_reference.html#HTTP_Cookie_Manager">HTTP Cookie Manager</a>
,
should probably be added at the Thread Group level, unless for some reason you wish to
specify different headers for the different
<a href="../usermanual/component_reference.html#HTTP_Request">HTTP Request</a>
objects in
your test.
</p>
</blockquote>
</p>
</td></tr>
<tr><td><br></td></tr>
</table>
<table>
<tr>
<td bgcolor="#525D76">
<div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div>
</td>
<td bgcolor="#525D76">
<div align="right"><a href="build-db-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
</td>
<td bgcolor="#525D76">
<div align="right"><a href="build-web-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
</td>
</tr>
</table>
<br>
</td>
</tr>
<tr><td colspan="2">
<hr noshade size="1"/>
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
Copyright &copy; 1999-2012, Apache Software Foundation
</em></font></div>
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1">
Apache, Apache JMeter, JMeter, the Apache feather, and the Apache JMeter logo are
trademarks of the Apache Software Foundation.
</font>
</div>
</td></tr>
</table>
</body>
</html>
<!-- end the processing -->