Package com.facilita.fc.eggPlant

Class EggplantVirtualUser

java.lang.Object

com.facilita.fc.runtime.VirtualUser

com.facilita.fc.eggPlant.EggplantVirtualUser

All Implemented Interfaces:

EggplantVirtualUserInterface, com.facilita.fc.runtime.Commands, DataDictionary, com.facilita.fc.runtime.IMonitoredVU, java.lang.Runnable

public class EggplantVirtualUser
extends VirtualUser
implements EggplantVirtualUserInterface

An eggPlant Virtual User. Provides methods to send commands to eggPlant, using eggPlant Drive.

Field Summary

Fields inherited from interface com.facilita.fc.runtime.Commands

ABORT_CMD, cmds, END_CMD, NULL_CMD, RESUME_CMD, SUSPEND_CMD, TERMINATE_CMD

Constructor Summary

Constructors

Constructor	Description
EggplantVirtualUser()	INTERNAL USE ONLY.

Method Summary

Modifier and Type	Method	Description
java.util.List<ConnectionInfo>	AllConnectionInfo()	Get a list of information about all the current connections.
protected void	atEndOfIteration()	This method is called at the end of every iteration.
protected void	atStartOfIteration()	This method is called at the start of every iteration.
void	attachLogMessageSender(com.facilita.fc.runtime.IMessageSender messageSender)	For internal use only.
void	CaptureScreen(java.lang.String name)	Capture an area of screen and save to file.
void	CaptureScreen(java.lang.String name, Rectangle rectangle, boolean increment, ImageInfo imageInfo)	Capture an area of screen and save to file.
void	CaptureTextImage(java.lang.String params)	Capture text image.
void	Click(int x, int y)	Click on a point on the screen.
void	Click(Point point)	Click on a point on the screen.
void	Click(java.lang.String image, java.lang.String... images)	Clicks on an image.
void	CloseSuite(java.lang.String suiteName)	Close an eggPlant suite.
Color	ColorAtLocation(int x, int y)	Get the color at a location.
Color	ColorAtLocation(Point location)	Get the color at a location.
void	Connect(ConnectionProperties connectionProperties)	Connect to the SUT.
void	Connect(java.lang.String name)	Connect to the SUT.
void	Connect(java.lang.String name, int portNum)	Connect to the SUT.
void	Connect(java.lang.String name, int portNum, ConnectionType type, java.lang.String username, java.lang.String password)	Connect to the SUT.
void	Connect(java.lang.String name, int portNum, java.lang.String username, java.lang.String password)	Connect to the SUT.
void	Connect(java.lang.String name, int portNum, java.lang.String username, java.lang.String password, java.lang.String sshHost, java.lang.String sshUser, java.lang.String sshPassword, int colorDepth)	Connect to the SUT.
void	Connect(java.lang.String name, int portNum, java.lang.String username, java.lang.String password, java.lang.String sshHost, java.lang.String sshUser, java.lang.String sshPassword, int colorDepth, ConnectionType type, int height, int width, java.lang.String[] additionalArgs)	Connect to the SUT.
void	Connect(java.lang.String name, ConnectionType type, java.lang.String username, java.lang.String password)	Connect to the SUT.
void	Connect(java.lang.String name, java.lang.String username, java.lang.String password)	Connect to the SUT.
ConnectionInfo	ConnectionInfo(java.lang.String name)	Get connection info for a connection.
void	Disconnect()	Disconnect from the SUT.
void	Disconnect(java.lang.String name)	Disconnect from the SUT.
void	DoubleClick(int x, int y)	Double click a point on the screen.
void	DoubleClick(Point point)	Double click a point on the screen.
void	DoubleClick(java.lang.String image, java.lang.String... images)	Double click on an image.
void	Drag(int x, int y)	Drag a point on the screen.
void	Drag(Point point)	Drag a point on the screen.
void	Drag(java.lang.String image, java.lang.String... images)	Drag an image.
void	DragAndDrop(Point start, Point... subsequent)	Drag and drop from one point to another.
void	DragAndDrop(java.lang.String image1, java.lang.String image2, java.lang.String... subsequent)	Drag and drop from one image to another.
void	Drop(int x, int y)	Drop a point on the screen.
void	Drop(Point point)	Drop a point on the screen.
void	Drop(java.lang.String image, java.lang.String... images)	Drop an image.
java.util.HashMap	EggPlantVersion()	Get eggPlant version information Consult the Eggplant Functional documentation for details.
void	endEggplantSession()	End the current eggPlant session.
java.util.List<Point>	EveryImageLocation(java.lang.String image, java.lang.String... images)	Get a list of image locations.
java.util.List<Rectangle>	EveryImageRectangle(java.lang.String image, java.lang.String... images)	Get a list of image rectangles.
EggplantReturnData	execute(java.lang.String params)	Execute some eggPlant script code on the SUT.
ImageInfo	FoundImageInfo()	Get information about the last image we found.
Point	FoundImageLocation()	Get the location of the last image we found.
int	FoundImageNumber()	Get the number of the last image found.
int	getEggPlantDrivePort()	Gets the port that eggPlant Drive is running on.
java.io.File	getEggplantHome()	Get the location at which eggPlant is installed on this injector.
java.lang.String	getEggplantLicenseHost()
java.util.HashMap	GetOption(java.lang.String option)	Gets the value of an option.
java.util.HashMap	GetOptions()	Gets the value of the global options.
int	getUpdatePollInterval()	Get the time in seconds between updates from eggPlant Functional.
protected org.apache.xmlrpc.client.XmlRpcClient	getXmlRpcClient()	For internal use only.
Color	ImageColorAtLocation(java.lang.String image, int x, int y)	Get the color of an image at a location.
Color	ImageColorAtLocation(java.lang.String image, Point location)	Get the color of an image at a location.
boolean	ImageFound(int maxWaitTime, java.lang.String image, java.lang.String... images)	Get whether or not we can find an image.
boolean	ImageFound(java.lang.String image, java.lang.String... images)	Get whether or not we can find an image.
Point	ImageHotSpot(java.lang.String image)	Get the hot spot location of an image Consult the Eggplant Functional documentation for details.
java.util.List<ImageInfo>	ImageInfo(java.lang.String image, java.lang.String... images)	Get image information for one or more images.
Point	ImageLocation(java.lang.String image, java.lang.String... images)	Get the location of an image.
Rectangle	ImageRectangle(java.lang.String image, java.lang.String... images)	Get the rectangle of an image.
Size	ImageSize(java.lang.String image)	Get the size of an image.
protected void	initialise()
boolean	isVerbose()	Whether or not verbose logging is turned on.
void	KeyDown(java.lang.String key, java.lang.String... keys)	Press one or more keys down.
void	KeyUp(java.lang.String key, java.lang.String... keys)	Release one or more keys.
void	Log(java.lang.String text)	Log a message Consult the Eggplant Functional documentation for details.
void	LogError(java.lang.String text)	Log an error.
void	LogWarning(java.lang.String text)	Log a warning.
void	MouseButtonDown(int buttonNumber)	Press a mouse button down.
void	MouseButtonUp(int buttonNumber)	Release a mouse button.
Point	MouseLocation()	Gets the mouse location.
void	MoveTo(int x, int y)	Move to a point on the screen.
void	MoveTo(Point point)	Move to a point on the screen.
void	MoveTo(java.lang.String image, java.lang.String... images)	Move to an image location.
void	MoveToEach(Point... points)	Move to a number of points on the screen.
void	MoveToEach(java.lang.String image, java.lang.String... images)	Move to a number of image locations Consult the Eggplant Functional documentation for details.
protected void	onDataDictionaryChanged()
void	onStartFinalSection()	This method is called whenever the Virtual User is about to start executing the final sequence of scripts in its workflow.
void	onStartInitialSection()	This method is called whenever the Virtual User is about to start executing the initial sequence of scripts in its workflow.
protected void	onStartTransaction(java.lang.String id, java.lang.String tag)	This method is called whenever a transaction is started using the VirtualUser.startTransaction(String) or VirtualUser.startTransaction(String, String) methods.
void	OpenSuite(java.lang.String suiteName)	Open an eggPlant suite.
java.util.List<java.lang.String>	OpenSuites()	Get a list of the open eggPlant suites.
void	PauseScript()	Pause script.
protected void	post()	This method is called after all scripts have finished executing.
protected void	pre()	This method is called before any scripts are executed.
java.lang.Object	ReadTable(Rectangle rectangle, java.lang.String... params)	Read table.
java.lang.String	ReadText(int x, int y, java.lang.String... params)	Read text at a point on the screen Consult the Eggplant Functional documentation for details.
java.lang.String	ReadText(Point point, java.lang.String... params)	Read text at a point on the screen Consult the Eggplant Functional documentation for details.
java.lang.String	ReadText(Rectangle rectangle, java.lang.String... params)	Read text from an area of the screen Consult the Eggplant Functional documentation for details.
void	RefreshScreen()	Refresh the screen.
java.lang.String	RemoteClipboard()	Get the contents of the remote clipboard.
java.lang.String	RemoteClipboard(int maxWaitTime)	Get the contents of the remote clipboard.
void	RightClick(int x, int y)	Right click a point on the screen.
void	RightClick(Point point)	Right click a point on the screen.
void	RightClick(java.lang.String image, java.lang.String... images)	Right click on an image.
EggplantReturnData	Run(java.lang.String scriptName, java.lang.String... parameters)	Run an eggPlant script.
EggplantReturnData	RunWithNewResults(java.lang.String scriptName, java.lang.String... parameters)	Run an eggPlant script with new results.
java.util.List<ScriptResults>	ScriptResults(java.lang.String scriptName)	Get the results of a script.
void	ScrollWheelDown(int wheelIncrements)	Scroll the mouse wheel down.
void	ScrollWheelUp(int wheelIncrements)	Scroll the mouse wheel up.
void	SendMail(java.lang.String params)	Send an email.
protected void	setDataFromPropertyList()
void	setEggPlantDrivePort(int port)	Sets the port that eggPlant Drive is running on.
void	SetOption(java.lang.String params)	Sets an option.
void	SetOptions(java.lang.String param, java.lang.String... params)	Sets the options.
void	SetRemoteClipboard(java.lang.String text)	Sets the text on the remote clipboard.
void	setUpdatePollInterval(int updatePollInterval)	Set the time in seconds between updates from eggPlant Functional.
void	setVerbose(boolean verbose)	Turns verbose logging on or off.
void	startEggplantSession()	Start a new eggPlant session.
void	startEggplantSession(java.lang.String suite)	Start a new eggPlant session and open an eggPlant suite.
void	TypeText(java.lang.String text)	Type text.
void	TypeText(java.lang.String param, java.lang.String... params)	Type text.
void	Wait(double time)	Wait for a period of time.
void	WaitFor(double time, java.lang.String image, java.lang.String... images)	Wait for an image to appear.
void	WaitForAll(double time, java.lang.String image, java.lang.String... images)	Wait for multiple images to appear.

