org.openqa.selenium.net

Class PortProber

java.lang.Object

org.openqa.selenium.net.PortProber

public class PortProber
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
private static EphemeralPortRangeDetector	ephemeralRangeDetector
static int	HIGHEST_PORT
private static java.util.Random	random
static int	START_OF_USER_PORTS

Constructor Summary

Constructors

Modifier	Constructor and Description
private	PortProber()

Method Summary

Modifier and Type	Method and Description
private static int	checkPortIsFree(int port)
private static int	createAcceptablePort() Returns a port that is within a probable free range.
static int	findFreePort()
static boolean	pollPort(int port)
static boolean	pollPort(int port, int timeout, java.util.concurrent.TimeUnit unit)
static void	waitForPortUp(int port, int timeout, java.util.concurrent.TimeUnit unit)

Methods inherited from class java.lang.Object

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

Field Detail

random

private static final java.util.Random random

ephemeralRangeDetector

private static final EphemeralPortRangeDetector ephemeralRangeDetector

HIGHEST_PORT

public static final int HIGHEST_PORT

See Also:

Constant Field Values

START_OF_USER_PORTS

public static final int START_OF_USER_PORTS

See Also:

Constant Field Values

Constructor Detail

PortProber

private PortProber()

Method Detail

findFreePort

public static int findFreePort()

createAcceptablePort

private static int createAcceptablePort()

Returns a port that is within a probable free range.

Based on the ports in http://en.wikipedia.org/wiki/Ephemeral_ports, this method stays away from all well-known ephemeral port ranges, since they can arbitrarily race with the operating system in allocations. Due to the port-greedy nature of selenium this happens fairly frequently. Staying within the known safe range increases the probability tests will run green quite significantly.

Returns:

a random port number

checkPortIsFree

private static int checkPortIsFree(int port)

pollPort

public static boolean pollPort(int port)

pollPort

public static boolean pollPort(int port,
                               int timeout,
                               java.util.concurrent.TimeUnit unit)

waitForPortUp

public static void waitForPortUp(int port,
                                 int timeout,
                                 java.util.concurrent.TimeUnit unit)