com.opera.core.systems.runner

Interface OperaRunner

All Known Implementing Classes:

AbstractOperaRunner, OperaInProcessRunner, OperaLauncherRunner

public interface OperaRunner

AbstractOperaRunner is an interface for controlling the Opera browser binary. It allows you to start, stop, take screenshots of, and catch crash logs from Opera. AbstractOperaRunner implements a pure-Java process manager, OperaLauncherRunner implements one in C++ with a Java API.

Method Summary

Methods

Modifier and Type	Method and Description
ScreenCaptureReply	captureScreen() Take a screenshot of the full screen.
ScreenCaptureReply	captureScreen(long timeout) Take a screenshot of the full screen with a timeout.
ScreenCaptureReply	captureScreen(long timeout, List<String> knownMD5s) Take a screenshot of the full screen with a timeout and a list of previously known MD5 hash sum results.
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?
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.

Method Detail

startOpera

void startOpera()
                throws OperaRunnerException

Start Opera, does nothing if Opera is already started.

Throws:

OperaRunnerException - if runner has been shut down

stopOpera

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.

Throws:

OperaRunnerException - if runner has been shut down

isOperaRunning

boolean isOperaRunning()

Is Opera running?

Returns:

true if running, false if not running or crashed

hasOperaCrashed

boolean hasOperaCrashed()

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

Returns:

true if opera has crashed

getOperaCrashlog

String getOperaCrashlog()

If Opera crashed there should be a crashlog.

Returns:

the crashlog, or null if it does not exist

shutdown

void shutdown()

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

captureScreen

ScreenCaptureReply captureScreen()
                                 throws OperaRunnerException

Take a screenshot of the full screen.

Returns:

a reply with various information on the captured area

Throws:

OperaRunnerException - if a communication error occurs

captureScreen

ScreenCaptureReply captureScreen(long timeout)
                                 throws OperaRunnerException

Take a screenshot of the full screen with a timeout.

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 a communication error occurs

captureScreen

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

Take a screenshot of the full screen with a timeout and a list of previously known MD5 hash sum results. If the screen capture matches one of the MD5 hash sums, the capture's image data will not be stored.

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 a communication error occurs