Methods inherited from class com.facilita.fc.runtime.VirtualUser

add, clearProgressPoint, createBackgroundScript, createMonitorSnapshot, endRequest, endRequest, endRequest, endTiming, endTiming, endTiming, endTransaction, endTransaction, endTransaction, endTransaction, error, error, error, error, error, executeCommand, executeCommand, exitVU, exitVU, exitVU, fail, failAction, failTiming, failTiming, failTransaction, failTransaction, failTransaction, finalSequence, finishIterating, finishIteratingRequested, flushEventLog, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, formatDateTime, get, get, getBackgroundScriptIDs, getBackgroundScriptStatus, getBoolean, getBoolean, getContextState, getCurrentIteration, getCurrentScript, getCurrentTimeInXml, getCurrentTransaction, getDataDictionary, getDataDictionary, getDataPath, getDataTable, getDouble, getDouble, getElapsedTime, getFilesDataPath, getFloat, getFloat, getGroupSize, getGroupSize, getGroupSizes, getIndex, getIndexForEngineGroup, getInitialDelay, getInjectorFamilyName, getInjectorName, getInt, getInt, getInteger, getInteger, getIteration, getIterationDelay, getIterationForTime, getJmeterTestPlanName, getLastError, getLastTransaction, getList, getList, getLong, getLong, getMap, getMaxFailures, getMillisecondsSinceEpoch, getMillisecondsSinceEpoch, getName, getNumberOfErrors, getNumberOfFailures, getNumberOfIterations, getNumberOfWarmupIterations, getNumberOfWarnings, getPauseFactor, getProgressPoint, getRunPath, getSandboxPath, getSecondsSinceEpoch, getSecondsSinceEpoch, getService, getServices, getStartTime, getStartTimeSeconds, getString, getString, getTimingElapsedTime, getTimingElapsedTime, getTransactionData, getTransactionElapsedTime, getTransactionElapsedTime, getTransactionElapsedTime, getTransactionLoggingOn, getUniqueID, getUniqueID, getVUName, hasKey, isDebugMode, isFinalScript, isFirstScript, isInitialScript, isIteratedScript, isLastIteration, isPacing, isReadOnly, keys, lastIterationDelay, logCurrentDataValues, nextIteration, nextScript, nextSequence, nowSeconds, onEndTiming, onEndTransaction, onError, onException, onExitVU, onRaiseAlert, onResumeTransaction, onSetProgressPoint, onStartTiming, onSuspendTransaction, onWarn, onWriteMessage, openEventLog, pause, pause, pause, pause, raiseAlert, recordMetric, recordMetric, recordMetrics, recordMetrics, recordTransaction, recordTransaction, recordTransaction, recordTransaction, recordTransaction, recordTransaction, requestToStopBackgroundScript, resumeBackgroundScript, resumeTransaction, resumeTransaction, resumeTransaction, run, runAsBackgroundThread, selectRandomEntryFromList, set, setBoolean, setDebugMode, setDouble, setFloat, setInt, setInteger, setList, setLong, setName, setNumberOfWarmupIterations, setPauseFactor, setProgressPoint, setProgressPoint, setProgressPoint, setProgressPoint, setString, setSynchronizationPoint, setTransactionLoggingOn, setup, startBackgroundScript, startCustomVUWatcher, startRequest, startRequest, startTiming, startTransaction, startTransaction, startTransaction, stopBackgroundScriptImmediately, stopCustomVUWatcher, suspendBackgroundScript, suspendTransaction, suspendTransaction, suspendTransaction, timeToPause, toString, unsetSynchronizationPoint, verify, verifyEQ, verifyEQ, verifyEQ, verifyEQ, verifyLE, verifyLE, verifyLE, verifyLE, verifyLT, verifyLT, verifyLT, verifyLT, waitFor, waitForBackgroundScriptToFinish, waitForBoolean, waitForDouble, waitForFloat, waitForInt, waitForList, waitForLong, waitForString, waitForSynchronizationPoint, warn, warn, warn, warn, writeMessage, writeMessage, writeMessage, writeMessage, writeSystemLog, writeSystemLog

