mstover1 02/02/21 05:44:48 Added: docs/usermanual component_reference.html Log: Updating documentation Revision Changes Path 1.1 jakarta-jmeter/docs/usermanual/component_reference.html Index: component_reference.html =================================================================== <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> <!-- Content Stylesheet for Site --> <!-- start the processing --> <!-- ====================================================================== --> <!-- Main Page Section --> <!-- ====================================================================== --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/> <title>JMeter - User's Manual: Generative Controllers</title> </head> <body bgcolor="#ffffff" text="#000000" link="#525D76"> <table border="0" width="100%" cellspacing="0"> <!-- TOP IMAGE --> <tr> <td colspan="2"> <a href="http://jakarta.apache.org";><img src="http://jakarta.apache.org/images/jakarta-logo.gif"; align="left" 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="http://jakarta.apache.org/builds/jakarta-jmeter/";>Download</a> </li> <li> <a href="../installing.html">Install</a> </li> <li> <a href="../running.html">Running</a> </li> <li> <a href="../extending/index.html">Extending</a> </li> <li> <a href="../changes.html">Changes</a> </li> <li> <a href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=JMeter&short_desc=&short_desc_type=substring&long_desc=&long_desc_type=substring&bug_file_loc=&bug_file_loc_type=substring&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&cmdtype=doit&order=Reuse+same+sort+as+last+time";>Known Bugs</a> </li> <li> <a href="../license.html">License</a> </li> <li> <a href="../todo.html">TODO</a> </li> </ul> <p><strong>User Manual</strong></p> <ul> <li> <a href="../usermanual/index.html">Table of Contents</a> </li> <li> <a href="../usermanual/intro.html">Introduction</a> </li> <li> <a href="../usermanual/get-started.html">Getting Started</a> </li> <li> <a href="../usermanual/build-test-plan.html">Building a Test Plan</a> </li> <li> <a href="../usermanual/thread-group.html">Test Plan - Thread Group</a> </li> <li> <a href="../usermanual/controller.html">Test Plan - Controllers</a> </li> <li> <a href="../usermanual/listener.html">Test Plan - Listeners</a> </li> <li> <a href="../usermanual/timer.html">Test Plan - Timers</a> </li> <li> <a href="../usermanual/assertion.html">Test Plan - Assertions</a> </li> <li> <a href="../usermanual/ftp-config.html">Test Plan - FTP Config</a> </li> <li> <a href="../usermanual/http-config.html">Test Plan - HTTP Config</a> </li> <li> <a href="../usermanual/jdbc-config.html">Test Plan - JDBC Config</a> </li> <li> <a href="../usermanual/build-web-test-plan.html">Building a Web Test Plan</a> </li> <li> <a href="../usermanual/build-adv-web-test-plan.html">Building an Adv. Web Test Plan</a> </li> <li> <a href="../usermanual/build-db-test-plan.html">Building a Database Test Plan</a> </li> <li> <a href="../usermanual/build-ftp-test-plan.html">Building a FTP Test Plan</a> </li> <li> <a href="../usermanual/remote-test.html">Remote Testing</a> </li> <li> <a href="../usermanual/best-practices.html">Best Practices</a> </li> </ul> <p><strong>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> </ul> </td> <td width="80%" align="left" valign="top"> <table border="0" cellspacing="0" cellpadding="2" width="100%"> <tr><td bgcolor="#525D76"> <font color="#ffffff" face="arial,helvetica,sanserif"> <a name="$section.getAttributeValue("anchor")"><strong>12. Component Reference</strong></a> </font> </td></tr> <tr><td> <blockquote> </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="ftp_request"><strong>4.2.1.1 FTP Request</strong></a> </font> </td></tr> <tr><td> <blockquote> <p>This controller lets you send an FTP "retrieve file" request to an FTP server. If you are going to send multiple requests to the same FTP server, consider using a <a href="ftp-config.html#request_defaults">FTP Request Defaults</a> Configuration Element so you do not have to enter the same information for each FTP Request Generative Controller. </p> <p><img src="../images/screenshots/gen-controller/ftp-request.gif" width="407" height="238" /></p> <p><b>Property Descriptions:</b> <ul> <li><b>Name</b> - Descriptive name for this controller that is shown in the tree. </li> <li><b>Server Name or IP</b> - Domain name or IP address of the FTP server. JMeter assumes the FTP server is listening on the default port.</li> <li><b>File to Retrieve From Server</b> - Path and name of the file to retrieve.</li> <li><i>Login Configuration</i></li> <ul> <li><b>Username</b> - FTP account username.</li> <li><b>Password</b> - FTP account password.</li> </ul> </ul> </p> <p><b>See Also:</b> <br /><a href="assertion.html">Assertion</a>, <a href="ftp-config.html#request_defaults">FTP Request Defaults</a>, <a href="build-ftp-test-plan.html">Building an FTP 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="http_request"><strong>4.2.1.2 HTTP Request</strong></a> </font> </td></tr> <tr><td> <blockquote> <p>This controller lets you send an HTTP/HTTPS request to a web server. It also lets you control whether or not JMeter parses HTML files for images and Java applets and sends HTTP requests to retrieve them.</p> <p>If you are going to send multiple requests to the same web server, consider using an <a href="http-config.html#request_defaults">HTTP Request Defaults</a> Configuration Element so you do not have to enter the same information for each HTTP Request controller.</p> <p>Or, instead of manually adding HTTP Request controllers, you may want to use JMeter's <a href="http-config.html#proxy_server">HTTP Proxy Server</a> to create them. This can save you time if you have a lot of HTTP requests or requests with many parameters.</p> <p>If the request requires a login authorization, you will also have to add an <a href="http-config.html#auth_manager">HTTP Authorization Manager</a> Configuration Element. And, if the request uses cookies, then you will also need an <a href="http-config.html#cookie_manager">HTTP Cookie Manager</a>. You can add either of these elements to the Thread Group or the HTTP Request. If you have more than one HTTP Request that needs authorizations or cookies, then add the elements to the Thread Group. That way, all HTTP Request controllers will share the same Authorization Manager and Cookie Manager elements.</p> <p>If the request uses a technique called "URL Rewriting" to maintain sessions, then see section <a href="build-adv-web-test-plan.html#url_rewriting">6.x HTTP Requests and Session ID's: URL Rewriting</a> for additional configuration steps.</p> <p><img src="../images/screenshots/gen-controller/http-request.gif" width="562" height="635" /></p> <p><b>Property Descriptions:</b> <ul> <li><b>Name</b> - Descriptive name for this controller that is shown in the tree. </li> <li><i>Web Server</i></li> <ul> <li><b>Server</b> - Domain name or IP address of the web server.</li> <li><b>Port</b> - (optional) Port the web server is listening. If you leave this field empty, JMeter assumes the default port.</li> </ul> <li><i>HTTP Request</i></li> <ul> <li><b>Protocol</b> - HTTP or HTTPS.</li> <li><b>Method</b> - HTTP GET or HTTP POST.</li> <li><b>Path</b> - The path to resource (for example, /servlets/myServlet). If the resource requires query string parameters, add them below in the "Send Parameters With the Request" section.</li> <li><i>Send Parameters With the Request</i></li> <ul> <li><b>Name</b> - Parameter name</li> <li><b>Value</b> - Parameter value. You do not have to enter the value in URL-Encoded format. JMeter will URL-Encode it for you when it sends the HTTP request.</li> <li><b>Add</b> Button - Add a parameter.</li> <li><b>Delete</b> Button - Delete the currently selected parameter.</li> </ul> <li><i>Send a File With the Request</i></li> <ul> <li><b>Filename</b> - Name of the file to send.</li> <li><b>Browse</b> Button - Select this button to browse the file system for a filename.</li> <li><b>Parameter Name</b> - Name of the parameter.</li> <li><b>MIME Type</b> - MIME type (for example, text/plain).</li> </ul> </ul> <li><i>Optional Tasks</i></li> <ul> <li><b>Retrieve All Images and Java Applets</b> - Tell JMeter to parse the HTML file and send HTTP/HTTPS requests for all images and Java applets referenced in the file.</li> </ul> </ul> </p> <p><b>See Also:</b> <br /> <a href="assertion.html">Assertion</a>, <a href="build-web-test-plan.html">Building a Web Test Plan</a>, <a href="build-adv-web-test-plan.html">Building an Advanced Web Test Plan</a>, <a href="http-config.html#auth_manager">HTTP Authorization Manager</a>, <a href="http-config.html#cookie_manager">HTTP Cookie Manager</a>, <a href="http-config.html#header_manager">HTTP Header Manager</a>, <a href="http-config.html#html_link_parser">HTTP HTML Link Parser</a>, <a href="http-config.html#proxy_server">HTTP Proxy Server</a>, <a href="http-config.html#request_defaults">HTTP Request Defaults</a>, <a href="build-adv-web-test-plan.html#url_rewriting">HTTP Requests and Session ID's: URL Rewriting</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="jdbc_request"><strong>4.2.1.3 JDBC Request</strong></a> </font> </td></tr> <tr><td> <blockquote> <p>This controller lets you send an JDBC Request (an SQL query) to a database.</p> <p>If you are going to send multiple requests to the same database, consider using one or more of the Defaults Configuration Elements: <a href="jdbc-config.html#login">Login</a>, <a href="jdbc-config.html#conn_pool">Connection Pool</a>, <a href="jdbc-config.html#sql_query">SQL Query</a>. This way, you do not have to enter the same information for each JDBC Request controller.</p> <p><img src="../images/screenshots/gen-controller/jdbc-request.gif" width="466" height="454" /></p> <p><b>Property Descriptions:</b> <ul> <li><b>Name</b> - Descriptive name for this controller that is shown in the tree. </li> <li><i>Database URL and JDBC Driver</i></li> <ul> <li><b>JDBC URL</b> - URL of the database (for example, "jdbc:weblogic:oracle"). Refer to your database's JDBC documentation for the URL you should use.</li> <li><b>Driver Class</b> - The database driver Java class (for example, "weblogic.jdbc.oci.Driver"). Refer to your database's JDBC documentation for the name of the JDBC driver class you should use.</li> </ul> <li><i>Login Configuration</i></li> <ul> <li><b>Username</b> - FTP account username.</li> <li><b>Password</b> - FTP account password.</li> </ul> <li><i>Database Connection Pool</i></li> <ul> <li><b>Number of Connections in Pool</b> - Number of database connection instances to create and keep active. The maximum value depends on your database. Also, JMeter imposes a maximum of 100 connections.</li> <li><b>Max Usage For Each Connection</b> - Maximum number of times JMeter uses a database connection instance before recycling it (destroying and creating a new instance).</li> </ul> <li><b>SQL Query String</b> - SQL query (for example, "select * from t_customers").</li> </ul> </p> <p><b>See Also:</b> <br /> <a href="assertion.html">Assertion</a>, <a href="build-db-test-plan.html">Building a Database Test Plan</a>, <a href="jdbc-config.html#login">JDBC Database Login Defaults</a>, <a href="jdbc-config.html#conn_pool">JDBC Database Connection Pool Defaults</a>, <a href="jdbc-config.html#sql_query">JDBC SQL Query Defaults</a> </p> </blockquote> </p> </td></tr> <tr><td><br/></td></tr> </table> </td> </tr> <!-- FOOTER --> <tr><td colspan="2"> <hr noshade="" size="1"/> </td></tr> <tr><td colspan="2"> <div align="center"><font color="#525D76" size="-1"><em> Copyright © 1999-2001, Apache Software Foundation </em></font></div> </td></tr> </table> </body> </html> <!-- end the processing -->
-- To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
![http://jakarta.apache.org/images/jakarta-logo.gif"](http://jakarta.apache.org/images/jakarta-logo.gif"){kind=link}