Package org.openqa.selenium.grid.sessionmap

Class SessionMap

java.lang.Object

org.openqa.selenium.grid.sessionmap.SessionMap

All Implemented Interfaces:

HttpHandler, Routable, HasReadyState

Direct Known Subclasses:

LocalSessionMap, NullSessionMap, RemoteSessionMap

public abstract class SessionMap
extends Object
implements HasReadyState, Routable

Provides a stable API for looking up where on the Grid a particular webdriver instance is running.

This class responds to the following URLs:

Verb	URL Template	Meaning
DELETE	/se/grid/session/{sessionId}	Removes a URI from the session map. Calling this method more than once for the same SessionId will not throw an error.
GET	/se/grid/session/{sessionId}	Retrieves the URI associated the SessionId, or throws a NoSuchSessionException should the session not be present.
POST	/se/grid/session/{sessionId}	Registers the session with session map. In theory, the session map never expires a session from its mappings, but realistically, sessions may end up being removed for many reasons.

Field Summary

Fields

Modifier and Type	Field	Description
protected final Tracer	tracer

Constructor Summary

Constructors

Constructor	Description
SessionMap(Tracer tracer)

Method Summary

Modifier and Type	Method	Description
abstract boolean	add(Session session)
HttpResponse	execute(HttpRequest req)
abstract Session	get(SessionId id)
URI	getUri(SessionId id)
boolean	matches(HttpRequest req)
abstract void	remove(SessionId id)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.openqa.selenium.status.HasReadyState

isReady

Methods inherited from interface org.openqa.selenium.remote.http.Routable

with

Field Details

tracer

protected final Tracer tracer

Constructor Details

SessionMap

public SessionMap(Tracer tracer)

Method Details

add

public abstract boolean add(Session session)

get

public abstract Session get(SessionId id)
                     throws NoSuchSessionException

Throws:

NoSuchSessionException

remove

public abstract void remove(SessionId id)

getUri

public URI getUri(SessionId id)
           throws NoSuchSessionException

Throws:

NoSuchSessionException

matches

public boolean matches(HttpRequest req)

Specified by:

matches in interface Routable

execute

public HttpResponse execute(HttpRequest req)

Specified by:

execute in interface HttpHandler