Methods inherited from class java.lang.Object

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

Constructor Detail

EggplantVirtualUser

public EggplantVirtualUser()

INTERNAL USE ONLY. Instantiates a new eggPlant virtual user.

Method Detail

getEggplantHome

public java.io.File getEggplantHome()

Get the location at which eggPlant is installed on this injector.

Returns:

the location at which eggPlant is installed on this injector.

getEggplantLicenseHost

public java.lang.String getEggplantLicenseHost()

pre

protected void pre()
            throws java.lang.Exception

Description copied from class: VirtualUser

This method is called before any scripts are executed.

Override this method in your custom Virtual User if you have code which should be run only once, before any scripts are executed.

This method initialises logging systems. If you override this method in a custom Virtual User, then a call to super.pre() must be made and must occur before any code that may cause an exception or write to a log.

Overrides:

pre in class VirtualUser

Throws:

java.lang.Exception - An error occurred

initialise

protected void initialise()
                   throws java.lang.Exception

Throws:

java.lang.Exception

setDataFromPropertyList

protected void setDataFromPropertyList()
                                throws java.lang.Exception

Throws:

java.lang.Exception

post

protected void post()
             throws java.lang.Exception

Description copied from class: VirtualUser

This method is called after all scripts have finished executing.

Override this method in your custom Virtual User if you have code which should be run only once, after all scripts have finished executing.

This method shuts down logging systems. If you override this method in a custom Virtual User, then a call to super.post() must be made at the end of the method. All exceptions thrown during the execution of this method must be caught and handled.

Overrides:

post in class VirtualUser

Throws:

java.lang.Exception - An error occurred

startEggplantSession

public void startEggplantSession()
                          throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Start a new eggPlant session. Only one session per EggplantVirtualUser can be active at any one time. You can end the current active session by calling EggplantVirtualUserInterface.endEggplantSession()

Specified by:

startEggplantSession in interface EggplantVirtualUserInterface

Throws:

java.lang.Exception - An error occurred

startEggplantSession

public void startEggplantSession(java.lang.String suite)
                          throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Start a new eggPlant session and open an eggPlant suite. Only one session per EggplantVirtualUser can be active at any one time. You can end the current active session by calling EggplantVirtualUserInterface.endEggplantSession()

Specified by:

startEggplantSession in interface EggplantVirtualUserInterface

Parameters:

suite - the file path of the suite to open

Throws:

java.lang.Exception - An error occurred

endEggplantSession

public void endEggplantSession()
                        throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

End the current eggPlant session. Only one session per EggplantVirtualUser can be active at any one time. You can start a new session by calling EggplantVirtualUserInterface.startEggplantSession()

Specified by:

endEggplantSession in interface EggplantVirtualUserInterface

Throws:

java.lang.Exception - An error occurred

execute

public EggplantReturnData execute(java.lang.String params)
                           throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Execute some eggPlant script code on the SUT. The code can be any legal eggPlant script code. However, it is usually easier to use EggplantVirtualUserInterface.Run(String, String...) to execute a complete eggPlant script, rather than use this method.

Specified by:

execute in interface EggplantVirtualUserInterface

Parameters:

params - the eggPlant script code to execute

Returns:

the eggPlant return data

Throws:

java.lang.Exception - An error occurred

getXmlRpcClient

protected org.apache.xmlrpc.client.XmlRpcClient getXmlRpcClient()

For internal use only.

Returns:

For internal use only.

isVerbose

public boolean isVerbose()

Description copied from interface: EggplantVirtualUserInterface

Whether or not verbose logging is turned on.

Specified by:

isVerbose in interface EggplantVirtualUserInterface

Returns:

true, if verbose logging is turned on.

setVerbose

public void setVerbose(boolean verbose)

Description copied from interface: EggplantVirtualUserInterface

Turns verbose logging on or off.

Specified by:

setVerbose in interface EggplantVirtualUserInterface

Parameters:

verbose - true to turn verbose logging on, false to turn it off

getEggPlantDrivePort

public int getEggPlantDrivePort()

Description copied from interface: EggplantVirtualUserInterface

Gets the port that eggPlant Drive is running on.

Specified by:

getEggPlantDrivePort in interface EggplantVirtualUserInterface

Returns:

the egg plant drive port

setEggPlantDrivePort

public void setEggPlantDrivePort(int port)

Description copied from interface: EggplantVirtualUserInterface

Sets the port that eggPlant Drive is running on.

Specified by:

setEggPlantDrivePort in interface EggplantVirtualUserInterface

Parameters:

port - the new egg plant drive port

Click

public void Click(java.lang.String image,
                  java.lang.String... images)
           throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Clicks on an image. Consult the Eggplant Functional documentation for details.

Specified by:

Click in interface EggplantVirtualUserInterface

Parameters:

image - the first image to try to click on

images - the subsequent images

Throws:

java.lang.Exception - An error occurred

Click

public void Click(Point point)
           throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Click on a point on the screen. Consult the Eggplant Functional documentation for details.

Specified by:

Click in interface EggplantVirtualUserInterface

Parameters:

point - the point

Throws:

java.lang.Exception - An error occurred

DoubleClick

public void DoubleClick(java.lang.String image,
                        java.lang.String... images)
                 throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Double click on an image. Consult the Eggplant Functional documentation for details.

Specified by:

DoubleClick in interface EggplantVirtualUserInterface

Parameters:

image - the first image to try to click on

images - the subsequent images

Throws:

java.lang.Exception - An error occurred

DoubleClick

