You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jmeter-dev@jakarta.apache.org by se...@apache.org on 2006/03/15 01:30:03 UTC

svn commit: r385940 - in /jakarta/jmeter/branches/rel-2-1/xdocs: changes.xml usermanual/component_reference.xml

Author: sebb
Date: Tue Mar 14 16:30:02 2006
New Revision: 385940

URL: http://svn.apache.org/viewcvs?rev=385940&view=rev
Log:
Add Beanshell documentation for new test elements

Modified:
    jakarta/jmeter/branches/rel-2-1/xdocs/changes.xml
    jakarta/jmeter/branches/rel-2-1/xdocs/usermanual/component_reference.xml

Modified: jakarta/jmeter/branches/rel-2-1/xdocs/changes.xml
URL: http://svn.apache.org/viewcvs/jakarta/jmeter/branches/rel-2-1/xdocs/changes.xml?rev=385940&r1=385939&r2=385940&view=diff
==============================================================================
--- jakarta/jmeter/branches/rel-2-1/xdocs/changes.xml (original)
+++ jakarta/jmeter/branches/rel-2-1/xdocs/changes.xml Tue Mar 14 16:30:02 2006
@@ -17,7 +17,7 @@
 -->
 <document>   
 <properties>     
-	<author email="mstover1@apache.org">Michael Stover, et al.</author>     
+	<author email="jmeter-dev AT jakarta.apache.org">JMeter developers</author>     
 	<title>History of Changes</title>   
 </properties> 
 <body> 
@@ -25,13 +25,12 @@
 <p><b>Changes are chronologically ordered from top (most recent) to bottom 
 (least recent)</b></p>  
 
-<b>Changes: for more info, contact <a href="mailto:mstover1@apache.org">Michael Stover</a></b>
 
 <h3>Version 2.1.2</h3>
 <h4>Incompatible changes:</h4>
 <p>
 The time stamp is now set to start time.
-To revert to the previous behaviour, change the property sampleresult.timestamp.start to false (or comment it)
+To revert to the previous behaviour, change the property <b>sampleresult.timestamp.start</b> to false (or comment it)
 </p>
 <h4>New functionality:</h4>
 <ul>
@@ -52,6 +51,7 @@
 <li>Regular Expression Extractor sets group count</li>
 <li>Can now save entire screen as an image, not just the right-hand pane</li>
 <li>Bug 38901 - Add optional SOAPAction header to SOAP Sampler</li>
+<li>New BeanShell test elements: Timer, PreProcessor, PostProcessor</li>
 </ul>
 
 <h4>Bug fixes:</h4>
@@ -92,8 +92,9 @@
 <li>Updated to HTTPClient 3.0 (from 2.0)</li>
 <li>Updated to Commons Collections 3.1</li>
 <li>Improved formatting of Request Data in Tree View</li>
+<li>Expanded user documentation</li>
 </ul>
-
+<hr/>
 <h3>Version 2.1.1</h3>
 <h4>New functionality:</h4>
 <ul>

Modified: jakarta/jmeter/branches/rel-2-1/xdocs/usermanual/component_reference.xml
URL: http://svn.apache.org/viewcvs/jakarta/jmeter/branches/rel-2-1/xdocs/usermanual/component_reference.xml?rev=385940&r1=385939&r2=385940&view=diff
==============================================================================
--- jakarta/jmeter/branches/rel-2-1/xdocs/usermanual/component_reference.xml (original)
+++ jakarta/jmeter/branches/rel-2-1/xdocs/usermanual/component_reference.xml Tue Mar 14 16:30:02 2006
@@ -2042,9 +2042,11 @@
 pattern. You can attach multiple assertions to any controller for additional flexibility.</p>
 <p>Note that the pattern string should not include the enclosing delimiters, 
 	i.e. use <b>Price: \d+</b> not <b>/Price: \d+/</b>.
+	</p>
+	<p>
 	By default, the pattern is in multi-line mode, which means that the "." meta-character does not match newline.
     In multi-line mode, "^" and "$" match the start or end of any line anywhere within the string 
