PropChooser

java.lang.Object
- 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

Fields
Modifier and Type	Field and Description
`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

Constructors
Constructor and Description
`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

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`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.

Class PropChooser

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

propNames

params

classes

results

Constructor Detail

PropChooser

PropChooser

Method Detail

setOutput

getOutput

checkComponent

getDescription

checkProperty