public void DoubleClick(Point point)
                 throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Double click a point on the screen. Consult the Eggplant Functional documentation for details.

Specified by:

DoubleClick in interface EggplantVirtualUserInterface

Parameters:

point - the point to click

Throws:

java.lang.Exception - An error occurred

RightClick

public void RightClick(java.lang.String image,
                       java.lang.String... images)
                throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Right click on an image. Consult the Eggplant Functional documentation for details.

Specified by:

RightClick in interface EggplantVirtualUserInterface

Parameters:

image - the first image to try to click on

images - the subsequent images

Throws:

java.lang.Exception - An error occurred

RightClick

public void RightClick(Point point)
                throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Right click a point on the screen. Consult the Eggplant Functional documentation for details.

Specified by:

RightClick in interface EggplantVirtualUserInterface

Parameters:

point - the point to click

Throws:

java.lang.Exception - An error occurred

MouseButtonDown

public void MouseButtonDown(int buttonNumber)
                     throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Press a mouse button down. Consult the Eggplant Functional documentation for details.

Specified by:

MouseButtonDown in interface EggplantVirtualUserInterface

Parameters:

buttonNumber - the mouse button number to press

Throws:

java.lang.Exception - An error occurred

MouseButtonUp

public void MouseButtonUp(int buttonNumber)
                   throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Release a mouse button. Consult the Eggplant Functional documentation for details.

Specified by:

MouseButtonUp in interface EggplantVirtualUserInterface

Parameters:

buttonNumber - the mouse button number to release

Throws:

java.lang.Exception - An error occurred

ScrollWheelDown

public void ScrollWheelDown(int wheelIncrements)
                     throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Scroll the mouse wheel down. Consult the Eggplant Functional documentation for details.

Specified by:

ScrollWheelDown in interface EggplantVirtualUserInterface

Parameters:

wheelIncrements - the number of wheel increments to scroll

Throws:

java.lang.Exception - An error occurred

ScrollWheelUp

public void ScrollWheelUp(int wheelIncrements)
                   throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Scroll the mouse wheel up. Consult the Eggplant Functional documentation for details.

Specified by:

ScrollWheelUp in interface EggplantVirtualUserInterface

Parameters:

wheelIncrements - the number of wheel increments to scroll

Throws:

java.lang.Exception - An error occurred

MoveTo

public void MoveTo(java.lang.String image,
                   java.lang.String... images)
            throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Move to an image location. Consult the Eggplant Functional documentation for details.

Specified by:

MoveTo in interface EggplantVirtualUserInterface

Parameters:

image - the first image to try to move to

images - subsequent images

Throws:

java.lang.Exception - An error occurred

MoveTo

public void MoveTo(Point point)
            throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Move to a point on the screen. Consult the Eggplant Functional documentation for details.

Specified by:

MoveTo in interface EggplantVirtualUserInterface

Parameters:

point - the point to move to

Throws:

java.lang.Exception - An error occurred

MoveToEach

public void MoveToEach(java.lang.String image,
                       java.lang.String... images)
                throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Move to a number of image locations Consult the Eggplant Functional documentation for details.

Specified by:

MoveToEach in interface EggplantVirtualUserInterface

Parameters:

image - the first image to move to

images - subsequent images

Throws:

java.lang.Exception - An error occurred

MoveToEach

public void MoveToEach(Point... points)
                throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Move to a number of points on the screen. Consult the Eggplant Functional documentation for details.

Specified by:

MoveToEach in interface EggplantVirtualUserInterface

Parameters:

points - the points to move to

Throws:

java.lang.Exception - An error occurred

Drag

public void Drag(java.lang.String image,
                 java.lang.String... images)
          throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Drag an image. Consult the Eggplant Functional documentation for details.

Specified by:

Drag in interface EggplantVirtualUserInterface

Parameters:

image - the first image to try and drag

images - subsequent images

Throws:

java.lang.Exception - An error occurred

Drag

public void Drag(Point point)
          throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Drag a point on the screen. Consult the Eggplant Functional documentation for details.

Specified by:

Drag in interface EggplantVirtualUserInterface

Parameters:

point - the point to drag

Throws:

java.lang.Exception - An error occurred

Drop

public void Drop(java.lang.String image,
                 java.lang.String... images)
          throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Drop an image. Consult the Eggplant Functional documentation for details.

Specified by:

Drop in interface EggplantVirtualUserInterface

Parameters:

image - the first image to try to find

images - subsequent images

Throws:

java.lang.Exception - An error occurred

Drop

public void Drop(Point point)
          throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Drop a point on the screen. Consult the Eggplant Functional documentation for details.

Specified by:

Drop in interface EggplantVirtualUserInterface

Parameters:

point - the point to drop

Throws:

java.lang.Exception - An error occurred

DragAndDrop

public void DragAndDrop(java.lang.String image1,
                        java.lang.String image2,
                        java.lang.String... subsequent)
                 throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Drag and drop from one image to another. Consult the Eggplant Functional documentation for details.

Specified by:

DragAndDrop in interface EggplantVirtualUserInterface

Parameters:

image1 - the first image

image2 - the second image

subsequent - any subsequent images

Throws:

java.lang.Exception - An error occurred

DragAndDrop

public void DragAndDrop(Point start,
                        Point... subsequent)
                 throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Drag and drop from one point to another. Consult the Eggplant Functional documentation for details.

Specified by:

DragAndDrop in interface EggplantVirtualUserInterface

Parameters:

start - the start point

subsequent - subsequent points

Throws:

java.lang.Exception - An error occurred

MouseLocation

public Point MouseLocation()
                    throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Gets the mouse location. Consult the Eggplant Functional documentation for details.

Specified by:

MouseLocation in interface EggplantVirtualUserInterface

Returns:

the mouse location

Throws:

java.lang.Exception - An error occurred

KeyDown

public void KeyDown(java.lang.String key,
                    java.lang.String... keys)
             throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Press one or more keys down. Consult the Eggplant Functional documentation for details.

Specified by:

KeyDown in interface EggplantVirtualUserInterface

Parameters:

key - the first key to press.

keys - any subsequent keys

Throws:

java.lang.Exception - An error occurred

KeyUp

public void KeyUp(java.lang.String key,
                  java.lang.String... keys)
           throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Release one or more keys. Consult the Eggplant Functional documentation for details.

Specified by:

KeyUp in interface EggplantVirtualUserInterface

Parameters:

key - the first key to release

keys - any subsequent keys

Throws:

java.lang.Exception - An error occurred

ReadTable

public java.lang.Object ReadTable(Rectangle rectangle,
                                  java.lang.String... params)
                           throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Read table. Consult the Eggplant Functional documentation for details.

Specified by:

ReadTable in interface EggplantVirtualUserInterface

Parameters:

rectangle - the rectangle

params - the params

Returns:

the object

Throws:

java.lang.Exception - An error occurred

