com.opera.core.systems.runner.launcher

Class OperaLauncherRunner

java.lang.Object

com.opera.core.systems.runner.AbstractOperaRunner

com.opera.core.systems.runner.launcher.OperaLauncherRunner

All Implemented Interfaces:

OperaRunner

public class OperaLauncherRunner
extends AbstractOperaRunner
implements OperaRunner

OperaLauncherRunner implements a Java interface to communicate with the opera-launcher utility to launch and manage Opera instances.

Field Summary

Fields

Modifier and Type	Field and Description
static File	LAUNCHER_DEFAULT_LOCATION
static File	LAUNCHER_DIRECTORY
static String	LAUNCHER_ENV_VAR
static String	LAUNCHER_NAME

Fields inherited from class com.opera.core.systems.runner.AbstractOperaRunner

settings

Constructor Summary

Constructors

Constructor and Description
OperaLauncherRunner()
OperaLauncherRunner(OperaSettings s)

Method Summary

Methods

Modifier and Type	Method and Description
static void	assertLauncherGood(File launcher) Asserts whether given launcher exists, is a file and that it's executable.
static List<String>	buildArguments(OperaSettings settings, int launcherPort)
ScreenCaptureReply	captureScreen() Take screenshot using external program.
ScreenCaptureReply	captureScreen(long timeout) Take screenshot using external program.
ScreenCaptureReply	captureScreen(long timeout, List<String> knownMD5s) Take screenshot using external program.
String	getOperaCrashlog() If Opera crashed there should be a crashlog.
boolean	hasOperaCrashed() Did Opera crash? This is reset on next call, so if you don't check you won't know.
boolean	isOperaRunning() Is Opera running?
boolean	isOperaRunning(int processId)
void	shutdown() In case the com.opera.core.systems.runner.runner has open sockets, they need to be closed.
void	startOpera() Start Opera, does nothing if Opera is already started.
void	stopOpera() Stops Opera, does nothing if Opera isn't running.
protected static Level	toLauncherLoggingLevel(Level level) The launcher allows for the following logging levels: "FINEST", "FINE", "INFO", "WARNING", "SEVERE".

Methods inherited from class com.opera.core.systems.runner.AbstractOperaRunner

getSettings, sleep

Methods inherited from class java.lang.Object

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

Field Detail

LAUNCHER_ENV_VAR

public static final String LAUNCHER_ENV_VAR

See Also:

Constant Field Values

LAUNCHER_NAME

public static final String LAUNCHER_NAME

LAUNCHER_DIRECTORY

public static final File LAUNCHER_DIRECTORY

LAUNCHER_DEFAULT_LOCATION

public static final File LAUNCHER_DEFAULT_LOCATION

Constructor Detail

OperaLauncherRunner

public OperaLauncherRunner()

OperaLauncherRunner

public OperaLauncherRunner(OperaSettings s)

Method Detail

buildArguments

public static List<String> buildArguments(OperaSettings settings,
                          int launcherPort)

startOpera

public void startOpera()
                throws OperaRunnerException

Start Opera, does nothing if Opera is already started.

Specified by:

startOpera in interface OperaRunner

Throws:

OperaRunnerException - if launcher is shut down or not running

stopOpera

public void stopOpera()
               throws OperaRunnerException

Stops Opera, does nothing if Opera isn't running. Typically we'll use the exec service to stop Opera, but this method will _ensure_ that Opera is quit from an external process controller.

Specified by:

stopOpera in interface OperaRunner

Throws:

OperaRunnerException - if launcher is shut down or not running

isOperaRunning

public boolean isOperaRunning()

Description copied from interface: OperaRunner

Is Opera running?

Specified by:

isOperaRunning in interface OperaRunner

Returns:

true if running, false if not running or crashed

isOperaRunning

public boolean isOperaRunning(int processId)

hasOperaCrashed

public boolean hasOperaCrashed()

Description copied from interface: OperaRunner

Did Opera crash? This is reset on next call, so if you don't check you won't know.

Specified by:

hasOperaCrashed in interface OperaRunner

Returns:

true if opera has crashed

getOperaCrashlog

public String getOperaCrashlog()

Description copied from interface: OperaRunner

If Opera crashed there should be a crashlog.

Specified by:

getOperaCrashlog in interface OperaRunner

Returns:

the crashlog, or null if it does not exist

shutdown

public void shutdown()

Description copied from interface: OperaRunner

In case the com.opera.core.systems.runner.runner has open sockets, they need to be closed.

Specified by:

shutdown in interface OperaRunner

captureScreen

public ScreenCaptureReply captureScreen()
                                 throws OperaRunnerException

Take screenshot using external program. Will not trigger a screen repaint.

Specified by:

captureScreen in interface OperaRunner

Returns:

a reply with various information on the captured area

Throws:

OperaRunnerException - if runner is shutdown or not running

captureScreen

public ScreenCaptureReply captureScreen(long timeout)
                                 throws OperaRunnerException

Take screenshot using external program. Will not trigger a screen repaint.

Specified by:

captureScreen in interface OperaRunner

Parameters:

timeout - attempt to take the screen capture until the timeout is reached

Returns:

a reply with various information on the captured area

Throws:

OperaRunnerException - if runner is shutdown or not running

captureScreen

public ScreenCaptureReply captureScreen(long timeout,
                               List<String> knownMD5s)
                                 throws OperaRunnerException

Take screenshot using external program. Will not trigger a screen repaint.

Specified by:

captureScreen in interface OperaRunner

Parameters:

timeout - attempt to take the screen capture until the timeout is reached

knownMD5s - a list of hashes of known MD5's, causing no image data to be stored

Returns:

a reply with various information on the captured area

Throws:

OperaRunnerException - if runner is shutdown or not running

assertLauncherGood

public static void assertLauncherGood(File launcher)
                               throws IOException

Asserts whether given launcher exists, is a file and that it's executable.

Parameters:

launcher - the launcher to assert

Throws:

IOException - if there is a problem with the provided launcher

toLauncherLoggingLevel

protected static Level toLauncherLoggingLevel(Level level)

The launcher allows for the following logging levels: "FINEST", "FINE", "INFO", "WARNING", "SEVERE". Since the launcher is unusually chatty, we don't want it to use the same logging level as OperaDriver. Besides, it doesn't have the same logging levels as Java. This method accepts a Java logging level and converts it to something sensible to pass on to the launcher.

Parameters:

level - the Java logging level

Returns:

a sensible, non-chatty logging level