org.openqa.selenium.remote.server

Class DefaultSession

java.lang.Object

org.openqa.selenium.remote.server.DefaultSession

All Implemented Interfaces:

Session

public class DefaultSession
extends java.lang.Object
implements Session

The default session implementation. Thread safety notes: There are basically two different thread types rummaging around in this class: Container listener threads which deliver requests, and the "executor" thread that processes each request. This means there is a minefield of thread constraints/guards, some of which are described in docs for each field.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private class	DefaultSession.BrowserCreator

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.String	base64EncodedImage
private org.openqa.selenium.Capabilities	capabilities
private Clock	clock
private org.openqa.selenium.WebDriver	driver
private java.util.concurrent.ThreadPoolExecutor	executor
private java.lang.Thread	inUseWithThread
private KnownElements	knownElements The cache of known elements.
private long	lastAccess
private static java.lang.String	QUIET_EXCEPTIONS_KEY
private org.openqa.selenium.remote.SessionId	sessionId
private org.openqa.selenium.io.TemporaryFilesystem	tempFs

Constructor Summary

Constructors

Modifier	Constructor and Description
private	DefaultSession(DriverFactory factory, org.openqa.selenium.io.TemporaryFilesystem tempFs, Clock clock, org.openqa.selenium.remote.SessionId sessionId, org.openqa.selenium.Capabilities capabilities)

Method Summary

Modifier and Type	Method and Description
void	attachScreenshot(java.lang.String base64EncodedImage)
void	close()
static Session	createSession(DriverFactory factory, Clock clock, org.openqa.selenium.remote.SessionId sessionId, org.openqa.selenium.Capabilities capabilities)
static Session	createSession(DriverFactory factory, org.openqa.selenium.remote.SessionId sessionId, org.openqa.selenium.Capabilities capabilities)
static Session	createSession(DriverFactory factory, org.openqa.selenium.io.TemporaryFilesystem tempFs, Clock clock, org.openqa.selenium.remote.SessionId sessionId, org.openqa.selenium.Capabilities capabilities)
<X> X	execute(java.util.concurrent.FutureTask<X> future)
java.lang.String	getAndClearScreenshot()
org.openqa.selenium.Capabilities	getCapabilities()
org.openqa.selenium.WebDriver	getDriver()
KnownElements	getKnownElements()
org.openqa.selenium.remote.SessionId	getSessionId()
org.openqa.selenium.io.TemporaryFilesystem	getTemporaryFileSystem()
void	interrupt()
boolean	isInUse() Indicates that the session is in use at this moment (being forwarded to browser)
private static boolean	isQuietModeEnabled(DefaultSession.BrowserCreator browserCreator, org.openqa.selenium.Capabilities capabilities)
boolean	isTimedOut(long timeout)
void	updateLastAccessTime() Touches the session.

Methods inherited from class java.lang.Object

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

Field Detail

QUIET_EXCEPTIONS_KEY

private static final java.lang.String QUIET_EXCEPTIONS_KEY

See Also:

Constant Field Values

sessionId

private final org.openqa.selenium.remote.SessionId sessionId

driver

private final org.openqa.selenium.WebDriver driver

knownElements

private final KnownElements knownElements

The cache of known elements. Happens-before the exexutor and is thereafter thread-confined to the executor thread.

executor

private final java.util.concurrent.ThreadPoolExecutor executor

capabilities

private final org.openqa.selenium.Capabilities capabilities

clock

private final Clock clock

base64EncodedImage

private volatile java.lang.String base64EncodedImage

lastAccess

private volatile long lastAccess

inUseWithThread

private volatile java.lang.Thread inUseWithThread

tempFs

private org.openqa.selenium.io.TemporaryFilesystem tempFs

Constructor Detail

DefaultSession

private DefaultSession(DriverFactory factory,
                       org.openqa.selenium.io.TemporaryFilesystem tempFs,
                       Clock clock,
                       org.openqa.selenium.remote.SessionId sessionId,
                       org.openqa.selenium.Capabilities capabilities)
                throws java.lang.Exception

Throws:

java.lang.Exception

Method Detail

createSession

public static Session createSession(DriverFactory factory,
                                    org.openqa.selenium.remote.SessionId sessionId,
                                    org.openqa.selenium.Capabilities capabilities)
                             throws java.lang.Exception

Throws:

java.lang.Exception

createSession

public static Session createSession(DriverFactory factory,
                                    Clock clock,
                                    org.openqa.selenium.remote.SessionId sessionId,
                                    org.openqa.selenium.Capabilities capabilities)
                             throws java.lang.Exception

Throws:

java.lang.Exception

createSession

public static Session createSession(DriverFactory factory,
                                    org.openqa.selenium.io.TemporaryFilesystem tempFs,
                                    Clock clock,
                                    org.openqa.selenium.remote.SessionId sessionId,
                                    org.openqa.selenium.Capabilities capabilities)
                             throws java.lang.Exception

Throws:

java.lang.Exception

isQuietModeEnabled

private static boolean isQuietModeEnabled(DefaultSession.BrowserCreator browserCreator,
                                          org.openqa.selenium.Capabilities capabilities)

updateLastAccessTime

public void updateLastAccessTime()

Touches the session.

Specified by:

updateLastAccessTime in interface Session

isTimedOut

public boolean isTimedOut(long timeout)

Specified by:

isTimedOut in interface Session

close

public void close()

Specified by:

close in interface Session

execute

public <X> X execute(java.util.concurrent.FutureTask<X> future)
              throws java.lang.Exception

Specified by:

execute in interface Session

Throws:

java.lang.Exception

getDriver

public org.openqa.selenium.WebDriver getDriver()

Specified by:

getDriver in interface Session

getKnownElements

public KnownElements getKnownElements()

Specified by:

getKnownElements in interface Session

getCapabilities

public org.openqa.selenium.Capabilities getCapabilities()

Specified by:

getCapabilities in interface Session

attachScreenshot

public void attachScreenshot(java.lang.String base64EncodedImage)

Specified by:

attachScreenshot in interface Session

getAndClearScreenshot

public java.lang.String getAndClearScreenshot()

Specified by:

getAndClearScreenshot in interface Session

getSessionId

public org.openqa.selenium.remote.SessionId getSessionId()

Specified by:

getSessionId in interface Session

getTemporaryFileSystem

public org.openqa.selenium.io.TemporaryFilesystem getTemporaryFileSystem()

Specified by:

getTemporaryFileSystem in interface Session

isInUse

public boolean isInUse()

Description copied from interface: Session

Indicates that the session is in use at this moment (being forwarded to browser)

Specified by:

isInUse in interface Session

Returns:

true if the session is active inside the browser

interrupt

public void interrupt()

Specified by:

interrupt in interface Session