ReadText

public java.lang.String ReadText(Point point,
                                 java.lang.String... params)
                          throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Read text at a point on the screen Consult the Eggplant Functional documentation for details.

Specified by:

ReadText in interface EggplantVirtualUserInterface

Parameters:

point - the point

params - the params

Returns:

the text

Throws:

java.lang.Exception - An error occurred

ReadText

public java.lang.String ReadText(Rectangle rectangle,
                                 java.lang.String... params)
                          throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Read text from an area of the screen Consult the Eggplant Functional documentation for details.

Specified by:

ReadText in interface EggplantVirtualUserInterface

Parameters:

rectangle - the rectangle

params - the params

Returns:

the string

Throws:

java.lang.Exception - An error occurred

RemoteClipboard

public java.lang.String RemoteClipboard(int maxWaitTime)
                                 throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get the contents of the remote clipboard. Consult the Eggplant Functional documentation for details.

Specified by:

RemoteClipboard in interface EggplantVirtualUserInterface

Parameters:

maxWaitTime - the max wait time

Returns:

the text on the clipboard

Throws:

java.lang.Exception - An error occurred

RemoteClipboard

public java.lang.String RemoteClipboard()
                                 throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get the contents of the remote clipboard. Consult the Eggplant Functional documentation for details.

Specified by:

RemoteClipboard in interface EggplantVirtualUserInterface

Returns:

the text on the clipboard

Throws:

java.lang.Exception - An error occurred

SetRemoteClipboard

public void SetRemoteClipboard(java.lang.String text)
                        throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Sets the text on the remote clipboard. Consult the Eggplant Functional documentation for details.

Specified by:

SetRemoteClipboard in interface EggplantVirtualUserInterface

Parameters:

text - the text to set

Throws:

java.lang.Exception - An error occurred

TypeText

public void TypeText(java.lang.String text)
              throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Type text. Consult the Eggplant Functional documentation for details.

Specified by:

TypeText in interface EggplantVirtualUserInterface

Parameters:

text - the text to type

Throws:

java.lang.Exception - An error occurred

TypeText

public void TypeText(java.lang.String param,
                     java.lang.String... params)
              throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Type text. Consult the Eggplant Functional documentation for details.

Specified by:

TypeText in interface EggplantVirtualUserInterface

Parameters:

param - the text to type

params - the params

Throws:

java.lang.Exception - An error occurred

Wait

public void Wait(double time)
          throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Wait for a period of time. Consult the Eggplant Functional documentation for details.

Specified by:

Wait in interface EggplantVirtualUserInterface

Parameters:

time - the time in seconds to wait

Throws:

java.lang.Exception - An error occurred

WaitFor

public void WaitFor(double time,
                    java.lang.String image,
                    java.lang.String... images)
             throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Wait for an image to appear. Consult the Eggplant Functional documentation for details.

Specified by:

WaitFor in interface EggplantVirtualUserInterface

Parameters:

time - the time in seconds to wait

image - the first image to wait for

images - any subsequent images to wait for

Throws:

java.lang.Exception - An error occurred

WaitForAll

public void WaitForAll(double time,
                       java.lang.String image,
                       java.lang.String... images)
                throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Wait for multiple images to appear. Consult the Eggplant Functional documentation for details.

Specified by:

WaitForAll in interface EggplantVirtualUserInterface

Parameters:

time - the time in seconds to wait

image - the first image to wait for

images - the subsequent images to wait for

Throws:

java.lang.Exception - An error occurred

RefreshScreen

public void RefreshScreen()
                   throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Refresh the screen. Consult the Eggplant Functional documentation for details.

Specified by:

RefreshScreen in interface EggplantVirtualUserInterface

Throws:

java.lang.Exception - An error occurred

ImageFound

public boolean ImageFound(java.lang.String image,
                          java.lang.String... images)
                   throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get whether or not we can find an image. Consult the Eggplant Functional documentation for details.

Specified by:

ImageFound in interface EggplantVirtualUserInterface

Parameters:

image - the first image to look for

images - any subsequent images to look for

Returns:

true, if successful

Throws:

java.lang.Exception - An error occurred

ImageFound

public boolean ImageFound(int maxWaitTime,
                          java.lang.String image,
                          java.lang.String... images)
                   throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get whether or not we can find an image. Consult the Eggplant Functional documentation for details.

Specified by:

ImageFound in interface EggplantVirtualUserInterface

Parameters:

maxWaitTime - the max time in seconds to wait for the image

image - the first image to look for

images - any subsequent images to look for

Returns:

true, if successful

Throws:

java.lang.Exception - An error occurred

ImageLocation

public Point ImageLocation(java.lang.String image,
                           java.lang.String... images)
                    throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get the location of an image. Consult the Eggplant Functional documentation for details.

Specified by:

ImageLocation in interface EggplantVirtualUserInterface

Parameters:

image - the first image to look for

images - any subsequent images to look for

Returns:

the screen location

Throws:

java.lang.Exception - An error occurred

ImageRectangle

public Rectangle ImageRectangle(java.lang.String image,
                                java.lang.String... images)
                         throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get the rectangle of an image. Consult the Eggplant Functional documentation for details.

Specified by:

ImageRectangle in interface EggplantVirtualUserInterface

Parameters:

image - the first image to look for

images - any subsequent images to look for

Returns:

the rectangle

Throws:

java.lang.Exception - An error occurred

EveryImageLocation

public java.util.List<Point> EveryImageLocation(java.lang.String image,
                                                java.lang.String... images)
                                         throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get a list of image locations. Consult the Eggplant Functional documentation for details.

Specified by:

EveryImageLocation in interface EggplantVirtualUserInterface

Parameters:

image - the first image to look for

images - subsequent images to look for

Returns:

the list of points where the images were found

Throws:

java.lang.Exception - An error occurred

EveryImageRectangle

public java.util.List<Rectangle> EveryImageRectangle(java.lang.String image,
                                                     java.lang.String... images)
                                              throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get a list of image rectangles. Consult the Eggplant Functional documentation for details.

Specified by:

EveryImageRectangle in interface EggplantVirtualUserInterface

Parameters:

image - the first image to look fro

images - subsequent images to look for

Returns:

the list of rectangles where the images were found

Throws:

java.lang.Exception - An error occurred

ImageInfo

public java.util.List<ImageInfo> ImageInfo(java.lang.String image,
                                           java.lang.String... images)
                                    throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get image information for one or more images. Consult the Eggplant Functional documentation for details.

Specified by:

ImageInfo in interface EggplantVirtualUserInterface

Parameters:

image - the first image

images - any subsequent images

Returns:

the list of image information

Throws:

java.lang.Exception - An error occurred

ImageHotSpot

public Point ImageHotSpot(java.lang.String image)
                   throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get the hot spot location of an image Consult the Eggplant Functional documentation for details.

Specified by:

