You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jmeter.apache.org by fs...@apache.org on 2014/11/23 11:33:17 UTC
svn commit: r1641171 - in /jmeter/trunk/src/components/org/apache/jmeter:
assertions/gui/ control/ extractor/
Author: fschumacher
Date: Sun Nov 23 10:33:16 2014
New Revision: 1641171
URL: http://svn.apache.org/r1641171
Log:
Bug 57193: Add param and return tags to javadoc
Bugzilla Id: 57193
Modified:
jmeter/trunk/src/components/org/apache/jmeter/assertions/gui/HTMLAssertionGui.java
jmeter/trunk/src/components/org/apache/jmeter/assertions/gui/SizeAssertionGui.java
jmeter/trunk/src/components/org/apache/jmeter/assertions/gui/XPathPanel.java
jmeter/trunk/src/components/org/apache/jmeter/control/CriticalSectionController.java
jmeter/trunk/src/components/org/apache/jmeter/control/IncludeController.java
jmeter/trunk/src/components/org/apache/jmeter/control/ModuleController.java
jmeter/trunk/src/components/org/apache/jmeter/extractor/HtmlExtractor.java
jmeter/trunk/src/components/org/apache/jmeter/extractor/RegexExtractor.java
Modified: jmeter/trunk/src/components/org/apache/jmeter/assertions/gui/HTMLAssertionGui.java
URL: http://svn.apache.org/viewvc/jmeter/trunk/src/components/org/apache/jmeter/assertions/gui/HTMLAssertionGui.java?rev=1641171&r1=1641170&r2=1641171&view=diff
==============================================================================
--- jmeter/trunk/src/components/org/apache/jmeter/assertions/gui/HTMLAssertionGui.java (original)
+++ jmeter/trunk/src/components/org/apache/jmeter/assertions/gui/HTMLAssertionGui.java Sun Nov 23 10:33:16 2014
@@ -149,6 +149,7 @@ public class HTMLAssertionGui extends Ab
/**
* Implements JMeterGUIComponent.clearGui
+ * {@inheritDoc}
*/
@Override
public void clearGui() {
@@ -166,8 +167,7 @@ public class HTMLAssertionGui extends Ab
/**
* Configures the associated test element.
- *
- * @param inElement
+ * {@inheritDoc}
*/
@Override
public void configure(TestElement inElement) {
@@ -265,7 +265,7 @@ public class HTMLAssertionGui extends Ab
/**
* This method is called if one of the threshold field looses the focus
*
- * @param inEvent
+ * @param inEvent The {@link FocusEvent} with detailed information about the focus loss
*/
public void focusLost(FocusEvent inEvent) {
log.debug("HTMLAssertionGui.focusLost() called");
@@ -308,6 +308,9 @@ public class HTMLAssertionGui extends Ab
}
/**
+ * Method gets called when one of the threshold fields gains focus
+ *
+ * @param e The {@link FocusEvent} with detailed information about the focus gain
* @see java.awt.event.FocusListener#focusGained(java.awt.event.FocusEvent)
*/
public void focusGained(FocusEvent e) {
Modified: jmeter/trunk/src/components/org/apache/jmeter/assertions/gui/SizeAssertionGui.java
URL: http://svn.apache.org/viewvc/jmeter/trunk/src/components/org/apache/jmeter/assertions/gui/SizeAssertionGui.java?rev=1641171&r1=1641170&r2=1641171&view=diff
==============================================================================
--- jmeter/trunk/src/components/org/apache/jmeter/assertions/gui/SizeAssertionGui.java (original)
+++ jmeter/trunk/src/components/org/apache/jmeter/assertions/gui/SizeAssertionGui.java Sun Nov 23 10:33:16 2014
@@ -63,6 +63,9 @@ public class SizeAssertionGui extends Ab
private int execState; // store the operator
+ /**
+ * Simple Constructor which initializes the gui component
+ */
public SizeAssertionGui() {
init();
}
@@ -150,7 +153,18 @@ public class SizeAssertionGui extends Ab
}
/**
- * Set the state of the radio Button
+ * Set the state of the radio Button.
+ * <p>
+ * Allowed states are
+ * <ul>
+ * <li>{@link SizeAssertion#EQUAL}</li>
+ * <li>{@link SizeAssertion#NOTEQUAL}</li>
+ * <li>{@link SizeAssertion#GREATERTHAN}</li>
+ * <li>{@link SizeAssertion#LESSTHAN}</li>
+ * <li>{@link SizeAssertion#GREATERTHANEQUAL}</li>
+ * <li>{@link SizeAssertion#LESSTHANEQUAL}</li>
+ * </ul>
+ * @param state One of the allowed states
*/
public void setState(int state) {
if (state == SizeAssertion.EQUAL) {
@@ -176,6 +190,17 @@ public class SizeAssertionGui extends Ab
/**
* Get the state of the radio Button
+ * <p>
+ * Possible states are
+ * <ul>
+ * <li>{@link SizeAssertion#EQUAL}</li>
+ * <li>{@link SizeAssertion#NOTEQUAL}</li>
+ * <li>{@link SizeAssertion#GREATERTHAN}</li>
+ * <li>{@link SizeAssertion#LESSTHAN}</li>
+ * <li>{@link SizeAssertion#GREATERTHANEQUAL}</li>
+ * <li>{@link SizeAssertion#LESSTHANEQUAL}</li>
+ * </ul>
+ * @return The current state of the radio Button
*/
public int getState() {
return execState;
Modified: jmeter/trunk/src/components/org/apache/jmeter/assertions/gui/XPathPanel.java
URL: http://svn.apache.org/viewvc/jmeter/trunk/src/components/org/apache/jmeter/assertions/gui/XPathPanel.java?rev=1641171&r1=1641170&r2=1641171&view=diff
==============================================================================
--- jmeter/trunk/src/components/org/apache/jmeter/assertions/gui/XPathPanel.java (original)
+++ jmeter/trunk/src/components/org/apache/jmeter/assertions/gui/XPathPanel.java Sun Nov 23 10:33:16 2014
@@ -38,6 +38,10 @@ import org.apache.log.Logger;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
+/**
+ * Gui component for representing a xpath expression
+ *
+ */
public class XPathPanel extends JPanel {
private static final long serialVersionUID = 240L;
@@ -74,6 +78,9 @@ public class XPathPanel extends JPanel {
setDefaultValues();
}
+ /**
+ * Set default values on this component
+ */
public void setDefaultValues() {
setXPath("/"); //$NON-NLS-1$
setNegated(false);
@@ -91,7 +98,7 @@ public class XPathPanel extends JPanel {
/**
* Set the string that will be used in the xpath evaluation
*
- * @param xpath
+ * @param xpath The string representing the xpath expression
*/
public void setXPath(String xpath) {
this.xpath.setInitialText(xpath);
@@ -109,7 +116,7 @@ public class XPathPanel extends JPanel {
/**
* Set this to true, if you want success when the xpath does not match.
*
- * @param negated
+ * @param negated Flag whether xpath match should be negated
*/
public void setNegated(boolean negated) {
this.negated.setSelected(negated);
@@ -146,6 +153,12 @@ public class XPathPanel extends JPanel {
return checkXPath;
}
+ /**
+ * Returns the current {@link JSyntaxTextArea} for the xpath expression, or
+ * creates a new one, if none is found.
+ *
+ * @return {@link JSyntaxTextArea} for the xpath expression
+ */
public JSyntaxTextArea getXPathField() {
if (xpath == null) {
xpath = new JSyntaxTextArea(20, 80);
Modified: jmeter/trunk/src/components/org/apache/jmeter/control/CriticalSectionController.java
URL: http://svn.apache.org/viewvc/jmeter/trunk/src/components/org/apache/jmeter/control/CriticalSectionController.java?rev=1641171&r1=1641170&r2=1641171&view=diff
==============================================================================
--- jmeter/trunk/src/components/org/apache/jmeter/control/CriticalSectionController.java (original)
+++ jmeter/trunk/src/components/org/apache/jmeter/control/CriticalSectionController.java Sun Nov 23 10:33:16 2014
@@ -83,6 +83,7 @@ public class CriticalSectionController e
/**
* constructor
+ * @param name The name of this controller
*/
public CriticalSectionController(String name) {
super();
@@ -91,6 +92,7 @@ public class CriticalSectionController e
/**
* Condition Accessor - this is gonna be any string value
+ * @param name The name of the lock for this controller
*/
public void setLockName(String name) {
setProperty(new StringProperty(LOCK_NAME, name));
Modified: jmeter/trunk/src/components/org/apache/jmeter/control/IncludeController.java
URL: http://svn.apache.org/viewvc/jmeter/trunk/src/components/org/apache/jmeter/control/IncludeController.java?rev=1641171&r1=1641170&r2=1641171&view=diff
==============================================================================
--- jmeter/trunk/src/components/org/apache/jmeter/control/IncludeController.java (original)
+++ jmeter/trunk/src/components/org/apache/jmeter/control/IncludeController.java Sun Nov 23 10:33:16 2014
@@ -84,7 +84,7 @@ public class IncludeController extends G
/**
* In the event an user wants to include an external JMX test plan
* the GUI would call this.
- * @param jmxfile
+ * @param jmxfile The path to the JMX test plan to include
*/
public void setIncludePath(String jmxfile) {
this.setProperty(INCLUDE_PATH,jmxfile);
Modified: jmeter/trunk/src/components/org/apache/jmeter/control/ModuleController.java
URL: http://svn.apache.org/viewvc/jmeter/trunk/src/components/org/apache/jmeter/control/ModuleController.java?rev=1641171&r1=1641170&r2=1641171&view=diff
==============================================================================
--- jmeter/trunk/src/components/org/apache/jmeter/control/ModuleController.java (original)
+++ jmeter/trunk/src/components/org/apache/jmeter/control/ModuleController.java Sun Nov 23 10:33:16 2014
@@ -128,8 +128,7 @@ public class ModuleController extends Ge
}
/**
- * Compute the replacement tree.
- * @param context
+ * {@inheritDoc}
*/
@Override
public void resolveReplacementSubTree(JMeterTreeNode context) {
@@ -159,8 +158,7 @@ public class ModuleController extends Ge
}
/**
- * Copies the controller's subelements into the execution tree
- *
+ * {@inheritDoc}
*/
@Override
public HashTree getReplacementSubTree() {
Modified: jmeter/trunk/src/components/org/apache/jmeter/extractor/HtmlExtractor.java
URL: http://svn.apache.org/viewvc/jmeter/trunk/src/components/org/apache/jmeter/extractor/HtmlExtractor.java?rev=1641171&r1=1641170&r2=1641171&view=diff
==============================================================================
--- jmeter/trunk/src/components/org/apache/jmeter/extractor/HtmlExtractor.java (original)
+++ jmeter/trunk/src/components/org/apache/jmeter/extractor/HtmlExtractor.java Sun Nov 23 10:33:16 2014
@@ -43,6 +43,10 @@ public class HtmlExtractor extends Abstr
public static final String EXTRACTOR_JODD = "JODD"; //$NON-NLS-1$
+ /**
+ * Get the possible extractor implementations
+ * @return Array containing the names of the possible extractors.
+ */
public static String[] getImplementations(){
return new String[]{EXTRACTOR_JSOUP,EXTRACTOR_JODD};
}
@@ -232,10 +236,21 @@ public class HtmlExtractor extends Abstr
}
+ /**
+ * Set the extractor. Has to be one of the list that can be obtained by
+ * {@link HtmlExtractor#getImplementations()}
+ *
+ * @param attribute
+ * The name of the extractor to be used
+ */
public void setExtractor(String attribute) {
setProperty(EXTRACTOR_IMPL, attribute);
}
+ /**
+ * Get the name of the currently configured extractor
+ * @return The name of the extractor currently used
+ */
public String getExtractor() {
return getPropertyAsString(EXTRACTOR_IMPL); // $NON-NLS-1$
}
@@ -267,9 +282,9 @@ public class HtmlExtractor extends Abstr
/**
* Set which Match to use. This can be any positive number, indicating the
- * exact match to use, or 0, which is interpreted as meaning random.
+ * exact match to use, or <code>0</code>, which is interpreted as meaning random.
*
- * @param matchNumber
+ * @param matchNumber The number of the match to be used
*/
public void setMatchNumber(int matchNumber) {
setProperty(new IntegerProperty(MATCH_NUMBER, matchNumber));
@@ -290,12 +305,16 @@ public class HtmlExtractor extends Abstr
/**
* Sets the value of the variable if no matches are found
*
- * @param defaultValue
+ * @param defaultValue The default value for the variable
*/
public void setDefaultValue(String defaultValue) {
setProperty(DEFAULT, defaultValue);
}
+ /**
+ * Get the default value for the variable if no matches are found
+ * @return The default value for the variable
+ */
public String getDefaultValue() {
return getPropertyAsString(DEFAULT);
}
Modified: jmeter/trunk/src/components/org/apache/jmeter/extractor/RegexExtractor.java
URL: http://svn.apache.org/viewvc/jmeter/trunk/src/components/org/apache/jmeter/extractor/RegexExtractor.java?rev=1641171&r1=1641170&r2=1641171&view=diff
==============================================================================
--- jmeter/trunk/src/components/org/apache/jmeter/extractor/RegexExtractor.java (original)
+++ jmeter/trunk/src/components/org/apache/jmeter/extractor/RegexExtractor.java Sun Nov 23 10:33:16 2014
@@ -374,27 +374,46 @@ public class RegexExtractor extends Abst
return matches.get(entry - 1);
}
+ /**
+ * Set the regex to be used
+ * @param regex The string representation of the regex
+ */
public void setRegex(String regex) {
setProperty(REGEX, regex);
}
+ /**
+ * Get the regex which is to be used
+ * @return string representing the regex
+ */
public String getRegex() {
return getPropertyAsString(REGEX);
}
+ /**
+ * Set the prefix name of the variable to be used to store the regex matches
+ * @param refName prefix of the variables to be used
+ */
public void setRefName(String refName) {
setProperty(REFNAME, refName);
}
+ /**
+ * Get the prefix name of the variable to be used to store the regex matches
+ * @return The prefix of the variables to be used
+ */
public String getRefName() {
return getPropertyAsString(REFNAME);
}
/**
* Set which Match to use. This can be any positive number, indicating the
- * exact match to use, or 0, which is interpreted as meaning random.
+ * exact match to use, or <code>0</code>, which is interpreted as meaning
+ * random.
*
* @param matchNumber
+ * The number of the match to be used, or <code>0</code> if a
+ * random match should be used.
*/
public void setMatchNumber(int matchNumber) {
setProperty(new IntegerProperty(MATCH_NUMBER, matchNumber));
@@ -415,12 +434,18 @@ public class RegexExtractor extends Abst
/**
* Sets the value of the variable if no matches are found
*
- * @param defaultValue
+ * @param defaultValue The default value for the variable
*/
public void setDefaultValue(String defaultValue) {
setProperty(DEFAULT, defaultValue);
}
+ /**
+ * Get the default value for the variable, which should be used, if no
+ * matches are found
+ *
+ * @return The default value for the variable
+ */
public String getDefaultValue() {
return getPropertyAsString(DEFAULT);
}