org.openqa.grid.web.servlet.handler
Class RequestHandler

java.lang.Object
  org.openqa.grid.web.servlet.handler.RequestHandler

All Implemented Interfaces:

Comparable<RequestHandler>

Direct Known Subclasses:

Selenium1RequestHandler, WebDriverRequestHandler

public abstract class RequestHandler
extends Object
implements Comparable<RequestHandler>

Base stuff to handle the request coming from a remote. Ideally, there should be only 1 concrete class, but to support both legacy selenium1 and web driver, 2 classes are needed.

Selenium1RequestHandler for the part specific to selenium1 protocol WebDriverRequestHandler for the part specific to webdriver protocol

Constructor Summary

protected

RequestHandler(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, Registry registry)

Method Summary

void	bindSession(TestSession session)
int	compareTo(RequestHandler o)
static RequestHandler	createHandler(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, Registry registry) Detect what kind of protocol ( selenium1 vs webdriver ) is used by the request and create the associated handler.
String	debug()
boolean	equals(Object obj)
abstract Map<String,Object>	extractDesiredCapability() Parse the request to extract the desiredCapabilities.
abstract RequestType	extractRequestType()
abstract String	extractSession() Extract the session from the request.
abstract String	forwardNewSessionRequest(TestSession session) Forward the new session request to the TestSession that has been assigned, and parse the response to extract and return the external key assigned by the remote.
protected void	forwardRequest(TestSession session, RequestHandler handler)
long	getCreated()
Map<String,Object>	getDesiredCapabilities()
Registry	getRegistry()
javax.servlet.http.HttpServletRequest	getRequest() the HttpServletRequest this hanlder is processing.
protected String	getRequestBody() reads the input stream of the request and returns its content.
protected RequestType	getRequestType()
javax.servlet.http.HttpServletResponse	getResponse() the HttpServletResponse the handler is writing to.
String	getServerSession() return the session from the server ( = opaque handle used by the server to determine where to route session-specific commands fro mthe JSON wire protocol ). will be null until the request has been processed.
protected TestSession	getSession()
int	hashCode()
void	process() forwards the request to the remote, allocating / releasing the resources if necessary.
protected void	setDesiredCapabilities(Map<String,Object> desiredCapabilities)
protected void	setRequestType(RequestType requestType)
protected void	setSession(TestSession session)
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

RequestHandler

protected RequestHandler(javax.servlet.http.HttpServletRequest request,
                         javax.servlet.http.HttpServletResponse response,
                         Registry registry)

Method Detail

createHandler

public static RequestHandler createHandler(javax.servlet.http.HttpServletRequest request,
                                           javax.servlet.http.HttpServletResponse response,
                                           Registry registry)

Detect what kind of protocol ( selenium1 vs webdriver ) is used by the request and create the associated handler.

Parameters:

request -

response -

registry -

Returns:

extractRequestType

public abstract RequestType extractRequestType()

Returns:

the type of the request.

extractSession

public abstract String extractSession()

Extract the session from the request. This only works for a request that has a session already assigned. It shouldn't be called for a new session request.

Returns:

the external session id sent by the remote. Null is the session cannot be found.

extractDesiredCapability

public abstract Map<String,Object> extractDesiredCapability()

Parse the request to extract the desiredCapabilities. For non web driver protocol ( selenium1 ) some mapping will be necessary

Returns:

the desired capabilities requested by the client.

forwardNewSessionRequest

public abstract String forwardNewSessionRequest(TestSession session)

Forward the new session request to the TestSession that has been assigned, and parse the response to extract and return the external key assigned by the remote.

Parameters:

session -

Returns:

the external key sent by the remote, null is something went wrong.

Throws:

IOException

forwardRequest

protected void forwardRequest(TestSession session,
                              RequestHandler handler)
                       throws IOException

Throws:

IOException

process

public void process()

forwards the request to the remote, allocating / releasing the resources if necessary.

getRequestBody

protected String getRequestBody()

reads the input stream of the request and returns its content.

Returns:

getRequest

public javax.servlet.http.HttpServletRequest getRequest()

the HttpServletRequest this hanlder is processing.

Returns:

getResponse

public javax.servlet.http.HttpServletResponse getResponse()

the HttpServletResponse the handler is writing to.

Returns:

getDesiredCapabilities

public Map<String,Object> getDesiredCapabilities()

setDesiredCapabilities

protected void setDesiredCapabilities(Map<String,Object> desiredCapabilities)

compareTo

public int compareTo(RequestHandler o)

Specified by:

compareTo in interface Comparable<RequestHandler>

getRequestType

protected RequestType getRequestType()

setRequestType

protected void setRequestType(RequestType requestType)

setSession

protected void setSession(TestSession session)

bindSession

public void bindSession(TestSession session)

getSession

protected TestSession getSession()

getServerSession

public String getServerSession()

return the session from the server ( = opaque handle used by the server to determine where to route session-specific commands fro mthe JSON wire protocol ). will be null until the request has been processed.

Returns:

toString

public String toString()

Overrides:

toString in class Object

debug

public String debug()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

getCreated

public long getCreated()

getRegistry

public Registry getRegistry()