ImageHotSpot in interface EggplantVirtualUserInterface

Parameters:

image - the image to look for

Returns:

the hot spot location

Throws:

java.lang.Exception - An error occurred

ImageSize

public Size ImageSize(java.lang.String image)
               throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get the size of an image. Consult the Eggplant Functional documentation for details.

Specified by:

ImageSize in interface EggplantVirtualUserInterface

Parameters:

image - the image to look for

Returns:

the size of the image

Throws:

java.lang.Exception - An error occurred

ImageColorAtLocation

public Color ImageColorAtLocation(java.lang.String image,
                                  Point location)
                           throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get the color of an image at a location. Consult the Eggplant Functional documentation for details.

Specified by:

ImageColorAtLocation in interface EggplantVirtualUserInterface

Parameters:

image - the image to look for

location - the location within the image

Returns:

the color of the image at the location

Throws:

java.lang.Exception - An error occurred

FoundImageInfo

public ImageInfo FoundImageInfo()
                         throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get information about the last image we found. Consult the Eggplant Functional documentation for details.

Specified by:

FoundImageInfo in interface EggplantVirtualUserInterface

Returns:

the image info

Throws:

java.lang.Exception - An error occurred

FoundImageLocation

public Point FoundImageLocation()
                         throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get the location of the last image we found. Consult the Eggplant Functional documentation for details.

Specified by:

FoundImageLocation in interface EggplantVirtualUserInterface

Returns:

the location of the last image found

Throws:

java.lang.Exception - An error occurred

FoundImageNumber

public int FoundImageNumber()
                     throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get the number of the last image found. Consult the Eggplant Functional documentation for details.

Specified by:

FoundImageNumber in interface EggplantVirtualUserInterface

Returns:

the int

Throws:

java.lang.Exception - An error occurred

PauseScript

public void PauseScript()
                 throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Pause script. Consult the Eggplant Functional documentation for details.

Specified by:

PauseScript in interface EggplantVirtualUserInterface

Throws:

java.lang.Exception - An error occurred

Run

public EggplantReturnData Run(java.lang.String scriptName,
                              java.lang.String... parameters)
                       throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Run an eggPlant script. Consult the Eggplant Functional documentation for details.

Specified by:

Run in interface EggplantVirtualUserInterface

Parameters:

scriptName - the script name

parameters - the parameters to pass to the script

Returns:

the data returned from eggPlant

Throws:

java.lang.Exception - An error occurred

RunWithNewResults

public EggplantReturnData RunWithNewResults(java.lang.String scriptName,
                                            java.lang.String... parameters)
                                     throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Run an eggPlant script with new results. Consult the Eggplant Functional documentation for details.

Specified by:

RunWithNewResults in interface EggplantVirtualUserInterface

Parameters:

scriptName - the script name

parameters - the parameters to pass to the script

Returns:

the data returned from eggPlant

Throws:

java.lang.Exception - An error occurred

OpenSuite

public void OpenSuite(java.lang.String suiteName)
               throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Open an eggPlant suite. Consult the Eggplant Functional documentation for details.

Specified by:

OpenSuite in interface EggplantVirtualUserInterface

Parameters:

suiteName - the path of the suite to open

Throws:

java.lang.Exception - An error occurred

CloseSuite

public void CloseSuite(java.lang.String suiteName)
                throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Close an eggPlant suite. Consult the Eggplant Functional documentation for details.

Specified by:

CloseSuite in interface EggplantVirtualUserInterface

Parameters:

suiteName - the suite name

Throws:

java.lang.Exception - An error occurred

OpenSuites

public java.util.List<java.lang.String> OpenSuites()
                                            throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get a list of the open eggPlant suites. Consult the Eggplant Functional documentation for details.

Specified by:

OpenSuites in interface EggplantVirtualUserInterface

Returns:

the list of open suites

Throws:

java.lang.Exception - An error occurred

SetOption

public void SetOption(java.lang.String params)
               throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Sets an option. Consult the Eggplant Functional documentation for details.

Specified by:

SetOption in interface EggplantVirtualUserInterface

Parameters:

params - the options you are setting

Throws:

java.lang.Exception - An error occurred

SetOptions

public void SetOptions(java.lang.String param,
                       java.lang.String... params)
                throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Sets the options. Consult the Eggplant Functional documentation for details.

Specified by:

SetOptions in interface EggplantVirtualUserInterface

Parameters:

param - the first option to set

params - subsequent options to set

Throws:

java.lang.Exception - An error occurred

GetOption

public java.util.HashMap GetOption(java.lang.String option)
                            throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Gets the value of an option. Consult the Eggplant Functional documentation for details.

Specified by:

GetOption in interface EggplantVirtualUserInterface

Parameters:

option - the option to get

Returns:

the option value

Throws:

java.lang.Exception - An error occurred

GetOptions

public java.util.HashMap GetOptions()
                             throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Gets the value of the global options. Consult the Eggplant Functional documentation for details.

Specified by:

GetOptions in interface EggplantVirtualUserInterface

Returns:

the options values

Throws:

java.lang.Exception - An error occurred

CaptureScreen

public void CaptureScreen(java.lang.String name,
                          Rectangle rectangle,
                          boolean increment,
                          ImageInfo imageInfo)
                   throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Capture an area of screen and save to file. Consult the Eggplant Functional documentation for details.

Specified by:

CaptureScreen in interface EggplantVirtualUserInterface

Parameters:

name - the filepath of the captured image

rectangle - the area of screen to capture

increment - if true, automatically append an incremented number to the image name

imageInfo - additional image info

Throws:

java.lang.Exception - An error occurred

CaptureScreen

public void CaptureScreen(java.lang.String name)
                   throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Capture an area of screen and save to file. Consult the Eggplant Functional documentation for details.

Specified by:

CaptureScreen in interface EggplantVirtualUserInterface

Parameters:

name - the filepath of the captured image

Throws:

java.lang.Exception - An error occurred

EggPlantVersion

public java.util.HashMap EggPlantVersion()
                                  throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get eggPlant version information Consult the Eggplant Functional documentation for details.

Specified by:

EggPlantVersion in interface EggplantVirtualUserInterface

Returns:

the hash map of version information

Throws:

java.lang.Exception - An error occurred

ColorAtLocation

public Color ColorAtLocation(Point location)
                      throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get the color at a location. Consult the Eggplant Functional documentation for details.

Specified by:

ColorAtLocation in interface EggplantVirtualUserInterface

Parameters:

location - the location

Returns:

the color at the location

Throws:

java.lang.Exception - An error occurred

Connect

public void Connect(java.lang.String name,
                    int portNum,
                    java.lang.String username,
                    java.lang.String password,
                    java.lang.String sshHost,
                    java.lang.String sshUser,
                    java.lang.String sshPassword,
                    int colorDepth,
                    ConnectionType type,
                    int height,
                    int width,
                    java.lang.String[] additionalArgs)
             throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Connect to the SUT. Consult the Eggplant Functional documentation for details.

