com.jayway.android.robotium.remotecontrol

Class Condition

java.lang.Object

com.jayway.android.robotium.remotecontrol.Condition

All Implemented Interfaces:

Condition, java.io.Serializable

public abstract class Condition
extends java.lang.Object
implements Condition, java.io.Serializable

From release 5.0.1, Robotium changes support to use com.robotium.solo.Condition as
parameter. To support this kind of APIs, this class was created. This class implements interface Serializable
so that it can be transported as an object thru our TCP protocol. This class also implements interface
com.robotium.solo.Condition so that it can be used directly by Robotium's APIs.
Example of usage:
At controller side, user can create a concrete class of Condition like following:

        public class MyCondition extends Condition{
                public boolean isSatisfied() {
                        boolean satisfied = true;
                        try{
                                List<Object> views = this.getObjects();
                                //The first object is reserved by TestRunner object
                                //RobotiumTestRunner runner = (RobotiumTestRunner) views.get(0);
                                //Solo solo = runner.getSolo();
                                
                                //From 1, they are View objects
                                for(int i=1;i<views.size();i++){
                                        satisfied = satisfied && ((View) views.get(i)).isShown();
                                }
                        }catch(Exception e){
                                e.printStackTrace();
                                satisfied = false;
                        }
                        return satisfied;
                }
        }
 

The class MyCondition needs to be put into the TestRunner project. The TestRunner project
should be rebuilt
Then, user can simply create an instance 'condition' of class MyCondition and call it's method
addObjects(List)/addObject(Object) to add the view's UID.
For example:

        private void testWaitForCondition(){
                try {
                        Condition condition = new MyCondition();
                        List listviews = solo.getCurrentListViews();
                        condition.addObjects(listviews);
                        boolean isSatisfied = solo.waitForCondition(condition, 10);
                        System.out.println("waitForCondition  isSatisfied: " + isSatisfied);
                } catch (Exception e1) {
                        e1.printStackTrace();
                }
        }
 

At the device side, we receive that object 'condition', which can be used by Robotium's APIs.

This class implements com.robotium.solo.Condition, if that interface is modified, we needs
to update this class also.

Since:

May 14, 2013

Author:

Lei Wang, SAS Institute, Inc

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
(package private) java.util.List<java.lang.Object>	objects This field is also used to transport view's UID from controller to device. At the controller side, we put the views' UID into the list objects At the device side, we get the real instance of View from cache and replace the UID so that the list objects will contain instances of View. The first object is an instance of class AbstractTestRunner.

Constructor Summary

Constructors

Constructor and Description
Condition()

Method Summary

Modifier and Type	Method and Description
void	addObject(java.lang.Object object) Append an object to the list objects.
void	addObject(java.lang.Object object, boolean asFirstItem) Add an object to the list objects.
void	addObjects(java.util.List<java.lang.Object> objects) Append all objects to the existing list objects
java.util.List<java.lang.Object>	getObjects()
abstract boolean	isSatisfied() Should do the necessary work needed to check a condition and then return whether this condition is satisfied or not.
void	setObject(java.lang.Object object, int index) Replace the existing object in the list objects
void	setObjects(java.util.List<java.lang.Object> objects)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

objects

java.util.List<java.lang.Object> objects

This field is also used to transport view's UID from controller to device.
At the controller side, we put the views' UID into the list objects
At the device side, we get the real instance of View from cache and replace the UID
so that the list objects will contain instances of View.
The first object is an instance of class AbstractTestRunner.

See Also:

AbstractTestRunner, View

Constructor Detail

Condition

public Condition()

Method Detail

isSatisfied

public abstract boolean isSatisfied()

Should do the necessary work needed to check a condition and then return whether this condition is satisfied or not.

Specified by:

isSatisfied in interface Condition

Returns:

true if condition is satisfied and false if it is not satisfied

getObjects

public java.util.List<java.lang.Object> getObjects()

setObjects

public void setObjects(java.util.List<java.lang.Object> objects)

addObjects

public void addObjects(java.util.List<java.lang.Object> objects)

Append all objects to the existing list objects

addObject

public void addObject(java.lang.Object object)

Append an object to the list objects.

See Also:

addObject(Object, boolean)

addObject

public void addObject(java.lang.Object object,
                      boolean asFirstItem)

Add an object to the list objects.

Parameters:

object - Object, to be added to the list objects

asFirstItem - boolean, if we add the object as the first item of list.

setObject

public void setObject(java.lang.Object object,
                      int index)

Replace the existing object in the list objects

Parameters:

object - Object, to set in the list objects.

index - int, the position in list objects to put the new object. if it is bigger than the size of the list objects, nothing will happen.