Method Detail

• obtainSpecificPort

  boolean obtainSpecificPort(int portNumber)

  Reserve a specific port for an application. If your application requires a specific port - for example, port 80 for a web server - you should reserve this port before starting your application. Using this method, you will be able to detect if another application has already claimed this port number.

  Parameters:

  portNumber - the required port number.

  Returns:

  true if the port was successfully reserved; false if it has been previously reserved.

• obtainPort

  int obtainPort(PortRange range)

  Reserve a port for your application, with a port number in a specific range. If your application requires a port, but it does not mind exactly which port number - for example, a port for internal JMX monitoring - call this method.

  Parameters:

  range - the range of acceptable port numbers.

  Returns:

  the port number that has been reserved, or -1 if there was no available port in the acceptable range.

• releasePort

  void releasePort(int portNumber)

  Release a previously reserved port.

  Parameters:

  portNumber - the port number from a call to obtainPort(PortRange) or obtainSpecificPort(int)