Specified by:

Connect in interface EggplantVirtualUserInterface

Parameters:

name - the name of the SUT

portNum - the port num

username - the username for the SUT

password - the password for the SUT

sshHost - the ssh host

sshUser - the ssh user

sshPassword - the ssh password

colorDepth - the color depth

type - the type of connection to open (VNC or RDP)

height - For RDP connection types only, specifies the height of the Viewer window in pixels. (Default value: 768.)

width - For RDP connection types only, specifies the width of the Viewer window in pixels. (Default value: 1024.)

additionalArgs - For Android VNC connections only, provides the scale-screen NN option that allows you to specify a screen scaling ratio where NN is an integer for the scale factor. For example, scale-screen 2 scales down the screen size to 50% of its actual size.

Throws:

java.lang.Exception - An error occurred

Connect

public void Connect(ConnectionProperties connectionProperties)
             throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Connect to the SUT. Consult the Eggplant Functional documentation for details.

Specified by:

Connect in interface EggplantVirtualUserInterface

Parameters:

connectionProperties - the connection properties to use to connect

Throws:

java.lang.Exception - An error occurred

Connect

public void Connect(java.lang.String name,
                    int portNum,
                    java.lang.String username,
                    java.lang.String password,
                    java.lang.String sshHost,
                    java.lang.String sshUser,
                    java.lang.String sshPassword,
                    int colorDepth)
             throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Connect to the SUT. Consult the Eggplant Functional documentation for details.

Specified by:

Connect in interface EggplantVirtualUserInterface

Parameters:

name - the name of the SUT

portNum - the port num

username - the username for the SUT

password - the password for the SUT

sshHost - the ssh host

sshUser - the ssh user

sshPassword - the ssh password

colorDepth - the color depth

Throws:

java.lang.Exception - An error occurred

Connect

public void Connect(java.lang.String name,
                    int portNum,
                    java.lang.String username,
                    java.lang.String password)
             throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Connect to the SUT. Consult the Eggplant Functional documentation for details.

Specified by:

Connect in interface EggplantVirtualUserInterface

Parameters:

name - the name of the SUT

portNum - the port num

username - the username for the VNC server

password - the password for the VNC server

Throws:

java.lang.Exception - An error occurred

Connect

public void Connect(java.lang.String name,
                    ConnectionType type,
                    java.lang.String username,
                    java.lang.String password)
             throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Connect to the SUT. Consult the Eggplant Functional documentation for details.

Specified by:

Connect in interface EggplantVirtualUserInterface

Parameters:

name - the name of the SUT

type - the type of connection to open (VNC or RDP)

username - the username for the SUT

password - the password for the SUT

Throws:

java.lang.Exception - An error occurred

Connect

public void Connect(java.lang.String name,
                    int portNum,
                    ConnectionType type,
                    java.lang.String username,
                    java.lang.String password)
             throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Connect to the SUT. Consult the Eggplant Functional documentation for details.

Specified by:

Connect in interface EggplantVirtualUserInterface

Parameters:

name - the name of the SUT

portNum - the port number used by the SUT

type - the type of connection to open (VNC or RDP)

username - the username for the SUT

password - the password for the SUT

Throws:

java.lang.Exception - An error occurred

Connect

public void Connect(java.lang.String name,
                    java.lang.String username,
                    java.lang.String password)
             throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Connect to the SUT. Consult the Eggplant Functional documentation for details.

Specified by:

Connect in interface EggplantVirtualUserInterface

Parameters:

name - the name of the SUT

username - the username for the VNC server

password - the password for the VNC server

Throws:

java.lang.Exception - An error occurred

Connect

public void Connect(java.lang.String name,
                    int portNum)
             throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Connect to the SUT. Consult the Eggplant Functional documentation for details.

Specified by:

Connect in interface EggplantVirtualUserInterface

Parameters:

name - the name of the SUT

portNum - the port num

Throws:

java.lang.Exception - An error occurred

Connect

public void Connect(java.lang.String name)
             throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Connect to the SUT. Consult the Eggplant Functional documentation for details.

Specified by:

Connect in interface EggplantVirtualUserInterface

Parameters:

name - the name of the SUT

Throws:

java.lang.Exception - An error occurred

ConnectionInfo

public ConnectionInfo ConnectionInfo(java.lang.String name)
                              throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get connection info for a connection. Consult the Eggplant Functional documentation for details.

Specified by:

ConnectionInfo in interface EggplantVirtualUserInterface

Parameters:

name - the name of the connection

Returns:

the connection info

Throws:

java.lang.Exception - An error occurred

Disconnect

public void Disconnect(java.lang.String name)
                throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Disconnect from the SUT. Consult the Eggplant Functional documentation for details.

Specified by:

Disconnect in interface EggplantVirtualUserInterface

Parameters:

name - the name of the SUT

Throws:

java.lang.Exception - An error occurred

Disconnect

public void Disconnect()
                throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Disconnect from the SUT. Consult the Eggplant Functional documentation for details.

Specified by:

Disconnect in interface EggplantVirtualUserInterface

Throws:

java.lang.Exception - An error occurred

Click

public void Click(int x,
                  int y)
           throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Click on a point on the screen. Consult the Eggplant Functional documentation for details.

Specified by:

Click in interface EggplantVirtualUserInterface

Parameters:

x - the x

y - the y

Throws:

java.lang.Exception - An error occurred

DoubleClick

public void DoubleClick(int x,
                        int y)
                 throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Double click a point on the screen. Consult the Eggplant Functional documentation for details.

Specified by:

DoubleClick in interface EggplantVirtualUserInterface

Parameters:

x - the x

y - the y

Throws:

java.lang.Exception - An error occurred

RightClick

public void RightClick(int x,
                       int y)
                throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Right click a point on the screen. Consult the Eggplant Functional documentation for details.

Specified by:

RightClick in interface EggplantVirtualUserInterface

Parameters:

x - the x

y - the y

Throws:

java.lang.Exception - An error occurred

MoveTo

public void MoveTo(int x,
                   int y)
            throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Move to a point on the screen. Consult the Eggplant Functional documentation for details.

Specified by:

MoveTo in interface EggplantVirtualUserInterface

Parameters:

x - the x

y - the y

Throws:

java.lang.Exception - An error occurred

Drag

public void Drag(int x,
                 int y)
          throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Drag a point on the screen. Consult the Eggplant Functional documentation for details.

Specified by:

Drag in interface EggplantVirtualUserInterface

Parameters:

x - the x

y - the y

Throws:

java.lang.Exception - An error occurred

Drop

public void Drop(int x,
                 int y)
          throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Drop a point on the screen. Consult the Eggplant Functional documentation for details.

Specified by:

Drop in interface EggplantVirtualUserInterface

