org.openqa.grid.internal

Class TestSlot

java.lang.Object

org.openqa.grid.internal.TestSlot

public class TestSlot
extends Object

The entity on a proxy that can host a test session. A test slot has only 1 desired capabilities ( firefox or chrome for instance, but if a remoteproxy needs to support both, the remoteproxy will need 2 TestSlots ) A TestSlot can host 1 TestSession max at a time.

The listener (TestSessionListener attached to the test session of this test slot is thread safe. If 2 threads are trying to execute the before / after session, only 1 will be executed.The other one will be discarded. This class sees multiple threads but is currently sort-of protected by the lock in Registry. Unfortunately the CleanUpThread also messes around in here, so it should be thread safe on its own.

Constructor Summary

Constructors

Constructor and Description
TestSlot(RemoteProxy proxy, SeleniumProtocol protocol, String path, Map<String,Object> capabilities)

Method Summary

Methods

Modifier and Type	Method and Description
void	doFinishRelease()
Map<String,Object>	getCapabilities()
TestSession	getNewSession(Map<String,Object> desiredCapabilities) Try to get a new session for the test slot for the desired capability.
String	getPath() the path the server is using to handle the request.
SeleniumProtocol	getProtocol() the type of protocol for the TestSlot.Ideally should always be webdriver, but can also be selenium1 protocol for backward compatibility purposes.
RemoteProxy	getProxy()
URL	getRemoteURL() get the full URL the underlying server is listening on for selenium / webdriver commands.
TestSession	getSession() get the test session currently executed on this test slot.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

TestSlot

public TestSlot(RemoteProxy proxy,
        SeleniumProtocol protocol,
        String path,
        Map<String,Object> capabilities)

Method Detail

getCapabilities

public Map<String,Object> getCapabilities()

getProxy

public RemoteProxy getProxy()

Returns:

the RemoteProxy that hosts this slot.

getNewSession

public TestSession getNewSession(Map<String,Object> desiredCapabilities)

Try to get a new session for the test slot for the desired capability. To define if the test slot can host the desired capabilities, CapabilityMatcher.matches(Map, Map) is invoked.

Use GridHubConfiguration.setCapabilityMatcher(CapabilityMatcher) on the proxy hosting the test slot to modify the definition of match

Parameters:

desiredCapabilities - capabilities for the new session

Returns:

a new session linked to that testSlot if possible, null otherwise.

getProtocol

public SeleniumProtocol getProtocol()

the type of protocol for the TestSlot.Ideally should always be webdriver, but can also be selenium1 protocol for backward compatibility purposes.

Returns:

the protocol for this TestSlot

getPath

public String getPath()

the path the server is using to handle the request. Typically /wd/hub for a webdriver based protocol and /selenium-server/driver/ for a selenium1 based protocol

Returns:

the path the server is using for the requests of this slot.

getSession

public TestSession getSession()

get the test session currently executed on this test slot.

Returns:

the session. Null if the slot is not used at the moment.

doFinishRelease

public void doFinishRelease()

toString

public String toString()

Overrides:

toString in class Object

getRemoteURL

public URL getRemoteURL()

get the full URL the underlying server is listening on for selenium / webdriver commands.

Returns:

the url