org.openqa.grid.web.servlet.handler

Class RequestHandler

java.lang.Object

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

All Implemented Interfaces:

java.lang.Comparable<RequestHandler>

public class RequestHandler
extends java.lang.Object
implements java.lang.Comparable<RequestHandler>

Base stuff to handle the request coming from a remote. Threading notes; RequestHandlers are instantiated per-request, run on the servlet container thread. The instance is also accessed by the matcher thread.

Constructor Summary

Constructors

Constructor and Description
RequestHandler(SeleniumBasedRequest request, javax.servlet.http.HttpServletResponse response, GridRegistry registry)

Method Summary

Modifier and Type	Method and Description
void	bindSession(TestSession session)
int	compareTo(RequestHandler o)
java.lang.String	debug()
boolean	equals(java.lang.Object obj)
void	forwardNewSessionRequestAndUpdateRegistry(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)
GridRegistry	getRegistry()
SeleniumBasedRequest	getRequest()
javax.servlet.http.HttpServletResponse	getResponse()
ExternalSessionKey	getServerSession()
TestSession	getSession()
int	hashCode()
void	process() forwards the request to the remote, allocating / releasing the resources if necessary.
protected void	setSession(TestSession session)
void	stop()
java.lang.String	toString()
void	waitForSessionBound() wait for the registry to match the request with a TestSlot.

Methods inherited from class java.lang.Object

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

Constructor Detail

RequestHandler

public RequestHandler(SeleniumBasedRequest request,
                      javax.servlet.http.HttpServletResponse response,
                      GridRegistry registry)

Method Detail

forwardNewSessionRequestAndUpdateRegistry

public void forwardNewSessionRequestAndUpdateRegistry(TestSession session)
                                               throws NewSessionException

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 - session

Throws:

NewSessionException - in case anything wrong happens during the new session process.

forwardRequest

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

Throws:

java.io.IOException

process

public void process()

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

waitForSessionBound

public void waitForSessionBound()
                         throws java.lang.InterruptedException,
                                java.util.concurrent.TimeoutException

wait for the registry to match the request with a TestSlot.

Throws:

java.lang.InterruptedException - Interrupted exception

java.util.concurrent.TimeoutException - if the request reaches the new session wait timeout before being assigned.

getRequest

public SeleniumBasedRequest getRequest()

Returns:

the SeleniumBasedRequest this handler is processing.

getResponse

public javax.servlet.http.HttpServletResponse getResponse()

Returns:

the HttpServletResponse the handler is writing to.

compareTo

public int compareTo(RequestHandler o)

Specified by:

compareTo in interface java.lang.Comparable<RequestHandler>

setSession

protected void setSession(TestSession session)

bindSession

public void bindSession(TestSession session)

getSession

public TestSession getSession()

getServerSession

public ExternalSessionKey getServerSession()

Returns:

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

stop

public void stop()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

debug

public java.lang.String debug()

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

getRegistry

public GridRegistry getRegistry()