org.safs.android.engine.processor

Class DriverProcessor

java.lang.Object

com.jayway.android.robotium.remotecontrol.client.processor.AbstractProcessor

org.safs.android.engine.processor.SAFSProcessor

org.safs.android.engine.processor.DriverProcessor

All Implemented Interfaces:

CacheReferenceInterface, ProcessorInterface

public class DriverProcessor
extends SAFSProcessor
implements CacheReferenceInterface

Author:

Carl Nagle, SAS Institute, Inc

Field Summary

Fields

Modifier and Type	Field and Description
boolean	chainedSolo set to true by internal processes when SoloProcessor has been chained.
(package private) java.lang.String	debugPrefix

Fields inherited from class org.safs.android.engine.processor.SAFSProcessor

command_timeout, compname, compobj, comprec, dgcd, dgov, inst, KEY_COMPOBJ, params, resourceDetailMsg, resourceMsg, robot, secsWaitForComponent, secsWaitForWindow, solo, TAG, testObjectCache, testrunner, winname, winobj, winrec

Fields inherited from class com.jayway.android.robotium.remotecontrol.client.processor.AbstractProcessor

INITIAL_CACHE_SIZE, remoteCommand, testRunner

Constructor Summary

Constructors

Constructor and Description
DriverProcessor(DSAFSTestRunner testrunner)

Method Summary

Modifier and Type	Method and Description
(package private) void	_hideSoftKeyboard(java.util.Properties props) Hide the soft keyboard.
(package private) void	_showSoftKeyboard(java.util.Properties props) Show the soft keyboard.
(package private) void	_takeScreenShot(java.util.Properties props) The screenshot of the device will be got through AndroidDebugBridge at the remote-control computer Here, this method will only return the rotation of the device. As the image got by AndroidDebugBridge is always that you put your device with default direction. If you rotate you device, that returned image will be upside down, left-turned or right-turned. So we need this device rotation to rotate the image back
void	addCacheReferenceInterface(CacheReferenceInterface cache) CacheReferenceInterface implementation.
void	clearCache(boolean useChain) CacheReferenceInterface implementation.
java.lang.Object	getCachedObject(java.lang.String key, boolean useChain) CacheReferenceInterface implementation.
(package private) boolean	isGuiDriverCommand()
MessageResult	processMessage(java.lang.String message)
void	processProperties(java.util.Properties props) Routes commands appropriately.
void	removeCacheReferenceInterface(CacheReferenceInterface cache) CacheReferenceInterface implementation.

Methods inherited from class org.safs.android.engine.processor.SAFSProcessor

clearTestObjectCache, extractComponentProperties, getDgcd, getInstrumentation, getParams, getSecsWaitForComponent, getSecsWaitForWindow, getSolo, getTestObject, setDgcd, setGeneralErrorWithBundleMessage, setGeneralSuccessWithBundleMessage, setParams, setSecsWaitForComponent, setSecsWaitForWindow, setSolo, setTestObject

Methods inherited from class com.jayway.android.robotium.remotecontrol.client.processor.AbstractProcessor

convertToKey, convertToKeys, convertToKeys, debug, getCachedItem, getStackTrace, makeUniqueCacheKey, putCachedItem, removeCachedItem, resetExternalModeCache, setGeneralError, setGeneralError, setGeneralErrorWithSpecialInfo, setGeneralErrorWithSpecialInfo, setGeneralSuccess, setGeneralSuccess, setGeneralSuccessWithSpecialInfo, setGeneralWarningWithSpecialInfo, setRemoteCommand, stringIsMatched

Methods inherited from class java.lang.Object

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

Field Detail

debugPrefix

java.lang.String debugPrefix

chainedSolo

public boolean chainedSolo

set to true by internal processes when SoloProcessor has been chained. User can reset to false if they want these internal processes to retry connecting this chain.

Constructor Detail

DriverProcessor

public DriverProcessor(DSAFSTestRunner testrunner)

Method Detail

isGuiDriverCommand

boolean isGuiDriverCommand()

Returns:

True if remoteCommand is a DriverCommand referencing a GUI object.

processProperties

public void processProperties(java.util.Properties props)

Routes commands appropriately. Now supports searching EngineProcessor and SoloProcessor object caches along with standard recognition strings.

Specified by:

processProperties in interface ProcessorInterface

Overrides:

processProperties in class AbstractProcessor

See Also:

ProcessorInterface.processProperties(Properties)

_takeScreenShot

void _takeScreenShot(java.util.Properties props)

The screenshot of the device will be got through AndroidDebugBridge at the remote-control computer
Here, this method will only return the rotation of the device.
As the image got by AndroidDebugBridge is always that you put your device with default direction.
If you rotate you device, that returned image will be upside down, left-turned or right-turned.
So we need this device rotation to rotate the image back

_hideSoftKeyboard

void _hideSoftKeyboard(java.util.Properties props)

Hide the soft keyboard.

_showSoftKeyboard

void _showSoftKeyboard(java.util.Properties props)

Show the soft keyboard.

processMessage

public MessageResult processMessage(java.lang.String message)

Specified by:

processMessage in interface ProcessorInterface

Overrides:

processMessage in class AbstractProcessor

See Also:

ProcessorInterface.processMessage(String)

getCachedObject

public java.lang.Object getCachedObject(java.lang.String key,
                                        boolean useChain)

CacheReferenceInterface implementation.

Specified by:

getCachedObject in interface CacheReferenceInterface

Parameters:

key - -- String key for identifying the object stored in cache.

useChain - -- true if the instance should search in all chained caches, false if only the individual local cache should be searched.

Returns:

-- the object stored in cache identified by the key, or null if not found.

addCacheReferenceInterface

public void addCacheReferenceInterface(CacheReferenceInterface cache)

CacheReferenceInterface implementation.

Specified by:

addCacheReferenceInterface in interface CacheReferenceInterface

See Also:

CacheReferenceInterface.addCacheReferenceInterface(CacheReferenceInterface)

removeCacheReferenceInterface

public void removeCacheReferenceInterface(CacheReferenceInterface cache)

CacheReferenceInterface implementation.

Specified by:

removeCacheReferenceInterface in interface CacheReferenceInterface

See Also:

CacheReferenceInterface.removeCacheReferenceInterface(CacheReferenceInterface)

clearCache

public void clearCache(boolean useChain)

CacheReferenceInterface implementation.

Specified by:

clearCache in interface CacheReferenceInterface

Parameters:

useChain - -- true if the instance should clear all chained caches, false if only the individual local cache should be cleared.

See Also:

CacheReferenceInterface.clearCache(boolean)