Package org.openqa.selenium.grid.sessionqueue.local

Class LocalNewSessionQueue

java.lang.Object

org.openqa.selenium.grid.sessionqueue.NewSessionQueue

org.openqa.selenium.grid.sessionqueue.local.LocalNewSessionQueue

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, org.openqa.selenium.remote.http.HttpHandler, org.openqa.selenium.remote.http.Routable, HasReadyState

public class LocalNewSessionQueue
extends NewSessionQueue
implements java.io.Closeable

An in-memory implementation of the list of new session requests.

The lifecycle of a request can be described as:

1. User adds an item on to the queue using addToQueue(SessionRequest). This will block until the request completes in some way.
2. If the session request is completed, then complete(RequestId, Either) must be called. This will ensure that addToQueue(SessionRequest) returns.
3. If the request cannot be handled right now, call retryAddToQueue(SessionRequest) to return the session request to the front of the queue.

There is a background thread that will reap SessionRequests that have timed out. This means that a request can either complete by a listener calling complete(RequestId, Either) directly, or by being reaped by the thread.

Field Summary

Fields inherited from class org.openqa.selenium.grid.sessionqueue.NewSessionQueue

tracer

Constructor Summary

Constructors

Constructor	Description
LocalNewSessionQueue(org.openqa.selenium.remote.tracing.Tracer tracer, SlotMatcher slotMatcher, java.time.Duration requestTimeoutCheck, java.time.Duration requestTimeout, Secret registrationSecret, int batchSize)

Method Summary

Modifier and Type	Method	Description
org.openqa.selenium.remote.http.HttpResponse	addToQueue(SessionRequest request)
int	clearQueue()
void	close()
void	complete(RequestId reqId, org.openqa.selenium.internal.Either<org.openqa.selenium.SessionNotCreatedException,CreateSessionResponse> result)
static NewSessionQueue	create(Config config)
java.util.List<SessionRequest>	getNextAvailable(java.util.Map<org.openqa.selenium.Capabilities,java.lang.Long> stereotypes)
java.util.List<SessionRequestCapability>	getQueueContents()
int	getQueueSize()
boolean	isReady()
boolean	peekEmpty()	A fast-path to detect if the queue is empty, returns false if there is no fast-path available.
java.util.Optional<SessionRequest>	remove(RequestId reqId)
boolean	retryAddToQueue(SessionRequest request)

Methods inherited from class org.openqa.selenium.grid.sessionqueue.NewSessionQueue

execute, matches

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.remote.http.Routable

with

Constructor Detail

LocalNewSessionQueue

public LocalNewSessionQueue(org.openqa.selenium.remote.tracing.Tracer tracer,
                            SlotMatcher slotMatcher,
                            java.time.Duration requestTimeoutCheck,
                            java.time.Duration requestTimeout,
                            Secret registrationSecret,
                            int batchSize)

Method Detail

create

public static NewSessionQueue create(Config config)

peekEmpty

public boolean peekEmpty()

Description copied from class: NewSessionQueue

A fast-path to detect if the queue is empty, returns false if there is no fast-path available.

Specified by:

peekEmpty in class NewSessionQueue

Returns:

true if the queue is empty, false if it is not empty or unknown

addToQueue

public org.openqa.selenium.remote.http.HttpResponse addToQueue(SessionRequest request)

Specified by:

addToQueue in class NewSessionQueue

retryAddToQueue

public boolean retryAddToQueue(SessionRequest request)

Specified by:

retryAddToQueue in class NewSessionQueue

remove

public java.util.Optional<SessionRequest> remove(RequestId reqId)

Specified by:

remove in class NewSessionQueue

getNextAvailable

public java.util.List<SessionRequest> getNextAvailable(java.util.Map<org.openqa.selenium.Capabilities,java.lang.Long> stereotypes)

Specified by:

getNextAvailable in class NewSessionQueue

complete

public void complete(RequestId reqId,
                     org.openqa.selenium.internal.Either<org.openqa.selenium.SessionNotCreatedException,CreateSessionResponse> result)

Specified by:

complete in class NewSessionQueue

clearQueue

public int clearQueue()

Specified by:

clearQueue in class NewSessionQueue

getQueueContents

public java.util.List<SessionRequestCapability> getQueueContents()

Specified by:

getQueueContents in class NewSessionQueue

getQueueSize

public int getQueueSize()

isReady

public boolean isReady()

Specified by:

isReady in interface HasReadyState

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Throws:

java.io.IOException