Parameters:

x - the x

y - the y

Throws:

java.lang.Exception - An error occurred

ReadText

public java.lang.String ReadText(int x,
                                 int y,
                                 java.lang.String... params)
                          throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Read text at a point on the screen Consult the Eggplant Functional documentation for details.

Specified by:

ReadText in interface EggplantVirtualUserInterface

Parameters:

x - the x

y - the y

params - the params

Returns:

the string

Throws:

java.lang.Exception - An error occurred

ImageColorAtLocation

public Color ImageColorAtLocation(java.lang.String image,
                                  int x,
                                  int y)
                           throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get the color of an image at a location. Consult the Eggplant Functional documentation for details.

Specified by:

ImageColorAtLocation in interface EggplantVirtualUserInterface

Parameters:

image - the image to look for

x - the x coordinate within the image

y - the y coordinate within the image

Returns:

the color of the image at the location

Throws:

java.lang.Exception - An error occurred

ColorAtLocation

public Color ColorAtLocation(int x,
                             int y)
                      throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get the color at a location. Consult the Eggplant Functional documentation for details.

Specified by:

ColorAtLocation in interface EggplantVirtualUserInterface

Parameters:

x - the x

y - the y

Returns:

the color at the location

Throws:

java.lang.Exception - An error occurred

CaptureTextImage

public void CaptureTextImage(java.lang.String params)
                      throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Capture text image.

Specified by:

CaptureTextImage in interface EggplantVirtualUserInterface

Parameters:

params - the params

Throws:

java.lang.Exception - An error occurred

AllConnectionInfo

public java.util.List<ConnectionInfo> AllConnectionInfo()
                                                 throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get a list of information about all the current connections. Consult the Eggplant Functional documentation for details.

Specified by:

AllConnectionInfo in interface EggplantVirtualUserInterface

Returns:

the list of connection information

Throws:

java.lang.Exception - An error occurred

SendMail

public void SendMail(java.lang.String params)
              throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Send an email. Consult the Eggplant Functional documentation for details.

Specified by:

SendMail in interface EggplantVirtualUserInterface

Parameters:

params - the params

Throws:

java.lang.Exception - An error occurred

Log

public void Log(java.lang.String text)
         throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Log a message Consult the Eggplant Functional documentation for details.

Specified by:

Log in interface EggplantVirtualUserInterface

Parameters:

text - the text

Throws:

java.lang.Exception - An error occurred

LogWarning

public void LogWarning(java.lang.String text)
                throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Log a warning. Consult the Eggplant Functional documentation for details.

Specified by:

LogWarning in interface EggplantVirtualUserInterface

Parameters:

text - the text

Throws:

java.lang.Exception - An error occurred

LogError

public void LogError(java.lang.String text)
              throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Log an error. Consult the Eggplant Functional documentation for details.

Specified by:

LogError in interface EggplantVirtualUserInterface

Parameters:

text - the text

Throws:

java.lang.Exception - An error occurred

ScriptResults

public java.util.List<ScriptResults> ScriptResults(java.lang.String scriptName)
                                            throws java.lang.Exception

Description copied from interface: EggplantVirtualUserInterface

Get the results of a script. Consult the Eggplant Functional documentation for details.

Specified by:

ScriptResults in interface EggplantVirtualUserInterface

Parameters:

scriptName - the script name

Returns:

the list of script results

Throws:

java.lang.Exception - An error occurred

attachLogMessageSender

public void attachLogMessageSender(com.facilita.fc.runtime.IMessageSender messageSender)

Description copied from class: VirtualUser

For internal use only.

Overrides:

attachLogMessageSender in class VirtualUser

Parameters:

messageSender - internal use only

atStartOfIteration

protected void atStartOfIteration()

Description copied from class: VirtualUser

This method is called at the start of every iteration.

Override this method in your custom Virtual User if you have code which should be run at the start of every iteration.

The current iteration number can be obtained using VirtualUser.getCurrentIteration().

Overrides:

atStartOfIteration in class VirtualUser

onStartTransaction

protected void onStartTransaction(java.lang.String id,
                                  java.lang.String tag)
                           throws java.lang.Exception

Description copied from class: VirtualUser

This method is called whenever a transaction is started using the VirtualUser.startTransaction(String) or VirtualUser.startTransaction(String, String) methods.

Override this method in your custom Virtual User if you have code which should be run whenever a transaction is started.

Overrides:

onStartTransaction in class VirtualUser

Parameters:

id - the transaction identifier

tag - extra information which appears in the Info column

Throws:

java.lang.Exception - An error occurred

onStartInitialSection

public void onStartInitialSection()

Description copied from class: VirtualUser

This method is called whenever the Virtual User is about to start executing the initial sequence of scripts in its workflow.

Override this method in your custom Virtual User if you have code which should be run whenever the Virtual User starts executing the initial sequence of scripts.

Overrides:

onStartInitialSection in class VirtualUser

onStartFinalSection

public void onStartFinalSection()

Description copied from class: VirtualUser

This method is called whenever the Virtual User is about to start executing the final sequence of scripts in its workflow.

Override this method in your custom Virtual User if you have code which should be run whenever the Virtual User starts executing the final sequence of scripts.

Overrides:

onStartFinalSection in class VirtualUser

getUpdatePollInterval

public int getUpdatePollInterval()

Description copied from interface: EggplantVirtualUserInterface

Get the time in seconds between updates from eggPlant Functional.

When we tell eggPlant Functional to execute a long-running command (such as running a script), it will return the results so far every getUpdatePollInterval() seconds.

Specified by:

getUpdatePollInterval in interface EggplantVirtualUserInterface

Returns:

the time in seconds between updates from eggPlant Functional.

See Also:

EggplantVirtualUserInterface.setUpdatePollInterval(int)

setUpdatePollInterval

public void setUpdatePollInterval(int updatePollInterval)
                           throws BadValueException

Description copied from interface: EggplantVirtualUserInterface

Set the time in seconds between updates from eggPlant Functional.

When we tell eggPlant Functional to execute a long-running command (such as running a script), it will return the results so far every getUpdatePollInterval() seconds.

Specified by:

setUpdatePollInterval in interface EggplantVirtualUserInterface

Parameters:

updatePollInterval - the time in seconds between updates from eggPlant Functional.

Throws:

BadValueException - An error occurred

See Also:

EggplantVirtualUserInterface.getUpdatePollInterval()

atEndOfIteration

protected void atEndOfIteration()

Description copied from class: VirtualUser

This method is called at the end of every iteration.

Override this method in your custom Virtual User if you have code which should be run at the end of every iteration.

The current iteration number can be obtained using VirtualUser.getCurrentIteration().

Overrides:

atEndOfIteration in class VirtualUser

onDataDictionaryChanged

protected void onDataDictionaryChanged()

Overrides:

onDataDictionaryChanged in class VirtualUser