-    - not just the start and end of the entire string.
+    - not just the start and end of the entire string. Note that \s does match new-line.
 	Case is also significant. To override these settings, one can use the extended regular expression syntax.
 	For example:
 </p>
@@ -2335,6 +2337,27 @@
 
 </component>
 
+<component index="&sect-num;.6.6" name="BeanShell Timer" screenshot="timers/beanshell_timer.png">
+<description>
+<p>
+The BeanShell Timer can be used to generate a delay.
+</p>
+</description>
+<properties>
+        <property name="Name" required="">Descriptive name for this element that is shown in the tree.</property>
+        <property name="Script" required="Yes">
+        The BeanShell script. The return value is used as the number of milliseconds to wait.
+        </property>
+</properties>
+<ul>
+<li>log - (Logger) - can be used to write to the log file</li>
+<li>ctx - (JMeterContext) - gives access to the context</li>
+<li>vars - (JMeterVariables) - gives read/write access to variables: vars.get(key); vars.put(key,val)</li>
+</ul>
+<p>For details of all the methods available on each of the above variables, please check the Javadoc</p>
+<p>If the property <b>beanshell.timer.init</b> is defined, this is used to load an initialisation file.</p>
+</component>
+
 </section>
 
 <section name="&sect-num;.7 Pre Processors" anchor="preprocessors">
@@ -2510,6 +2533,27 @@
 </properties>
 </component>
 
+<component index="&sect-num;.7.7" name="BeanShell PreProcessor" screenshot="beanshell_preprocessor.png">
+<description>
+<p>
+The BeanShell PreProcessor allows arbitrary code to be applied before taking a sample.
+</p>
+</description>
+<properties>
+        <property name="Name" required="">Descriptive name for this element that is shown in the tree.</property>
+        <property name="Script" required="Yes">The BeanShell script. The return value is ignored. See below for variables defined to the script.</property>
+</properties>
+<ul>
+<li>log - (Logger) - can be used to write to the log file</li>
+<li>ctx - (JMeterContext) - gives access to the context</li>
+<li>vars - (JMeterVariables) - gives read/write access to variables: vars.get(key); vars.put(key,val)</li>
+<li>prev - (SampleResult) - gives access to the previous SampleResult (if any)</li>
+<li>sampler - (Sampler)- gives access to the current sampler</li>
+</ul>
+<p>For details of all the methods available on each of the above variables, please check the Javadoc</p>
+<p>If the property <b>beanshell.preprocessor.init</b> is defined, this is used to load an initialisation file.</p>
+</component>
+
 </section>
 
 <section name="&sect-num;.8 Post-Processors" anchor="postprocessors">
@@ -2647,6 +2691,27 @@
  <properties>
  <property name="Name" required="">Descriptive name for this element that is shown in the tree.</property>
  </properties>
+</component>
+
+<component index="&sect-num;.8.6" name="BeanShell PostProcessor"  screenshot="beanshell_postprocessor.png">
+<description>
+<p>
+The BeanShell PreProcessor allows arbitrary code to be applied after taking a sample.
+</p>
+</description>
+<properties>
+        <property name="Name" required="">Descriptive name for this element that is shown in the tree.</property>
+        <property name="Script" required="Yes">The BeanShell script. The return value is ignored. See below for variables defined to the script.</property>
+</properties>
+<ul>
+<li>log - (Logger) - can be used to write to the log file</li>
+<li>ctx - (JMeterContext) - gives access to the context</li>
+<li>vars - (JMeterVariables) - gives read/write access to variables: vars.get(key); vars.put(key,val)</li>
+<li>prev - (SampleResult) - gives access to the previous SampleResult</li>
+<li>data - (byte [])- gives access to the current sample data</li>
+</ul>
+<p>For details of all the methods available on each of the above variables, please check the Javadoc</p>
+<p>If the property <b>beanshell.postprocessor.init</b> is defined, this is used to load an initialisation file.</p>
 </component>
 
 </section>



---------------------------------------------------------------------
To unsubscribe, e-mail: jmeter-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: jmeter-dev-help@jakarta.apache.org