com.opera.core.systems.scope.stp.services

Class ScopeExec

java.lang.Object

com.opera.core.systems.scope.AbstractService

com.opera.core.systems.scope.stp.services.ScopeExec

All Implemented Interfaces:

Service, Exec

public class ScopeExec
extends AbstractService
implements Exec

The exec service handles user interactions such as key presses, mouse clicks, screenshot grabbing and executing actions on Opera.

Field Summary

Fields inherited from class com.opera.core.systems.scope.AbstractService

services

Fields inherited from interface com.opera.core.systems.scope.services.Exec

SERVICE_NAME

Constructor Summary

Constructors

Constructor and Description
ScopeExec(ScopeServices services)

Method Summary

Methods

Modifier and Type	Method and Description
void	action(String using, int windowID, String... params) Execute an Opera action with parameters to a specific window.
void	action(String using, int data, String dataString, String dataStringParam) Execute an Opera action with a data parameter for extra integer data to be sent with the action.
void	action(String using, String... params) Execute an Opera action with parameters.
ScreenCaptureReply	containsColor(Canvas canvas, long timeout, OperaColors... colors) Check if the page contains color(s) as specified in OperaColors.
Set<String>	getActionList() Returns the list of possible Opera Actions on host.
void	init() Initialize the service.
void	key(String key) Execute a key press (immediately send key down and up).
void	key(String key, boolean up) Create a key event, this event controls if the key has been previously pressed before allowing key up.
void	mouseAction(int x, int y, int count, OperaMouseKeys... keys) Create one or more mouse actions on coordinates x,y with key(s) as specified in OperaMouseKeys and the number of repeated events as an integer.
void	mouseAction(int x, int y, OperaMouseKeys... keys) Create a mouse action on coordinates x,y with key(s) as specified in OperaMouseKeys.
ScreenCaptureReply	screenWatcher(Canvas canvas, long timeout, boolean includeImage, List<String> hashes) Take a screenshot of specified ExecProtos.Area and compare it with the given hashes (keys).

Methods inherited from class com.opera.core.systems.scope.AbstractService

buildPayload, executeMessage, executeMessage, executeMessage, getServiceName, getServiceVersion, isVersionInRange, sleep, toString, xpathIterator, xpathPointer

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.opera.core.systems.scope.Service

getServiceName, getServiceVersion

Constructor Detail

ScopeExec

public ScopeExec(ScopeServices services)

Method Detail

init

public void init()

Description copied from interface: Service

Initialize the service.

Specified by:

init in interface Service

mouseAction

public void mouseAction(int x,
               int y,
               OperaMouseKeys... keys)

Description copied from interface: Exec

Create a mouse action on coordinates x,y with key(s) as specified in OperaMouseKeys.

Specified by:

mouseAction in interface Exec

mouseAction

public void mouseAction(int x,
               int y,
               int count,
               OperaMouseKeys... keys)

Description copied from interface: Exec

Create one or more mouse actions on coordinates x,y with key(s) as specified in OperaMouseKeys and the number of repeated events as an integer.

Specified by:

mouseAction in interface Exec

getActionList

public Set<String> getActionList()

Description copied from interface: Exec

Returns the list of possible Opera Actions on host.

Specified by:

getActionList in interface Exec

action

public void action(String using,
          String... params)

Description copied from interface: Exec

Execute an Opera action with parameters.

Specified by:

action in interface Exec

Parameters:

using - the name of the action to execute

params - the string parameters for extra string data to be sent with the action, e.g. "opera.com" to the command "go"

action

public void action(String using,
          int windowID,
          String... params)

Description copied from interface: Exec

Execute an Opera action with parameters to a specific window. If you specify the wrong window, the action will fail. Specifying window as 0 will send the command to the currently active window.

Specified by:

action in interface Exec

Parameters:

using - the name of the action to execute

windowID - window to send the action to, 0 for the currently active window

params - the string parameters for extra string data to be sent with the action, e.g. "opera.com" to the command "go"

action

public void action(String using,
          int data,
          String dataString,
          String dataStringParam)

Description copied from interface: Exec

Execute an Opera action with a data parameter for extra integer data to be sent with the action. In some actions the data parameter is interpreted as a pointer rather than an integer. In these cases the action will fail.

Specified by:

action in interface Exec

Parameters:

using - the name of the action to execute

data - data parameter for extra integer data to be sent with the action

dataString - string parameter for extra string data to be sent with the action, e.g. "opera.com" to the command "go"

dataStringParam - extra string parameter for action, sent in addition to the value parameter for actions that need two strings

key

public void key(String key)

Description copied from interface: Exec

Execute a key press (immediately send key down and up).

Specified by:

key in interface Exec

key

public void key(String key,
       boolean up)

Description copied from interface: Exec

Create a key event, this event controls if the key has been previously pressed before allowing key up.

Specified by:

key in interface Exec

up - down if false

containsColor

public ScreenCaptureReply containsColor(Canvas canvas,
                               long timeout,
                               OperaColors... colors)

Description copied from interface: Exec

Check if the page contains color(s) as specified in OperaColors.

Specified by:

containsColor in interface Exec

screenWatcher

public ScreenCaptureReply screenWatcher(Canvas canvas,
                               long timeout,
                               boolean includeImage,
                               List<String> hashes)

Description copied from interface: Exec

Take a screenshot of specified ExecProtos.Area and compare it with the given hashes (keys).

Specified by:

screenWatcher in interface Exec