org.openqa.selenium.server

Class SeleniumDriverResourceHandler

java.lang.Object

org.openqa.jetty.http.handler.AbstractHttpHandler

org.openqa.jetty.http.handler.ResourceHandler

org.openqa.selenium.server.SeleniumDriverResourceHandler

All Implemented Interfaces:

Serializable, HttpHandler, LifeCycle

public class SeleniumDriverResourceHandler
extends ResourceHandler

A Jetty handler that takes care of remote Selenium requests.

Remote Selenium requests are described in detail in the class description for SeleniumServer

Version:

$Revision: 674 $

Author:

Paul Hammant

See Also:

SeleniumServer, Serialized Form

Constructor Summary

Constructors

Constructor and Description
SeleniumDriverResourceHandler(SeleniumServer remoteControl, DriverSessions webdriverSessions)

Method Summary

Methods

Modifier and Type	Method and Description
protected String	commandResultsLogMessage(String cmd, String sessionId, String results)
protected File	createTempFile(String name)
void	deregisterBrowserSession(BrowserSessionFactory.BrowserSessionInfo sessionInfo) De-registers the given browser session from among the active sessions.
String	doCommand(String cmd, Vector<String> values, String sessionId, HttpResponse res)
protected void	download(URL url, File outputFile)
BrowserLauncherFactory	getBrowserLauncherFactory()
protected String	getNewBrowserSession(String browserString, String startURL, String extensionJs, Capabilities browserConfigurations)
protected FrameGroupCommandQueueSet	getQueueSet(String sessionId)
protected static String	getSpeedForSession(String sessionId)
void	handle(String pathInContext, String pathParams, HttpRequest req, HttpResponse res) Handle a request.
void	registerBrowserSession(BrowserSessionFactory.BrowserSessionInfo sessionInfo) Registers the given browser session among the active sessions to handle.
void	setBrowserLauncherFactory(BrowserLauncherFactory browserLauncherFactory) Deprecated.
protected static void	setSpeedForSession(String sessionId, int speed)
void	stopAllBrowsers() Kills all running browsers

Methods inherited from class org.openqa.jetty.http.handler.ResourceHandler

getAllowedMethods, getAllowedString, getMinGzipLength, getRedirectWelcome, getResource, handleGet, isAcceptRanges, isDirAllowed, isMethodAllowed, sendData, setAcceptRanges, setAllowedMethods, setDirAllowed, setMinGzipLength, setRedirectWelcome, start, stop, writeHeaders

Methods inherited from class org.openqa.jetty.http.handler.AbstractHttpHandler

getHttpContext, getName, handleTrace, initialize, isStarted, setName, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

SeleniumDriverResourceHandler

public SeleniumDriverResourceHandler(SeleniumServer remoteControl,
                             DriverSessions webdriverSessions)

Method Detail

handle

public void handle(String pathInContext,
          String pathParams,
          HttpRequest req,
          HttpResponse res)
            throws HttpException,
                   IOException

Description copied from interface: HttpHandler

Handle a request. Note that Handlers are tried in order until one has handled the request. i.e. until request.isHandled() returns true. In broad terms this means, either a response has been commited or request.setHandled(true) has been called.

Specified by:

handle in interface HttpHandler

Overrides:

handle in class ResourceHandler

Parameters:

pathInContext - The context path

pathParams - Path parameters such as encoded Session ID

req - The HttpRequest request

res - The HttpResponse response

Throws:

HttpException

IOException

getQueueSet

protected FrameGroupCommandQueueSet getQueueSet(String sessionId)

doCommand

public String doCommand(String cmd,
               Vector<String> values,
               String sessionId,
               HttpResponse res)

commandResultsLogMessage

protected String commandResultsLogMessage(String cmd,
                              String sessionId,
                              String results)

download

protected void download(URL url,
            File outputFile)

createTempFile

protected File createTempFile(String name)

getSpeedForSession

protected static String getSpeedForSession(String sessionId)

setSpeedForSession

protected static void setSpeedForSession(String sessionId,
                      int speed)

getNewBrowserSession

protected String getNewBrowserSession(String browserString,
                          String startURL,
                          String extensionJs,
                          Capabilities browserConfigurations)
                               throws RemoteCommandException

Throws:

RemoteCommandException

registerBrowserSession

public void registerBrowserSession(BrowserSessionFactory.BrowserSessionInfo sessionInfo)

Registers the given browser session among the active sessions to handle.

Usually externally created browser sessions are managed themselves, but registering them allows the shutdown procedures to be simpler.

Parameters:

sessionInfo - the externally created browser session to register.

deregisterBrowserSession

public void deregisterBrowserSession(BrowserSessionFactory.BrowserSessionInfo sessionInfo)

De-registers the given browser session from among the active sessions.

When an externally managed but registered session is closed, this method should be called to keep the set of active sessions up to date.

Parameters:

sessionInfo - the session to deregister.

stopAllBrowsers

public void stopAllBrowsers()

Kills all running browsers

getBrowserLauncherFactory

public BrowserLauncherFactory getBrowserLauncherFactory()

setBrowserLauncherFactory

@Deprecated
public void setBrowserLauncherFactory(BrowserLauncherFactory browserLauncherFactory)

Deprecated.

This method will soon be removed.

Parameters:

browserLauncherFactory - To use when creating new browser sessions.