org.netbeans.jemmy.util
Class PropChooser

java.lang.Object
  extended by org.netbeans.jemmy.util.PropChooser
All Implemented Interfaces:
ComponentChooser, Outputable
Direct Known Subclasses:
StringPropChooser

public class PropChooser
extends Object
implements ComponentChooser, Outputable

Implementation of org.netbeans.jemmy.ComponentChooser interface. Class can be used to find component by its field/methods values.
Example:

            String[] methods = {"getClientProperty"};
            Object[][] params = {{"classname"}};
            Class[][] classes = {{Object.class}};
            Object[] results = {"javax.swing.JCheckBox"};
 
            JCheckBox box = JCheckBoxOperator.findJCheckBox(frm0, new PropChooser(methods, params, classes, results));
 
Or:
            String[] methods = {"getText"};
            Object[] results = {"Open"};
 
            JButtonOperator box = new JButtonOperator(containerOperator, new PropChooser(fields, results));
 

Author:
Alexandre Iline (alexandre.iline@sun.com)

Field Summary
protected  Class[][] classes
          Classes of parameters.
protected  Object[][] params
          Methods parameters.
protected  String[] propNames
          Names of methods to check.
protected  Object[] results
          Expected results of methods.
 
Constructor Summary
PropChooser(String[] propNames, Object[] results)
          Constructs a PropChooser object for checking of methods with no parameters.
PropChooser(String[] propNames, Object[][] params, Class[][] classes, Object[] results)
          Constructs a PropChooser object.
 
Method Summary
 boolean checkComponent(Component comp)
          Check if the component argument meets the search criteria.
protected  boolean checkProperty(Object value, Object etalon)
          Method to check one method result with an etalon.
 String getDescription()
          Returns searched component description.
 TestOut getOutput()
          Returns print output streams or writers.
 void setOutput(TestOut output)
          Defines print output streams or writers.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

propNames

protected String[] propNames
Names of methods to check.


params

protected Object[][] params
Methods parameters.


classes

protected Class[][] classes
Classes of parameters.


results

protected Object[] results
Expected results of methods.

Constructor Detail

PropChooser

public PropChooser(String[] propNames,
                   Object[][] params,
                   Class[][] classes,
                   Object[] results)
Constructs a PropChooser object.

Parameters:
propNames - Names of methods/fields
params - Parameters values for methods.
params[0] is an array of parameters for propNames[0] methods.
If propNames[0] is a field, params[0] is ignored.
classes - Parameters classes.
results - Objects to compare method/field values to.
A value of propNames[0] method/field should be equal to results[0] object.

PropChooser

public PropChooser(String[] propNames,
                   Object[] results)
Constructs a PropChooser object for checking of methods with no parameters.

Parameters:
propNames - Names of methods/fields
results - Objects to compare method/field values to.
Method Detail

setOutput

public void setOutput(TestOut output)
Description copied from interface: Outputable
Defines print output streams or writers.

Specified by:
setOutput in interface Outputable
Parameters:
output - Identify the streams or writers used for print output.
See Also:
Outputable.getOutput()

getOutput

public TestOut getOutput()
Description copied from interface: Outputable
Returns print output streams or writers.

Specified by:
getOutput in interface Outputable
Returns:
an object that contains references to objects for printing to output and err streams.
See Also:
Outputable.setOutput(org.netbeans.jemmy.TestOut)

checkComponent

public boolean checkComponent(Component comp)
Description copied from interface: ComponentChooser
Check if the component argument meets the search criteria.

Specified by:
checkComponent in interface ComponentChooser
Parameters:
comp - Component to check.
Returns:
true when the component conforms to the search criteria; false otherwise.

getDescription

public String getDescription()
Description copied from interface: ComponentChooser
Returns searched component description.

Specified by:
getDescription in interface ComponentChooser
Returns:
a String representing the description value

checkProperty

protected boolean checkProperty(Object value,
                                Object etalon)
Method to check one method result with an etalon. Can be overrided by a subclass.

Parameters:
value - Method/field value
etalon - Object to compare to.
Returns:
true if the value matches the etalon.