org.springframework.cloud.deployer.spi.local

Class DeployerSocketUtils

java.lang.Object

org.springframework.cloud.deployer.spi.local.DeployerSocketUtils

Deprecated.

to be replaced with a more robust mechanism in https://github.com/spring-cloud/spring-cloud-deployer-local/issues/215

@Deprecated
public class DeployerSocketUtils
extends Object

Simple utility methods for working with network sockets — for example, for finding available ports on localhost. This is a replacement for SocketUtils. SocketUtils was introduced in Spring Framework 4.0, primarily to assist in writing integration tests which start an external server on an available random port. However, these utilities make no guarantee about the subsequent availability of a given port and are therefore unreliable. Instead of using SocketUtils to find an available local port for a server, it is recommended that you rely on a server's ability to start on a random port that it selects or is assigned by the operating system. To interact with that server, you should query the server for the port it is currently using.

Author:

Sam Brannen, Ben Hale, Arjen Poutsma, Gunnar Hillert, Gary Russell, Glenn Renfro

Constructor Summary

Constructors

Constructor and Description
DeployerSocketUtils() Deprecated.

Method Summary

Modifier and Type	Method and Description
static int	findAvailableTcpPort(int minPort) Deprecated. Find an available TCP port randomly selected from the range [minPort, ].
static int	findAvailableTcpPort(int minPort, int maxPort) Deprecated. Find an available TCP port randomly selected from the range [minPort, maxPort].
static SortedSet<Integer>	findAvailableTcpPorts(int numRequested, int minPort, int maxPort) Deprecated. Find the requested number of available TCP ports, each randomly selected from the range [minPort, maxPort].

Methods inherited from class java.lang.Object

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

Constructor Detail

DeployerSocketUtils

public DeployerSocketUtils()

Deprecated.

Method Detail

findAvailableTcpPort

public static int findAvailableTcpPort(int minPort)

Deprecated.

Find an available TCP port randomly selected from the range [minPort, ].

Parameters:

minPort - the minimum port number

Returns:

an available TCP port number

Throws:

IllegalStateException - if no available port could be found

findAvailableTcpPort

public static int findAvailableTcpPort(int minPort,
                                       int maxPort)

Deprecated.

Find an available TCP port randomly selected from the range [minPort, maxPort].

Parameters:

minPort - the minimum port number

maxPort - the maximum port number

Returns:

an available TCP port number

Throws:

IllegalStateException - if no available port could be found

findAvailableTcpPorts

public static SortedSet<Integer> findAvailableTcpPorts(int numRequested,
                                                       int minPort,
                                                       int maxPort)

Deprecated.

Find the requested number of available TCP ports, each randomly selected from the range [minPort, maxPort].

Parameters:

numRequested - the number of available ports to find

minPort - the minimum port number

maxPort - the maximum port number

Returns:

a sorted set of available TCP port numbers

Throws:

IllegalStateException - if the requested number of available ports could not be found