hydra

Class PortHelper

java.lang.Object

hydra.PortHelper

public class PortHelper
extends Object

This class provides support to hydra client for selecting ports.

Field Summary

Fields

Modifier and Type	Field and Description
static String	ADDRESS_ALREADY_IN_USE
static long	MAX_RETRY_MS
static long	THROTTLE_MS
static String	UNRECOGNIZED_SOCKET

Constructor Summary

Constructors

Constructor and Description
PortHelper()

Method Summary

Modifier and Type	Method and Description
static boolean	addressAlreadyInUse(Throwable t) Returns true if a cause of the given (non-null) exception is a BindException with message containing ADDRESS_ALREADY_IN_USE.
static int	getRandomPort() Selects a random port not already in use on the local host.
static boolean	reservePort(String host, int port)
static boolean	retrySocketBind(IOException e, long startTimeMs) Answers whether the caller should retry the operation that threw the given IOException.

Methods inherited from class java.lang.Object

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

Field Detail

ADDRESS_ALREADY_IN_USE

public static final String ADDRESS_ALREADY_IN_USE

See Also:

Constant Field Values

UNRECOGNIZED_SOCKET

public static final String UNRECOGNIZED_SOCKET

See Also:

Constant Field Values

MAX_RETRY_MS

public static final long MAX_RETRY_MS

See Also:

Constant Field Values

THROTTLE_MS

public static final long THROTTLE_MS

See Also:

Constant Field Values

Constructor Detail

PortHelper

public PortHelper()

Method Detail

getRandomPort

public static int getRandomPort()

Selects a random port not already in use on the local host.

reservePort

public static boolean reservePort(String host,
                                  int port)

retrySocketBind

public static boolean retrySocketBind(IOException e,
                                      long startTimeMs)

Answers whether the caller should retry the operation that threw the given IOException. This is true if the exception satisfies addressAlreadyInUse(Throwable) and the retry limit of MAX_RETRY_MS ms has not been exceeded.

The method first logs network statistics to help diagnose the exception, regardless of its cause. It also throttles for THROTTLE_MS ms before returning true.

addressAlreadyInUse

public static boolean addressAlreadyInUse(Throwable t)

Returns true if a cause of the given (non-null) exception is a BindException with message containing ADDRESS_ALREADY_IN_USE. or a SocketException with message containing UNRECOGNIZED_SOCKET.