com.devexperts.qd.qtp.socket

Class ServerSocketTestHelper

java.lang.Object

com.devexperts.qd.qtp.socket.ServerSocketTestHelper

Deprecated.

For tests only!

@Deprecated
public class ServerSocketTestHelper
extends Object

The class provides facility for automated port allocation by system for server connectors in tests.

Usage:

• create promise for a connector name with createPortPromise(String)
• in connector address specify zero port and the chosen name
• promise will be completed with an assigned local port value as soon as specified connector perform socket binding.
• use retrieved port to configure a client connection of the test

Example:

 Promise serverPort = ServerSocketTestHelper.createPortPromise("connector-name");
 ...
 String serverConnectorAddress = ":0[name=connector-name]"
 // configure server side using serverConnectorAddress
 ...
 String serverAddress = "localhost:" + serverPort.await(...);
 // configure client side using serverAddress
 

Method Summary

Modifier and Type	Method and Description
static void	completePortPromise(String connectorName, int port) Deprecated. Fill a port promise associated with provided connector name (if it exists).
static com.dxfeed.promise.Promise<Integer>	createPortPromise(String connectorName) Deprecated. Create a promise to retrieve a local port of specified server connector.
static void	failPortPromise(String connectorName, Throwable exception) Deprecated. Fail a port promise associated with provided connector name (if it exists).

Methods inherited from class java.lang.Object

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

Method Detail

createPortPromise

public static com.dxfeed.promise.Promise<Integer> createPortPromise(String connectorName)

Deprecated.

Create a promise to retrieve a local port of specified server connector. Connector will be identified by name. A name should be unique in the testing scope or wrong connector matching may happen.

Parameters:

connectorName - - a name of connector to be auto configured

Returns:

a promise object that will be filled with local port value by connector.

completePortPromise

public static void completePortPromise(String connectorName,
                                       int port)

Deprecated.

Fill a port promise associated with provided connector name (if it exists). The method is used by connectors supporting this testing facility.

Parameters:

connectorName - - a name of promise to be completed

port - - a local port value of connector

failPortPromise

public static void failPortPromise(String connectorName,
                                   Throwable exception)

Deprecated.

Fail a port promise associated with provided connector name (if it exists). The method is used by connectors supporting this testing facility.

Parameters:

connectorName - - a name of promise to be completed

exception - - a cause of connection failure